Se você estiver atrás de um proxy corporativo ou firewall, o Google Cloud CLI pode não conseguir acessar a Internet com suas configurações padrão.
Instalando o gcloud CLI
Os instaladores interativos do gcloud CLI baixam componentes da Internet como parte do processo de instalação, o que pode não funcionar corretamente se você estiver atrás de um proxy ou firewall.
Para um processo de instalação mais simples quando a configuração de proxy for necessária, use um dos arquivos versionados independentes para instalar a CLI do gcloud. Todas as versões anteriores da CLI do gcloud também estão disponíveis para download no arquivo de downloads .
Configuração de proxy
Após a instalação da CLI do gcloud, as configurações de proxy podem ser configuradas usando as propriedades da CLI do gcloud executando gcloud config
. Para obter mais informações sobre o que são as propriedades da CLI do gcloud e como usá-las, consulte a página de propriedades .
Para começar, defina o tipo de proxy que você está usando e o endereço e a porta para acessá-lo:
gcloud config set proxy/type [PROXY_TYPE]
gcloud config set proxy/address [PROXY_IP_ADDRESS]
gcloud config set proxy/port [PROXY_PORT]
- O gcloud CLI suporta os seguintes valores para
PROXY_TYPE
:http
,http_no_tunnel
,socks4
,socks5
-
PROXY_IP_ADDRESS
é o nome do host ou endereço IP de onde o proxy pode ser acessado. -
PROXY_PORT
é a porta na qual o proxy está sendo executado (por exemplo,8080
).
Para um proxy autenticado, você precisará definir seu nome de usuário e senha do proxy usando as propriedades da seguinte maneira:
gcloud config set proxy/username [USERNAME]
gcloud config set proxy/password [PASSWORD]
Como alternativa, para evitar que as credenciais do proxy sejam registradas em quaisquer logs (como histórico do shell ou logs do gcloud CLI) ou no arquivo de configuração do gcloud CLI, você pode definir as propriedades usando variáveis de ambiente, conforme mostrado no exemplo a seguir:
export CLOUDSDK_PROXY_USERNAME [USERNAME]
export CLOUDSDK_PROXY_PASSWORD [PASSWORD]
A CLI do gcloud não armazena esses valores. Dessa forma, as credenciais podem ser armazenadas em um arquivo criptografado localmente ou em um local de rede seguro e recuperadas quando necessário.
Se você estiver atrás de um proxy e receber erros de handshake SSL, é provável que seu proxy seja um proxy intermediário que usa uma CA personalizada. Você precisa definir a seguinte propriedade para apontar para o seu arquivo de CA personalizado:
gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]
Para uma descrição completa das propriedades relacionadas, execute gcloud topic configurations
ou gcloud config set
e procure por proxy na seção Propriedades disponíveis.