Creating NSX-T Objects for Enterprise PKS

Page last updated:

Warning: VMware Enterprise PKS v1.6 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.

Installing VMware Enterprise PKS on vSphere with NSX-T requires the creation of NSX IP blocks for Kubernetes node and pod networks, as well as a Floating IP Pool from which you can assign routable IP addresses to cluster resources.

Create separate NSX-T IP Blocks for the node networks and the pod networks. The subnets for both nodes and pods should have a size of 256 (/16). For more information, see Plan IP Blocks and Reserved IP Blocks. For more information about NSX-T IP Blocks, see Advanced IP Address Management in the VMware NSX-T Data Center documentation.

  • NODE-IP-BLOCK is used by Enterprise PKS to assign address space to Kubernetes master and worker nodes when new clusters are deployed or a cluster increases its scale.
  • POD-IP-BLOCK is used by the NSX-T Container Plug-in (NCP) to assign address space to Kubernetes pods through the Container Networking Interface (CNI).

In addition, create a Floating IP Pool from which to assign routable IP addresses to components. This network provides your load balancing address space for each Kubernetes cluster created by Enterprise PKS. The network also provides IP addresses for Kubernetes API access and Kubernetes exposed services. For example, 10.172.2.0/24 provides 256 usable IPs. This network is used when creating the virtual IP pools, or when the services are deployed. You enter this network in the Floating IP Pool ID field in the Networking pane of the Enterprise PKS tile.

Complete the following instructions to create the required NSX-T network objects.

Create the Nodes IP Block

  1. In NSX Manager, go to Advanced Networking & Security > Networking > IPAM.

  2. Add a new IP Block for Kubernetes Nodes. For example:

    • Name: NODES-IP-BLOCK
    • CIDR: 192.168.0.0/16
  3. Verify creation of the Nodes IP Block.

  4. Record the UUID of the Nodes IP Block object. You use this UUID when you install Enterprise PKS with NSX-T.

Create the Pods IP Block

  1. In NSX Manager, go to Advanced Networking & Security > Networking > IPAM.

  2. Add a new IP Block for Pods. For example:

    • Name: PKS-PODS-IP-BLOCK
    • CIDR: 172.16.0.0/16
  3. Verify creation of the Pods IP Block.

  4. Record the UUID of the Pods IP Block object. You use this UUID when you install Enterprise PKS with NSX-T.

Create Floating IP Pool

  1. In NSX Manager, go to Advanced Networking & Security > Inventory > Groups > IP Pool.

  2. Add a new Floating IP Pool. For example:

    • Name: PKS-FLOATING-IP-POOL
    • IP Ranges: 10.40.14.10 - 10.40.14.253
    • Gateway: 10.40.14.254
    • CIDR: 10.40.14.0/24
  3. Verify creation of the Nodes IP Block.

  4. Get the UUID of the Floating IP Pool object. You use this UUID when you install Enterprise PKS with NSX-T.

Next Step

After you complete this procedure, follow the instructions in Installing Enterprise PKS on vSphere with NSX-T.


Please send any feedback you have to pks-feedback@pivotal.io.