Installa gcloud CLI

Questa pagina contiene le istruzioni per scegliere e mantenere un'installazione di Google Cloud CLI. Google Cloud CLI include gli strumenti a riga di comando gcloud, gsutil e bq. Per un elenco delle funzionalità gcloud CLI, vedi Tutte le funzionalità.

Per accedere alle API di Google Cloud utilizzando un linguaggio di programmazione supportato, puoi scaricare le librerie client di Cloud.

Istruzioni sull'installazione

Queste istruzioni servono per installare Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, come i comandi dell'interfaccia a riga della gcloud CLI a livello di versione alpha o beta, consulta la gestione della gcloud CLI dell'interfaccia a riga di comando gcloud.

Nota: se ti trovi dietro un proxy/firewall, consulta la pagina delle impostazioni del proxy per ulteriori informazioni sull'installazione.

Linux

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3 (da 3,5 a 3,9). Tieni presente che il pacchetto Linux x86_64 include un interprete Python in bundle che verrà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
2. Scarica una delle seguenti opzioni:
   Nota: per determinare la versione del tuo sistema operativo, esegui getconf LONG_BIT nella riga di comando.

   Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-433.0.1-linux-x86_64.tar.gz	186,4 MB	35e02dfcca34101c9e88a2442ea978ac5d8a6904e7d66e9e8c4f6dbbcf932742
   Linux a 64 bit (ARM)	google-cloud-cli-433.0.1-linux-arm.tar.gz	114,4 MB	e5bf2f6b13e5c92ec4dafdf200b58170d6eeeb807428289bb934b3a41f217964
   Linux a 32 bit (x86)	google-cloud-cli-433.0.1-linux-x86.tar.gz	115,7 MB	0074f4044d3443837dc754a12cd0a615efac89ad0b5144bc5b8a62758cad4a5f

   In alternativa, per scaricare il file di archivio a 64 bit di Linux, esegui questo comando dalla riga di comando:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-433.0.1-linux-x86_64.tar.gz

   Per il file di archivio ARM a 64 bit, esegui:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-433.0.1-linux-arm.tar.gz

   Per il file di archivio a 32 bit, esegui:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-433.0.1-linux-x86.tar.gz

3. Estrai i contenuti del file in qualsiasi posizione nel file system (preferibilmente la tua directory Home). Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente, quindi estrai l'archivio nella stessa posizione. L'esempio seguente mostra il comando per Linux a 32 bit. Se utilizzi un'altra piattaforma, modifica il comando di conseguenza:

   tar -xf google-cloud-cli-433.0.1-linux-x86.tar.gz

4. Aggiungi l'interfaccia alla gcloud CLI al tuo percorso. Esegui lo script di installazione dalla radice della cartella che hai estratto utilizzando il seguente comando:

   ./google-cloud-sdk/install.sh
   

   Puoi anche farlo in modo non interattivo (ad esempio utilizzando uno script) e impostando le preferenze come flag. Per visualizzare i flag disponibili, esegui questo comando:

   ./google-cloud-sdk/install.sh --help
   

   (Facoltativo) Per inviare statistiche sull'utilizzo anonime per migliorare l'interfaccia alla gcloud CLI, rispondi Y quando richiesto.
   Per aggiungere gcloud CLI a PATH e abilitare il completamento del comando, rispondi Y quando richiesto.
5. Apri un nuovo terminale in modo che le modifiche vengano applicate.
6. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

7. Campo facoltativo. Installa i componenti aggiuntivi utilizzando il gestore dei componenti.

Debian/Ubuntu

Nota:a seconda della configurazione, puoi scegliere altri metodi di installazione:

• Se vuoi che gcloud e gsutil vengano aggiornati automaticamente alla versione più recente ed esegui una release Ubuntu moderna che utilizza Snap Package Manager, puoi installare Google Cloud CLI come pacchetto di snack.
• Se utilizzi un'istanza su Compute Engine, l'gcloud CLI è installata per impostazione predefinita.

Contenuto della confezione

Gcloud CLI è disponibile in formato pacchetto per l'installazione sui sistemi Debian e Ubuntu. Questo pacchetto contiene solo i comandi gcloud, gcloud alpha, gcloud beta, gsutil e bq. Non include kubectl o le estensioni di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Se vuoi utilizzare questi componenti, devi installarli separatamente.

Prima di iniziare

Prima di installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

• Una release di Ubuntu che non ha raggiunto end-of-life o una release stabile di Debian che non ha raggiunto end-of-life
• apt-transport-https è installato:

  sudo apt-get install apt-transport-https ca-certificates gnupg

Installazione

1. Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud come origine pacchetto. Se la tua distribuzione supporta l'opzione di accesso eseguito, esegui il comando seguente:

   echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Se la tua distribuzione non supporta l'opzione di accesso eseguito, esegui il comando seguente:

   echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Nota: assicurati di non avere voci duplicate per il repository cloud-sdk in /etc/apt/sources.list.d/google-cloud-sdk.list.
