Supervisor Cluster Stuck in Configuring State - GatewayConnectionNotSet

Products

• VMware vSphere Kubernetes Service

Issue/Introduction

• Supervisor Cluster creation is not completing and remains stuck in the "Configuring" or "Provisioning" state for an extended period.
• UI Shows the following error:
  
  Configuring Host Nodes: Kubernetes Worker Node is schedulable. A general system error occurred. Error message: timed out waiting for ReadyNodeStatus on node [hostname].
  
  
• Checking the Supervisor Control Plane via kubectl get vpcnetworkconfiguration -o yaml reveals the following status condition:
status: conditions: - lastTransitionTime: "yyyy-mm-ddThh:mm:ssZ" reason: GatewayConnectionNotSet status: "False" type: GatewayConnectionReady

Environment

• vSphere Kubernetes Service
• vCenter 9.x

Cause

The issue is caused by an NSX VPC Configuration error. The Supervisor service is unable to establish the necessary gateway connection required for the VPC network state to reach "Ready."

Resolution

To resolve this issue, ensure the Gateway Connection is correctly configured in the NSX VPC settings:

1. Log in to NSX Manager.
2. Navigate to the VPC Configuration associated with the Supervisor Cluster.
3. Verify the Gateway Connection settings and ensure they are correctly mapped to the appropriate Tier-0 or Tier-1 gateway.
4. Once the connection is set, the VPCNetworkConfiguration should transition to Ready, allowing the host nodes to report a healthy ReadyNodeStatus.

Additional Information

Deploying Supervisor with VCF Networking with VPC

Requirements for Supervisor Deployment with VPC Networking