This topic describes how to define network profiles for custom floating IP pools for VMware Tanzu Kubernetes Grid Integrated Edition (TKGI) provisioned Kubernetes clusters.

Create a Custom Floating IP Pool

To deploy Tanzu Kubernetes Grid Integrated Edition to vSphere with NSX, you must define a Floating IP Pool in NSX Manager. IP addresses from the Floating IP Pool are used for SNAT IP addresses whenever a Namespace is created (NAT mode). In addition, IP addresses from the Floating IP Pool are assigned to load balancers automatically provisioned by NSX, including the load balancer fronting the TKGI API server and load balancers for pod ingress. For more information, see the Plan Network CIDRs section of Planning, Preparing, and Configuring NSX for Tanzu Kubernetes Grid Integrated Edition.

You can define a network profile that specifies a custom floating IP pool to use instead of the default pool specified in the Tanzu Kubernetes Grid Integrated Edition tile.

Note: TKGI allocates IP Addresses from the start of the floating IP pool range. To avoid conflicts with internal TKGI functions, always use IP addresses from the end of the floating IP pool. For more information, see Failed to Allocate FIP from Pool in General Troubleshooting.

To define a custom floating IP pool, follow the steps below:

  1. Create a floating IP pool using NSX Manager prior to provisioning a Kubernetes cluster using Tanzu Kubernetes Grid Integrated Edition. For more information, see Create IP Pool in the NSX documentation.
  2. Ensure routing to your external Tier-0 Router allows traffic to the new custom Floating IP subnet.
  3. Define a network profile with a fip_pool_ids array containing the UUIDs for the floating IP pools that you defined. If you want to include the default floating IP pool, also add the UUID of the default floating IP pool to the fip_pool_ids array.

    The following example defines a custom floating IP pool:

        "name": "np-custom-fip",
        "description": "Network Profile for Custom Floating IP Pool",
        "parameters": {
            "fip_pool_ids": [

    The example above uses two floating IP pools. With this configuration, if the first pool of IP addresses, e50e8f6e-1a7a-45dc-ad49-3a607baa7fa0, is exhausted, the system will use the IP addresses in the next IP pool that is listed, ebe78a74-a5d5-4dde-ba76-9cf4067eee55.

Note: If you are using multiple Floating IP Pools within the same Tier-0 router, the Floating IP Pools cannot overlap. Overlapping Floating IP Pools are allowed across Tier-0 routers, but not within the same Tier-0 router.

Modify a Floating IP Pool

You can modify the floating IP pool of an existing cluster. For more information, see fip_pool_ids in Creating and Managing Network Profiles.

check-circle-line exclamation-circle-line close-line
Scroll to top icon