Installa l'interfaccia a riga di comando gcloud

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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

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

Istruzioni sull'installazione

Queste istruzioni riguardano l'installazione di Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, ad esempio i comandi dell'interfaccia a riga di comando gcloud a livello di release alpha o beta, consulta Gestione dei componenti dell'interfaccia a riga di comando di gcloud.

Linux
  1. Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python 3 (da 3.5 a 3.9). Tieni presente che il pacchetto x86_64 Linux include un interprete Python in bundle che sarà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
  2. Scarica una delle seguenti opzioni:
    Piattaforma Pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    		 google-cloud-cli-422.0.0-linux-x86_64.tar.gz 197,5 MB 4f9a720fab0ce4a9339fd8ad0d86a6f1cb45a6c734e32fc0862cff3f26627011
    Linux a 64 bit

    (ARM)

    		 google-cloud-cli-422.0.0-linux-arm.tar.gz 125,7 MB 8ff25dd71f0d27ea6f8e19164a2cccc2408a783085ff2d78999f6d155d852418
    Linux a 32 bit

    (x86)

    		 google-cloud-cli-422.0.0-linux-x86.tar.gz 126,6 MB d39aa9d45b3c5200f2eb4e7a82bdb0a0877100f6ee531b5036b01d8abb6f9c58

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-422.0.0-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-422.0.0-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-422.0.0-linux-x86.tar.gz
  3. Estrai i contenuti del file in qualsiasi posizione nel file system (preferibilmente nella home directory). 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-422.0.0-linux-x86.tar.gz
  4. Aggiungi l'interfaccia a riga di comando gcloud al tuo percorso. Esegui lo script di installazione dalla directory principale della cartella estratta usando il comando seguente: 
    ./google-cloud-sdk/install.sh
    Questa operazione può essere eseguita anche in modo non interattivo, ad esempio utilizzando uno script, e impostando le preferenze come flag. Per visualizzare i flag disponibili, esegui: 
    ./google-cloud-sdk/install.sh --help
    (Facoltativo) Per inviare statistiche di utilizzo anonime per contribuire a migliorare l'interfaccia a riga di comando gcloud, rispondi Y quando richiesto.
    Per aggiungere l'interfaccia a riga di comando gcloud al tuo PATH e abilitare il completamento del comando, rispondi Y quando richiesto.
  5. Apri un nuovo terminale per rendere effettive le modifiche.
  6. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init:
    7. ./google-cloud-sdk/bin/gcloud init
  7. Opzione facoltativa. Installa i componenti aggiuntivi utilizzando Gestione componenti.
Debian/Ubuntu

Contenuti della confezione

L'interfaccia a riga di comando gcloud è disponibile in formato pacchetto per l'installazione su 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 questi componenti, devi installarli separatamente.

Prima di iniziare

Prima di installare l'interfaccia a riga di comando gcloud, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

  • Una release Ubuntu che non ha raggiunto end-of-life o una release stabile 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 del pacchetto. Se la distribuzione supporta l'opzione Sign-by, 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 Sign-by, 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
  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 tua 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 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 ultimi aggiornamenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.

  3. Aggiorna e installa l'interfaccia a riga di comando gcloud: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
    Per ulteriori opzioni per apt-get, ad esempio la disattivazione delle richieste o delle prove, consulta le pagine man di apt-get.

    Suggerimento Docker: se installi l'interfaccia a riga di comando gcloud all'interno di un'immagine Docker, usa invece 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 come segue: 

    sudo apt-get install google-cloud-cli-app-engine-java
  5. Esegui gcloud init per iniziare: 
    gcloud init

Downgrade di una versione dell'interfaccia a riga di comando gcloud

Per ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, dove 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 release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Cappello rosso/Fedora/CentOS

Contenuti della confezione

L'interfaccia a riga di comando gcloud è disponibile in formato 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 installati separatamente come descritto in seguito in questa sezione.