2. Importa la chiave pubblica di Google Cloud. Se il comando apt-key della tua distribuzione supporta l'argomento --keyring, esegui il comando seguente:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   Se il comando apt-key della distribuzione non supporta l'argomento --keyring, esegui il comando seguente:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   Se la tua distribuzione (Debian 11+ o Ubuntu 21.10+) non supporta apt-key, esegui il comando seguente:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg

   Se non riesci a ricevere gli aggiornamenti più recenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.

3. Aggiorna e installa gcloud CLI:

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Per ulteriori opzioni per apt-get, come la disattivazione delle richieste o le prove, fai riferimento alle pagine man di apt-get.

   Suggerimento sul Docker: se installi l'interfaccia alla gcloud CLI;interno di un'immagine Docker, utilizza un singolo passaggio RUN:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

   Se il comando apt-key non è supportato:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
         

4. (Facoltativo) Installa uno dei seguenti componenti aggiuntivi:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Ad esempio, il componente google-cloud-cli-app-engine-java può essere installato nel seguente modo:

   sudo apt-get install google-cloud-cli-app-engine-java

5. Esegui gcloud init per iniziare:

   gcloud init

Downgrade gcloud CLI#39;interfaccia a riga di comando gcloud

Per tornare a una versione specifica dellgcloud CLI, in cui VERSION è nel formato 123.0.0, esegui il comando seguente:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Le dieci release più recenti sono sempre disponibili nel repository.

NOTA: per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Cappello rosso/Fedora/CentOS

Nota:se utilizzi un'istanza su Compute Engine, Google Cloud CLI è installato per impostazione predefinita.

Contenuto della confezione

Gcloud CLI è disponibile in formato di pacchetto per l'installazione su sistemi Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, Fedora 34, CentOS 7 e Centos 8. Questo pacchetto contiene solo i comandi gcloud, gcloud alpha, gcloud beta, gsutil e bq. Non include kubectl o le estensioni di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud, che possono essere installate separatamente come descritto in seguito in questa sezione.

Installazione

1. Aggiorna DNF con le informazioni del repository gcloud CLI. Il seguente comando di esempio è per un'installazione compatibile con Red Hat Enterprise Linux 8. Per un'installazione compatibile con Red Hat Enterprise Linux 7, sostituisci el8 con el7 nel valore di baseUrl.

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM
   

   Nota: la seconda riga di gpgkey deve essere rientrata come mostrato.
2. Se utilizzi Fedora 34 o 35, installa libcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installa gcloud CLI:

   sudo dnf install google-cloud-cli

Nota: se non sei passato a dnf sul tuo sistema, puoi eseguire questi comandi utilizzando yum.

Puoi anche utilizzare le opzioni dnf/yum, come la disattivazione delle richieste o le prove, con i comandi forniti.

4. (Facoltativo) Installa uno dei seguenti componenti aggiuntivi:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Ad esempio, il componente google-cloud-cli-app-engine-java può essere installato nel seguente modo:

   sudo dnf install google-cloud-cli-app-engine-java

5. Esegui gcloud init per iniziare:

   gcloud init

Downgrade gcloud CLI#39;interfaccia a riga di comando gcloud

Se vuoi ripristinare una versione specifica dell'interfaccia alla gcloud CLI, in cui VERSION è nel formato 123.0.0, esegui: sudo dnf downgrade google-cloud-cli-VERSION Le dieci release più recenti saranno sempre disponibili nel repository. NOTA: per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

macOS

1. Verifica di avere una versione supportata di Python:
   • Per controllare la versione corrente di Python, esegui python3 -V o python -V. Le versioni supportate sono Python 3 (da 3.5 a 3.9).
   • Per Cloud SDK versione 352.0.0 e successive, lo script di installazione principale offre l'installazione di Python 3.7 di CPython su Mac basati su Intel.
   • Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
2. Scarica una delle seguenti opzioni:
   Nota: per determinare il nome hardware della tua macchina, esegui uname -m da una riga di comando.

Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
macOS a 64 bit (x86_64)	google-cloud-cli-433.0.1-darwin-x86_64.tar.gz	120,6 MB	586fc822c1d372210660fe0f48971bef9193fe15a9f5d4f100e36c53679fb3ac
macOS a 64 bit (ARM64, Apple M1 silicon)	google-cloud-cli-433.0.1-darwin-arm.tar.gz	117,8 MB	0810c27e41a1c258ce0f8bb2122459887cd8630db356da0fea276696d0308a44
macOS a 32 bit (x86)	google-cloud-cli-433.0.1-darwin-x86.tar.gz	100,4 MB	64b12b2d83f9eb017c85478b03d7d9247c8bddbef8903057bb7b763f5e5bca07

1. Estrai l'archivio in una qualsiasi posizione del file system (preferibilmente la home directory). Su macOS, puoi farlo aprendo il file di archivio .tar.gz scaricato nella posizione preferita.

   Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente, quindi estrai l'archivio nella stessa posizione.

