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

Se utilizzi un proxy o un firewall aziendale, Google Cloud CLI potrebbe non riuscire ad accedere a internet con le impostazioni predefinite.

Installazione di gcloud CLI

I programmi di installazione interattivi di gcloud CLI scaricano i componenti da internet nell'ambito del processo di installazione, che potrebbe non funzionare correttamente se utilizzi un proxy o un firewall.

Per un processo di installazione più semplice quando è necessaria la configurazione del proxy, utilizza uno degli archivi delle versioni autonomi per installare gcloud CLI. Tutte le versioni precedenti di gcloud CLI sono inoltre disponibili per il download dall'archivio dei download.

Configurare il proxy

Nota: gcloud CLI rispetta le variabili di ambiente http_proxy, https_proxy e no_proxy impostate nella configurazione del proxy; controllano rispettivamente il server proxy utilizzato per le connessioni HTTP semplici, il server proxy utilizzato per le connessioni HTTPS (in genere più pertinente per la maggior parte dei comandi dell'interfaccia a riga di comando gcloud) e i domini non per i proxy. Configura le impostazioni del proxy gcloud solo se vuoi utilizzare un proxy diverso. Se vengono impostate gcloud, le impostazioni del proxy sostituiscono la configurazione del proxy esistente. Ciò include anche la possibilità di 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://... invece di https_proxy=http://.... La seconda è necessaria perché gcloud CLI supporta solo i proxy HTTP. Le versioni precedenti di gcloud CLI ignoravano automaticamente questa differenza e tentavano sempre 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 utilizzando le proprietà dell'interfaccia a riga di comando gcloud eseguendo gcloud config. Per ulteriori informazioni su cosa sono le 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 raggiungerlo:

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]

• Gcloud CLI supporta i seguenti valori per PROXY_TYPE: http, http_no_tunnel, socks4, socks5
• PROXY_IP_ADDRESS è il nome host o l'indirizzo IP da cui può essere raggiunto il proxy.
• PROXY_PORT è la porta su cui è in esecuzione il proxy (ad esempio, 8080).

Per un proxy autenticato, devi impostare il nome utente e la password del proxy utilizzando le proprietà come segue:

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

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

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

L'interfaccia a riga di comando gcloud non archivierà questi valori. In questo modo, le credenziali possono essere archiviate localmente in un file criptato oppure in una posizione di rete sicura, per poi recuperarle quando necessario.

Se utilizzi un proxy e ricevi errori di handshake SSL, è probabile che si tratti di un proxy man in the middle che utilizza una CA personalizzata. Devi 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.