Implementing a Multi-Foundation Enterprise PKS Deployment

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.

This topic describes how to deploy multiple instances of VMware Enterprise PKS on vSphere with NSX-T infrastructure.

About Multi-Foundation Enterprise PKS

A multi-foundation deployment of Enterprise PKS lets you install and run multiple instances of Enterprise PKS. The purpose of a multi-foundation deployment of Enterprise PKS is to share a common vSphere and NSX-T infrastructure across multiple foundations, while providing complete networking isolation across foundations.

As shown in the diagram, with a multi-foundation Enterprise PKS topology, each PKS instance is deployed to a dedicated NSX-T Tier-0 router. Foundation A T0 router with Management CIDR connects to the vSphere and NSX-T infrastructure. Similarly, Foundation B T0 router with Management CIDR connects to the same vSphere and NSX-T components.

As with a single instance deployment, PKS management components are deployed to a dedicated network, for example, for PKS Foundation A; for PKS Foundation B. When Enterprise PKS is deployed, networks are defined for nodes, pods, and load balancers. Because of the dedicated Tier-0 router, there is complete networking isolation between each Enterprise PKS instance.

Architecture for Multi-Foundational PKS Deployment


To implement a multi-foundation Enterprise PKS topology, adhere to the following requirements:

  • One Tier-0 router for each Enterprise PKS instance. For more information, see Configuring Multiple Tier-0 Routers for Tenant Isolation.
  • The Floating IP pool must not overlap. The CIDR range for each Floating IP Pool must be unique and not overlapping across foundations. For more information, see Create Floating IP Pool.
  • Enterprise PKS instances can be deployed in NAT and no-NAT mode. If more than one Enterprise PKS instance is deployed in no-NAT mode, the Nodes IP Block networks cannot overlap.
  • For any Pods IP Block used to deploy Kubernetes clusters in no-NAT (routable) mode, the Pods IP Block cannot overlap across foundations.
  • The NSX-T Super User Principal Identity Certificate should be unique per PKS instance.

The image below shows three Enterprise PKS installations across three Tier-0 foundations. Key considerations to keep in mind with a multi-foundation Enterprise PKS topology include the following:

  • Each foundation must rely on a dedicated Tier-0 router
  • You can mix-and-match NAT and no-NAT mode across foundations for Node and Pod networks
  • If you are using non-routable Pods IP Block networks, the Pods IP Block addresses can overlap across foundations
  • Because Kubernetes nodes are behind a dedicated Tier-0 router, if clusters are deployed in NAT mode the Nodes IP Block addresses can also overlap across foundations
  • For each foundation you must define a unique Floating ID Pool with non-overlapping IPs

Configuring Multi-Foundational PKS Deployment

Please send any feedback you have to