Installazione
  1. Aggiorna DNF con le informazioni del repository dell'interfaccia a riga di comando gcloud. Il seguente comando di esempio riguarda 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
  2. Se utilizzi Fedora 34 o 35, installa libcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Installa l'interfaccia a riga di comando gcloud: 
    sudo dnf install google-cloud-cli
  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 come segue: 

    sudo dnf install google-cloud-cli-app-engine-java
  5. Esegui gcloud init per iniziare: 
    gcloud init

Downgrade di una versione dell'interfaccia a riga di comando gcloud

Se vuoi ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, 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 release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

macOS
  1. Verifica di avere una versione di Python supportata:
    • Per controllare la versione attuale 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 scoprire di più su come scegliere e configurare l'interprete Python, consulta la pagina gcloud topic startup.
  2. Scarica uno dei seguenti elementi:

    3. Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit

    (x86_64)

    		 google-cloud-cli-422.0.0-darwin-x86_64.tar.gz 131,8 MB 907bd779fcfff992d85228d2de378a9822a08482776bd0d7758d4563102cc715
    macOS a 64 bit

    (ARM64, Apple M1 silicon)

    		 google-cloud-cli-422.0.0-darwin-arm.tar.gz 128,7 MB 1496771559a10c6548e4b4ab879cd4646e9e6397da416df92c36e4b2224b25e9
    macOS a 32 bit

    (x86)

    		 google-cloud-cli-422.0.0-darwin-x86.tar.gz 111,5 MB 1e5cb43aaa0c6bedb96e5ee434279c10f152356b559165cc95d908ccb6ec04bb
    1. Estrai l'archivio in qualsiasi posizione nel file system (preferibilmente nella home directory). Su macOS, puoi eseguire questa operazione aprendo il file di archivio .tar.gz scaricato nella posizione preferita.

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

    2. (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud al tuo PATH.Puoi anche attivare il completamento dei comandi per la tua shell, raccogliere le statistiche di utilizzo e installare Python 3.7.

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

      ./google-cloud-sdk/install.sh
      Questa operazione può essere eseguita anche in modo non interattivo (ad esempio, utilizzando uno script) impostando le preferenze come flag. 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 per rendere effettive le modifiche.
    3. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init: 
      4. ./google-cloud-sdk/bin/gcloud init
    4. Opzione facoltativa. Installa i componenti aggiuntivi utilizzando Gestione 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 configura gcloud per l'utilizzo dei tracker di stato anziché degli spinner Unicode, per visualizzare l'avanzamento in percentuale e suddividere 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 è 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. Sebbene Cloud SDK installi e gestisca Python 3 per impostazione predefinita, puoi utilizzare un'installazione Python esistente, se necessario, deselezionando l'opzione per installare Python in bundle. Consulta la pagina gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.

  4. Al termine dell'installazione, il programma di installazione ti consentirà di creare menu Start e scorciatoie sul desktop, avviare la shell dell'interfaccia a Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e 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. Questi componenti possono essere installati 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 a causa del mancato riconoscimento del comando find, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. Solitamente, è C:\WINDOWS\system32;.
  • Se hai disinstallato l'interfaccia a riga di comando gcloud, devi riavviare il sistema prima di installarlo di nuovo.
  • 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, invece dell'installazione consigliata, puoi utilizzare un metodo alternativo per installare l'interfaccia a riga di comando gcloud:

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

Gestire un'installazione

Dopo aver installato l'interfaccia a riga di comando gcloud, puoi utilizzare i comandi nel gruppo di comandi gcloud components per gestire l'installazione. Questo 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 dell'interfaccia a riga di comando gcloud.

Versioni precedenti dell'interfaccia a riga di comando gcloud

Se hai bisogno di una versione diversa dell'interfaccia a riga di comando gcloud, installa la versione corrente utilizzando le istruzioni visualizzate in precedenza in questa pagina, quindi accedi. Dopo aver eseguito l'accesso, puoi scaricare le release precedenti. Per visualizzare le versioni ordinate per data, assicurati di attivare Ordina e filtra e fai clic sulla colonna Creato.

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, consulta 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