Anthos clusters on Azure is generally available as of December 2. See the Release notes for more information.

Use an HTTP proxy

This topic shows you how to route traffic from the Anthos clusters on Azure through an HTTP/HTTPS proxy. You specify proxy configuration when you create a cluster.


Anthos clusters on Azure requires internet access for the following reasons:

  • Anthos clusters on Azure registers clusters with Connect.
  • Clusters run the Connect Agent.
  • All nodes download images from Container Registry.


  • The httpProxy and httpsProxy fields do not support URLs beginning with https://. You must use http://. Requests to port 443 use HTTPS.
  • You must set values for httpProxy, httpsProxy, and noProxy.
  • A cluster's proxy configuration— the resource group ID and secret ID— is immutable. You must create a new cluster and node pool to update these values.
  • You might need to add additional domains, IPs, or CIDRs to the noProxy field. We recommend adding your cluster's control planes subnet CIDRs (Pod address CIDR and Service address CIDR are added by default).


This section describes the prerequisites you must apply before using a proxy.

Azure Key Vault configuration

Anthos clusters on Azure stores proxy configuration information in Azure Key Vault. To configure a proxy with Anthos clusters on Azure, you need to have permissions to create a secret in a Key Vault. The Key Vault must be accessible from your cluster's VNet.

Proxy Allowlist

For Anthos clusters on Azure to connect to Google Cloud services, the proxy server must allow traffic to specific Google and Microsoft domains. The domains vary depending on if you are using an Azure Private Endpoint for Azure services. Choose whether you use a private endpoint and allow access to the following domains:

No private endpoint

Private endpoint

Create a proxy configuration file

The proxy configuration is stored in an Azure Key Vault secret as a JSON string. You can pass this configuration to the az command-line tool as a file. This section describes how to create that file.

The following table describes the contents of this file.

Field Description Examples Required
httpProxy A proxy server URL. The value should include a hostname/IP address and optionally a port, username, and password. "http://user:password@"
httpsProxy A proxy URL for encrypted, HTTPS traffic. The httpProxy URL will be used if httpsProxy isn't given. "" Yes
noProxy A comma-separated list of URLs to exclude from proxying. Each value can be an IP address, a CIDR range, a domain name, or the asterix character (*). Domains specified with a leading dot (e.g. "") indicate that a subdomain is required. A single asterix * ignores all proxy configuration. ",,," Yes
  1. To create the configuration file, create a JSON file that contains values for httpProxy, noProxy, and optional httpsProxy keys.

      "httpProxy": "AUTHENTICATION_URL",
      "httpsProxy": "AUTHENTICATION_URL",
      "noProxy": "NO_PROXY_ADDRESSES"

    Replace the following:

    • AUTHENTICATION_URL: Encoded URL containing the proxy username and the password
    • NO_PROXY_ADDRESSES: Comma separated list of CIDR blocks and URLs— for example,

    Save the file to use in the following section.

  2. Create a secret with this JSON data as a secret in Azure Key Vault using the az command-line tool.

    az keyvault secret set --name SECRET_NAME \
    --vault-name KEY_VAULT_NAME \

    Replace the following:

    • SECRET_NAME: the name of the new secret
    • KEY_VAULT_NAME: the name of your Key Vault
    • PROXY_CONFIGURATION_FILE: the path to your proxy configuration file.

      The output includes the secret's name and contents. You can now reference this secret when you create a cluster.

Create a cluster that uses a proxy

To configure Anthos clusters on Azure to use an HTTP proxy for outbound connectivity, perform the following steps:

  1. Follow the steps in Create a cluster and node pool and pass the --proxy-resource-group-id and --proxy-secret-id flags.

    gcloud container azure clusters create CLUSTER_NAME \
      --proxy-resource-group-id=PROXY_RESOURCE_GROUP_ID \

    Replace the following:

    • CLUSTER_NAME: your cluster's name
    • PROXY_RESOURCE_GROUP_ID: the resource group that hosts your cluster
    • PROXY_SECRET_ID: the ID of the secret that contains your proxy configuration— for example,

What's next