Using Proxies with Enterprise PKS on NSX-T
Page last updated:
Warning: Pivotal Container Service (PKS)
v1.4 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 use proxies with Enterprise Pivotal Container Service (Enterprise PKS) with NSX-T.
If your environment includes HTTP proxies, you can configure Enterprise PKS with NSX-T to use these proxies so that Enterprise PKS-deployed Kubernetes master and worker nodes access public Internet services and other internal services through a proxy.
In addition, Enterprise PKS proxy settings apply to the PKS API instance. When an Enterprise PKS operator creates a Kubernetes cluster, the PKS API instance VM behind a proxy is able to manage NSX-T objects on the standard network.
You can also proxy outgoing HTTP/HTTPS traffic from Ops Manager and the BOSH Director so that all Enterprise PKS components use the same proxy service.
The following diagram illustrates the network architecture:
To configure a global HTTP proxy for all outgoing HTTP/HTTPS traffic from the Kubernetes cluster nodes and the PKS API server, perform the following steps:
Navigate to Ops Manager and log in.
Click the Enterprise PKS tile.
Under HTTP/HTTPS proxy, select Enabled. When this option is enabled, you can proxy HTTP traffic, HTTPS traffic, or both.
To proxy outgoing HTTP traffic, under HTTP Proxy URL, enter the HTTP URL of your proxy endpoint. For example,
If the proxy for outgoing HTTP traffic uses basic authentication, enter the user name and password in the HTTP Proxy Credentials fields.
To proxy outgoing HTTPS traffic, under HTTPS Proxy URL, enter the HTTP URL of your proxy endpoint. For example,
Note: Using an HTTPS connection to the proxy server is not supported. HTTP and HTTPS proxy options can only be configured with an HTTP connection to the proxy server. You cannot populate either of the proxy URL fields with an HTTPS URL. The proxy host and port can be different for HTTP and HTTPS traffic, but the proxy protocol must be HTTP.
If the proxy for outgoing HTTPS traffic uses basic authentication, enter the user name and password in the HTTPS Proxy Credentials fields.
Under No Proxy, enter the comma-separated list of IP addresses that must bypass the proxy to allow for internal Enterprise PKS communication.
In addition to
localhost, you must include your deployment network CIDR, your node network IP block, and your pod network IP block CIDR:
127.0.0.1,localhost, DEPLOYMENT-NETWORK-CIDR, NODE-NETWORK-IP-BLOCK-CIDR, POD-NETWORK-IP-BLOCK-CIDR
You can enter FQDNs in the No Proxy field. For example:
If you are upgrading and have an existing proxy configuration for reaching a Docker registry or other external services, add the following IP addresses to the No Proxy field to prevent the Enterprise PKS to IaaS traffic from going through the proxy: NSX Manager, vCenter Server, and all ESXi hosts.
If a component is communicating with Enterprise PKS or Harbor using a hostname instead of an IP address, you will need to add the corresponding FQDN to the No Proxy list. For example:
127.0.0.1,localhost, DEPLOYMENT-NETWORK-CIDR, NODE-NETWORK-IP-BLOCK-CIDR, POD-NETWORK-IP-BLOCK-CIDR, PKS-API-FQDN,HARBOR-API-FQDN
Note: By default, the
10.200.0.0/8IP address ranges are not proxied. This allows internal Enterprise PKS communication.
Save the changes to the Enterprise PKS tile.
Proceed with any remaining Enterprise PKS tile configurations and deploy Enterprise PKS. See Installing Enterprise PKS on vSphere with NSX-T.
To enable an HTTP proxy for outgoing HTTP/HTTPS traffic from Ops Manager and the BOSH Director, perform the following steps:
Navigate to Ops Manager and log in.
Select User Name > Settings in the upper right.
Click Proxy Settings.
Under HTTP Proxy, enter the FQDN or IP address of the HTTP proxy endpoint. For example,
Under HTTPS Proxy, enter the FQDN or IP address of the HTTPS proxy endpoint. For example,
Note: Using an HTTPS connection to the proxy server is not supported. Ops Manager and BOSH HTTP and HTTPS proxy options can be only configured with an HTTP connection to the proxy.
Under No Proxy, include the hosts that must bypass the proxy. This is required.
In addition to
localhost, include the BOSH Director IP and the PKS VM IP. The BOSH Director IP is typically the first IP address in the deployment network CIDR, and the PKS VM IP is the second IP address in the deployment network CIDR. In addition, be sure to include the Ops Manager IP address in the No Proxy field as well.
Note: Ops Manager does not allow the use of a CIDR range in the No Proxy field. You must specify each individual IP address to bypass the proxy.
The No Proxy field does not accept wildcard domain notation, such as
*.docker.com. You must specify the exact IP or FQDN to bypass the proxy, such as
Return to the Ops Manager Installation Dashboard and click Review Pending Changes.
Click Apply Changes to deploy Ops Manager and the BOSH Director with the updated proxy settings.
Please send any feedback you have to email@example.com.