Configura la CLI de gcloud para usarla detrás de un proxy/firewall

Si estás detrás de un proxy o firewall empresarial, es posible que la CLI de Google Cloud no pueda acceder a Internet con su configuración predeterminada.

Instala la CLI de gcloud

Los instaladores interactivos de la CLI de gcloud descargan componentes de Internet como parte del proceso de instalación, que podría no funcionar correctamente si estás detrás de un proxy o un firewall.

Para facilitar el proceso de instalación cuando se necesita la configuración del proxy, usa uno de los archivos con versión autónomos para instalar la CLI de gcloud. Todas las versiones anteriores de la CLI de gcloud también están disponibles para descargar desde el archivo de descargas.

Configuración de proxy

Una vez que hayas instalado la CLI de gcloud, la configuración del proxy se puede establecer mediante las propiedades de la CLI de gcloud mediante la ejecución de gcloud config. Para obtener más información sobre qué son las propiedades de la CLI de gcloud y cómo usarlas, consulta la página de propiedades.

Para comenzar, establece el tipo de proxy que estás usando, además de la dirección y del puerto:

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]
  • La CLI de gcloud admite los siguientes valores para PROXY_TYPE: http, http_no_tunnel, socks4 y socks5.
  • PROXY_IP_ADDRESS es el nombre de host o la dirección IP en la que se encuentra el proxy.
  • PROXY_PORT es el puerto en el que se está ejecutando el proxy (por ejemplo, 8080).

Para un proxy autenticado, tendrás que configurar el nombre de usuario y la contraseña del proxy mediante propiedades de la siguiente manera:

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

Como alternativa, para evitar que las credenciales de proxy se guarden en cualquier registro (como el historial de shell o los registros de la CLI de gcloud) o en el archivo de configuración de la CLI de gcloud, puedes configurar las propiedades mediante variables de entorno, como se muestra en el siguiente ejemplo:

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

La CLI de gcloud no almacenará estos valores. De esta manera, las credenciales pueden almacenarse en un archivo encriptado localmente o en una ubicación de red segura, y recuperarse cuando sea necesario.

Si estás detrás de un proxy y recibes errores de protocolo de enlace SSL, es probable que tu proxy sea un proxy de intermediario que use una CA personalizada. Debes configurar la siguiente propiedad para que apunte a tu archivo de CA personalizado:

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

Para obtener una descripción completa de las propiedades relacionadas, ejecuta gcloud topic configurations o gcloud config set y busca proxy en la sección Propiedades disponibles.