Configurar a CLI gcloud para utilização através de um proxy/firewall

Se estiver a usar um proxy ou uma firewall empresarial, a CLI gcloud pode não conseguir aceder à Internet com as respetivas predefinições.

Instalar a CLI gcloud

Os instaladores interativos da CLI gcloud transferem componentes da Internet como parte do processo de instalação, o que pode não funcionar corretamente se estiver a usar um proxy ou uma firewall.

Para um processo de instalação mais simples quando a configuração do proxy é necessária, use um dos arquivos com versões autónomos para instalar a CLI gcloud. Todas as versões anteriores da CLI gcloud também estão disponíveis para transferência no arquivo de transferências.

Configuração do proxy

Depois de instalar a CLI gcloud, pode configurar as definições de proxy através das propriedades da CLI gcloud executando gcloud config. Para mais informações sobre o que são as propriedades da CLI gcloud e como as usar, consulte a página propriedades.

Para começar, defina o tipo de proxy que está a usar, bem como o endereço e a porta nos quais o alcançar:

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]
  • A CLI gcloud suporta os seguintes valores para PROXY_TYPE: http, http_no_tunnel, socks4, socks5
  • PROXY_IP_ADDRESS é o nome do anfitrião ou o endereço IP onde o proxy pode ser acessado.
  • PROXY_PORT é a porta em que o proxy está a ser executado (por exemplo, 8080).

Para um proxy autenticado, tem de definir o nome de utilizador e a palavra-passe do proxy através de properties da seguinte forma:

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

Em alternativa, para evitar que as credenciais do proxy sejam registadas em quaisquer registos (como o histórico da shell ou os registos da CLI gcloud) ou no ficheiro de configuração da CLI gcloud, pode definir as propriedades através de variáveis de ambiente, conforme mostrado no seguinte exemplo:

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

A CLI gcloud não armazena estes valores. Desta forma, as credenciais podem ser armazenadas num ficheiro encriptado localmente ou podem ser armazenadas numa localização de rede segura e obtidas quando necessário.

Se estiver a usar um proxy e receber erros de handshake SSL, é provável que o seu proxy seja um proxy man-in-the-middle que usa uma AC personalizada. Tem de definir a seguinte propriedade para apontar para o seu ficheiro de CA personalizado:

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

Para uma descrição completa das propriedades relacionadas, execute o comando gcloud topic configurations ou gcloud config set e procure proxy na secção Propriedades disponíveis.