Configurazione di gcloud CLI per l'utilizzo dietro un proxy/firewall

Se ti trovi dietro un proxy o un firewall aziendale, Google Cloud CLI potrebbe non potrà accedere a internet con le sue impostazioni predefinite.

Installazione dell'interfaccia a riga di comando gcloud

Gli installatori interattivi della CLI gcloud scaricano i componenti da internet nell'ambito del processo di installazione, che potrebbe non funzionare correttamente se ti trovi dietro un proxy o un firewall.

Per una procedura di installazione più semplice quando è necessaria la configurazione del proxy, utilizza uno degli archivi con versione autocontenuti per installare l'interfaccia a riga di comando gcloud. Tutte le versioni precedenti dell'interfaccia a riga di comando gcloud sono disponibili anche per il download dall'archivio dei download.

Configurare il proxy

Nota: l'interfaccia a riga di comando gcloud rispetta le variabili di ambiente http_proxy, https_proxy e no_proxy impostate nella configurazione del proxy; queste controllano rispettivamente il server proxy utilizzato per le connessioni HTTP non protette, il server proxy utilizzato per le connessioni HTTPS (in genere più pertinente per la maggior parte dei comandi gcloud CLI) e i domini da non eseguire tramite proxy. Configura le impostazioni del proxy di gcloud solo se vuoi utilizzare un proxy diverso. Se le impostazioni proxy gcloud sono impostate, sostituiscono la configurazione proxy esistente, incluso l'ignorare no_proxy.

Suggerimento: se visualizzi avvisi o errori relativi alla variabile di ambiente https_proxy, è possibile che tu abbia specificato ad esempio https_proxy=https://... instead of https_proxy=http://.... Quest'ultimo è necessario perché la CLI gcloud supporta solo i proxy HTTP. Le versioni precedenti gcloud CLI ha ignorato automaticamente questa differenza e avrebbe sempre tentare di contattare il proxy tramite HTTP anche se l'URL del proxy specificava HTTPS.

Dopo aver installato gcloud CLI, puoi configurare le impostazioni del proxy configurato mediante le proprietà dell'interfaccia a riga di comando gcloud eseguendo gcloud config. Per saperne di più sulle proprietà gcloud CLI e su come utilizzarle, consulta la pagina Proprietà.

Per iniziare, imposta il tipo di proxy che stai utilizzando, nonché l'indirizzo e la porta su cui per raggiungerlo:

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]

• L'interfaccia a riga di comando gcloud supporta i seguenti valori per PROXY_TYPE: http, http_no_tunnel, socks4, socks5
• PROXY_IP_ADDRESS è il nome host o l'indirizzo IP a cui è possibile accedere al proxy.
• PROXY_PORT è la porta su cui è in esecuzione il proxy (ad es. 8080).

Per un proxy autenticato, dovrai impostare il tuo nome utente e utilizzando le proprietà nel seguente modo:

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

In alternativa, per evitare che le credenziali proxy vengano registrate in tutti i log (come come cronologia della shell o i log di gcloud CLI) o nel di configurazione dell'interfaccia a riga di comando gcloud, puoi impostare le proprietà utilizzando variabili di ambiente, come illustrato nell'esempio seguente:

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

gcloud CLI non archivia questi valori. In questo modo, le credenziali possono essere archiviate localmente in un file criptato oppure in una posizione di rete sicura e recuperate quando necessario.

Se utilizzi un proxy e ricevi errori di handshake SSL, è probabile che il proxy sia un proxy man in the middle che utilizza una CA personalizzata. Ti servono per impostare la seguente proprietà in modo che punti al file CA personalizzato:

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

Per una descrizione completa delle proprietà correlate, esegui gcloud topic configurations o gcloud config set e cerca proxy nella sezione Proprietà disponibili.