You can create a TanzuKubernetesCluster with routable pods networking by configuring a routable Namespace Network on Supervisor and by specifying antrea-nsx-routed as the CNI for the cluster.

About Routable Pods Networking

When you provision a Tanzu Kubernetes cluster using the antrea or calico CNI plugins, the system creates the default pods network This subnet is a private address space that is only unique within the cluster and not routable on the network.

The TKG v1alpha3 API supports routable pod networking using the antrea-nsx-routed CNI plugin. This network interface is a customized Antrea plugin configured to support routable pod networks for TKG clusters. In the cluster spec, the pods CIDR blocks field must be explicitly null so that IP address management (IPAM) is handled by the Supervisor. Refer to the example below.

Enabling routable pod networking lets pods be directly addressed from a client external to the cluster. In addition, pod IP addressees are preserved so external network services and servers can identify the source pods and apply policies based on IP addresses. Supported traffic patterns including the following:
  • Traffic is allowed between a TKG cluster pod and a vSphere Pod in the same vSphere Namespace.
  • Traffic is dropped between a TKG cluster pod and a vSphere Pod in different vSphere Namespaces.
  • Supervisor control plane nodes can reach TKG cluster pods.
  • TKG cluster pods can reach the external network.
  • External network cannot reach TKG cluster pods. Traffic is dropped by distributed firewall (DFW) isolation rules on the cluster nodes.

Creating a Routable Pods Network: Supervisor Configuration

Creating a routable pods network requires configuration on the Supervisor and on the TKG cluster.
Note: Supervisor must be configured with NSX to use routable pods networking. You cannot use routable pods with VDS networking.
To configure a routable pods network on Supervisor:
  1. Create a new vSphere Namespace.

    See Create a vSphere Namespace for Hosting TKG Clusters on Supervisor.

  2. Select the checkbox option to Override Supervisor network settings.

    See Override Supervisor Network Settings for guidance.

  3. Deselect NAT Mode.
  4. Populate the Namespace Network with a routable subnet. NCP will create one or more IP pools from the IP blocks specified for the network.
  5. Make sure that the routable Namespace Network that you added does not overlap with the Services CIDR which allocates the IP addresses for cluster nodes.

Creating a Routable Pods Network: TKG Cluster Configuration

The following example YAML shows how to configure a cluster with a routable pods network.

The cluster spec declares antrea-nsx-routed as the CNI to enable routable pods networking. If antrea-nsx-routed is specified, cluster provisioning will fail if NSX-T networking is not being used.

When the CNI is specified as antrea-nsx-routed, the pods.cidrBlock field must be empty.
kind: TanzuKubernetesCluster
  name: tkc-routable-pods
  namespace: tkg2-cluster-ns
      replicas: 3
      vmClass: guaranteed-medium
      storageClass: tkg2-storage-policy
          name: v1.23.8---vmware.2-tkg.2-zshippable
    - name: worker-nodepool-a1
      replicas: 3
      vmClass: guaranteed-large
      storageClass: tkg2-storage-policy
          name: v1.22.8---vmware.1-tkg.2-zshippable
      defaultClass: tkg2-storage-policy
      #antrea-nsx-routed is the required CNI
        name: antrea-nsx-routed
        cidrBlocks: [""]
      #pods.cidrBlocks must be null (empty)
      serviceDomain: cluster.local