Como configurar o Cloud SDK para uso atrás de um proxy/firewall

Se você tiver um proxy ou firewall corporativo ativado, a ferramenta de linha de comando gcloud talvez não consiga acessar a Internet com as configurações padrão.

Instalar o SDK do Cloud

Os instaladores interativos do SDK do Cloud fazem o download de componentes da Internet como parte do processo de instalação, o que pode não funcionar corretamente se você estiver usando um proxy ou firewall.

Para simplificar o processo de instalação quando for necessário configurar o proxy, use um dos arquivos com controle de versão independentes para instalar o SDK do Cloud. Todas as versões anteriores do SDK do Cloud também estão disponíveis para download no arquivo de downloads.

Configuração do proxy

Depois de instalar o SDK do Cloud, execute gcloud config para definir as configurações de proxy usando as propriedades dele. Para mais informações sobre o que são as propriedades do SDK do Cloud e como usá-las, consulte a página de propriedades.

Para começar, defina o tipo de proxy que você está usando, o endereço e a porta em que ele pode ser localizado:

```posix-terminal
gcloud config set proxy/type [PROXY_TYPE]
gcloud config set proxy/address [PROXY_IP_ADDRESS]
gcloud config set proxy/port [PROXY_PORT]
```
  • O SDK do Cloud é compatível com os seguintes valores para PROXY_TYPE: http, http_no_tunnel, socks4, socks5
  • PROXY_IP_ADDRESS é o nome do host ou o endereço IP de em que o proxy pode ser localizado.
  • PROXY_PORT é a porta em que o proxy está sendo executado, por exemplo, 8080.

Para um proxy autenticado, será necessário definir seu nome de usuário e senha de proxy usando propriedades da seguinte maneira:

```posix-terminal
gcloud config set proxy/username [USERNAME]
gcloud config set proxy/password [PASSWORD]
```

Como alternativa, para evitar que as credenciais de proxy sejam registradas em qualquer registro (como o histórico do shell ougcloud registros de ferramentas) ou nos gcloud, você pode definir as propriedades usando variáveis de ambiente, conforme o exemplo a seguir:

```posix-terminal
export CLOUDSDK_PROXY_USERNAME [USERNAME]
export CLOUDSDK_PROXY_PASSWORD [PASSWORD]
```

A ferramenta gcloud não armazenará esses valores. Assim, as credenciais podem ser armazenadas em um arquivo criptografado localmente ou armazenadas em um local de rede seguro e recuperadas quando necessário.

Se você estiver atrás de um proxy e receber erros de handshake de SSL, é provável que seu proxy seja um proxy "man-in-the-middle" que use uma CA personalizada. Defina a propriedade a seguir para apontar para o arquivo de CA personalizado:

```posix-terminal
gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]
```

Para uma descrição completa das propriedades relacionadas, execute gcloud topic configurations ougcloud config set e procureproxy na seção "Propriedades disponíveis".