2. (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti gcloud CLI al PATH.Puoi anche attivare il completamento dei comandi per la tua shell, la raccolta delle statistiche di utilizzo e installare Python 3.7.

   Esegui lo script (dalla radice della cartella che hai estratto nell'ultimo passaggio) utilizzando questo comando:

   ./google-cloud-sdk/install.sh
   

   Puoi anche farlo in modo non interattivo, ad esempio utilizzando uno script, mediante la preferenza delle segnalazioni. Per descrivere i flag disponibili, esegui:

   ./google-cloud-sdk/install.sh --help
   

   Per eseguire lo script di installazione con la modalità screen reader attivata:

   ./google-cloud-sdk/install.sh --screen-reader=true
   

   Apri un nuovo terminale in modo che le modifiche vengano applicate.
3. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

4. Campo facoltativo. Installa i componenti aggiuntivi utilizzando il gestore dei componenti.

Windows

Google Cloud CLI funziona su Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive.

1. Scarica il programma di installazione di Google Cloud CLI.

   In alternativa, apri un terminale PowerShell ed esegui i seguenti comandi di PowerShell:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. Avvia il programma di installazione e segui le istruzioni nei prompt. Il programma di installazione è firmato da Google LLC.

   Se utilizzi uno screen reader, seleziona la casella di controllo Attiva modalità screen reader. Questa opzione consente di configurare gcloud in modo che utilizzi i tracker di stato anziché le rotelline Unicode, visualizza l'avanzamento in percentuale e riunisce le tabelle. Per ulteriori informazioni, consulta la Guida alle funzioni di accessibilità.

3. Cloud SDK richiede Python; le versioni supportate sono Python 3 (da 3.5 a 3.9). Per impostazione predefinita, la versione Windows di Cloud SDK viene fornita in bundle con Python 3. Per utilizzare Cloud SDK, il tuo sistema operativo deve essere in grado di eseguire una versione supportata di Python.

   Il programma di installazione installa tutte le dipendenze necessarie, inclusa la versione Python necessaria. Anche se Cloud SDK installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare un'installazione Python esistente se necessario deselezionando l'opzione per installare il bundle bundle Python. Consulta gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.

4. Al termine dell'installazione, il programma di installazione ti offre l'opzione di creare scorciatoie di menu e avvio, avviare la shell di Google Cloud CLI e configurare l'interfaccia a gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e di configurare l'installazione selezionata. Il programma di installazione avvia una finestra del terminale ed esegue il comando gcloud init.

5. L'installazione predefinita non include le estensioni di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Puoi installare questi componenti utilizzando il gestore dei componenti dell'interfaccia a riga di comando gcloud.

Suggerimenti per la risoluzione dei problemi:

• Se l'installazione non va a buon fine perché il comando find non viene riconosciuto, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. In genere, è C:\WINDOWS\system32;.
• Se hai disinstallato l'interfaccia alla gcloud CLI, devi riavviare il sistema prima di riinstallare l'interfaccia a riga di comando gcloud CLI.
• Se la decompressione non va a buon fine, esegui il programma di installazione come amministratore.

Altre opzioni di installazione

A seconda delle tue esigenze di sviluppo, anziché l'installazione consigliata, puoi utilizzare un metodo alternativo per installare gcloud CLI:

• Utilizzi l'interfaccia alla gcloud CLI con script o integrazione/deployment continui? Scarica un archivio con versione per un'installazione non interattiva di una versione specifica dellgcloud CLI.
• Devi eseguire l'interfaccia alla gcloud CLI come immagine Docker? Utilizza l'immagine Docker di gcloud CLI per la release più recente (o una versione specifica) di gcloud CLI.
• Utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Utilizzare un pacchetto di snapshot per installare gcloud CLI.
• Per le installazioni interattive Windows e macOS e per tutti gli altri casi d'uso, esegui il programma di installazione interattivo per installare la release più recente dellgcloud CLI.

Gestire un'installazione

Dopo aver installato l'gcloud CLI, puoi utilizzare i comandi nel gruppo di comandi gcloud components per gestire l'installazione. Ciò include la visualizzazione dei componenti installati, l'aggiunta e la rimozione di componenti e l'upgrade a una nuova versione o il downgrade a una versione specifica dellgcloud CLI.

Nota: se hai installato l'interfaccia alla gcloud CLI utilizzando apt-get o yum, utilizza apt-get o yum per aggiornare o rimuovere i componenti. Questa funzionalità non è disponibile utilizzando gcloud components per le installazioni apt-get e yum.

Versioni precedenti dell'interfaccia a riga di comando gcloud

Se hai bisogno di una versione diversa dellgcloud CLI, installa la versione corrente seguendo le istruzioni riportate in precedenza su questa pagina e poi accedi. Dopo aver eseguito l'accesso, puoi scaricare le versioni precedenti. Per visualizzare le versioni ordinate per data, assicurati di attivare Ordina e filtra e fai clic sulla colonna Creata.

Versioni di Python supportate

Google Cloud CLI richiede Python 3 (da 3.5 a 3.9). Per informazioni su come scegliere e configurare l'interprete Python, vedi gcloud topic startup

Provalo

Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Inizia gratuitamente