Configura gcloud CLI para su uso detrás de un proxy o firewall

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

Instala la CLI de gcloud

Los instaladores interactivos de gcloud CLI 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 firewall.

Para un proceso de instalación más simple cuando es necesaria la configuración de proxy, usa uno de los archivos con control de versiones autónomos para instalar gcloud CLI. 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

Nota: gcloud CLI respeta los valores http_proxy, https_proxy y Variables de entorno de no_proxy establecidas en la configuración del proxy. estos controlan el servidor proxy que se usa para las conexiones HTTP simples, el servidor proxy que se usa para Conexiones HTTPS (por lo general, más relevantes para la mayoría de gcloud CLI ) y los dominios que no se usarán mediante un proxy, respectivamente. Configura la configuración del proxy de gcloud solo si deseas usar un proxy diferente. Si se establece la configuración de proxy de gcloud, se anula la configuración de proxy existente, lo que incluye ignorar no_proxy.

Sugerencia: Si ves advertencias o errores relacionados con la variable de entorno https_proxy, es posible que se deba a que especificaste, por ejemplo, https_proxy=https://... en lugar de https_proxy=http://.... Lo último es necesario, ya que la CLI de gcloud solo admite proxies HTTP. Las versiones anteriores del gcloud CLI ignoró silenciosamente esta diferencia y siempre intenta comunicarse con el proxy a través de HTTP, incluso si la URL del proxy especifica HTTPS.

Una vez que hayas instalado gcloud CLI, puedes configurar el proxy a través de las propiedades de gcloud CLI. Para ello, ejecuta gcloud config. Para obtener más información sobre qué son las propiedades de gcloud CLI 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, deberás configurar tu nombre de usuario y contraseña de proxy mediante las propiedades de la siguiente manera:

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

Como alternativa, para evitar que se registren las credenciales del proxy en los registros (como como historial de shell o registros de gcloud CLI) o en la de configuración de gcloud CLI, puedes establecer las propiedades usando variables de entorno, como se muestra en el siguiente ejemplo:

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

Gcloud CLI 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 que tu proxy es un proxy de intermediario que usa una AC personalizada. Debes configurar la siguiente propiedad para que apunte a tu archivo de AC personalizado:

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

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