Installa gcloud CLI

Questa pagina contiene istruzioni per scegliere e gestire 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à di gcloud CLI, consulta Tutte le funzionalità.

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

Istruzioni di installazione

Queste istruzioni riguardano l'installazione di Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, come i comandi dell'interfaccia a riga della gcloud CLI a livello di release alpha o beta, consulta Gestire la gcloud CLI gcloud.

Linux
  1. Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python 3.8-3.13. Tieni presente che il pacchetto Linux x86_64 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 Nome pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 132,4 MB 3f964929afb8802b116114453a63ef91bfe87e304370d8d96ca1a93602d4c277
    Linux a 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 54,6 MB 62ca4a59e09740d9dfd5bc89cd7ff7895b1925fddc7c6b0f9a355f36efd6e027
    Linux a 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 54,6 MB 809a5600ab2917a68506faf5291437b10f4d0d4040962edf307737fcee4241ae

    Per scaricare il file dell'archivio Linux, esegui il seguente comando: 

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

    Fai riferimento alla tabella sopra e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto *.tar.gz applicabile alla tua configurazione.

  3. Per estrarre i contenuti del file nel file system (preferibilmente nella home directory), esegui il seguente comando: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     (Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
  4. (Facoltativo) Aggiungi gcloud CLI a PATH. Puoi anche attivare il completamento dei comandi per la raccolta della shell e delle statistiche di utilizzo. Esegui lo script di installazione (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando il seguente comando: 
    ./google-cloud-sdk/install.sh
     Questa operazione può essere eseguita anche in modo non interattivo (ad esempio utilizzando uno script) e fornendo le preferenze come flag. Per visualizzare i flag disponibili, esegui: 
    ./google-cloud-sdk/install.sh --help
    • Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare la gcloud CLI, rispondi Y quando richiesto.
    • Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando richiesto.
  5. Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale per applicare le modifiche.
  6. Per inizializzare la gcloud CLI, esegui gcloud init: 
    7. ./google-cloud-sdk/bin/gcloud init
  7. (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore dei componenti.
Debian/Ubuntu

Contenuti del pacchetto

Gcloud CLI è 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 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 gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

  • Si tratta di una release di Ubuntu che non ha raggiunto la fine del ciclo di vita o di una release stabile di Debian che non ha raggiunto la fine del ciclo di vita
  • Di recente ha aggiornato i suoi pacchetti: 
    sudo apt-get update
  • Sono installati apt-transport-https e curl: 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl
Installazione
  1. Importa la chiave pubblica di Google Cloud .

    • Per le distribuzioni più recenti (Debian 9 o versioni successive o Ubuntu 18.04 o versioni successive), esegui il seguente comando:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • Per le distribuzioni precedenti, esegui il seguente comando: 
      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 seguente comando:

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

    • 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.

  2. Aggiungi l'URI della distribuzione dell'interfaccia a riga di comando gcloud come origine del pacchetto.
    • Per le distribuzioni più recenti (Debian 9 o versioni successive o Ubuntu 18.04 o versioni successive), esegui il seguente comando: 
      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

    • Per le distribuzioni precedenti che non supportano l'opzione signed-by, esegui il seguente comando:

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. Aggiorna e installa gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Per altre opzioni di apt-get, ad esempio la disattivazione dei prompt o le prove, consulta le pagine di manuali di apt-get.

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

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    Per le immagini di base precedenti che non supportano il comando gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://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
  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

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

Per ripristinare una versione specifica di gcloud CLI, dove VERSION è del formato 123.0.0, esegui il seguente comando:

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

Red Hat/Fedora/CentOS

Contenuti del pacchetto

La gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi Red Hat Enterprise Linux 7, 8 e 9, Fedora 33 e 34 e CentOS 7 e 8. Questo pacchetto contiene solo i comandi gcloud, gcloud alpha, gcloud beta, gsutil e bq. Non include kubectl o le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud, che possono essere installati separatamente come descritto più avanti 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 9, ma assicurati di aggiornare le impostazioni in base alle esigenze della tua configurazione: 
    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-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
  2. Se esegui l'installazione su Fedora 34 o 35, installa libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Installa gcloud CLI: 
    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

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

Se vuoi ripristinare una versione specifica dell'interfaccia alla gcloud CLI, dove VERSION è del tipo 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 di Python attualmente in uso, esegui python3 -V o python -V. Le versioni supportate sono da Python 3.8 a 3.13.
    • Lo script di installazione principale offre la possibilità di installare Python 3.11 di CPython.
    • In caso contrario, per installare una versione di Python supportata, visita la pagina Uscite di Python per macOS su Python.org.
    • Se sulla tua macchina sono installati più interpreti Python, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che indichi il percorso dell'interprete che preferisci.
    • Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
  2. Scarica una delle seguenti opzioni:

    3. Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 54,7 MB 7754432976beaec18fbc3d66f907023e5a98be9cba3379d52e58b3a9d5520b03
    macOS a 64 bit

    (ARM64, Apple M1 silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 54,6 MB 736d81ad09baf325b4fd6ad95be4caa8fc19fe378ce6674819ff0f23058ebd70
    macOS a 32 bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 53,3 MB 6e1f750fc7f06a2f745a24296a7c0dba928cb08b35a74dda259d29bd9deee647
  3. Estrai l'archivio in qualsiasi posizione del file system (preferibilmente nella home directory). Su macOS, puoi farlo aprendo il file dell'archivio .tar.gz scaricato nella posizione che preferisci.

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

  4. Esegui lo script di installazione (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando il seguente comando: 
    ./google-cloud-sdk/install.sh

    Lo script ti chiederà di installare Python 3.11 e alcuni moduli consigliati.

    L'installazione può essere eseguita anche in modo non interattivo (ad esempio utilizzando uno script) specificando le preferenze come flag. Per descrivere gli indicatori disponibili, esegui: 
    ./google-cloud-sdk/install.sh --help
     Per eseguire lo script di installazione con la modalità dello screen reader attiva: 
    ./google-cloud-sdk/install.sh --screen-reader=true
     (Facoltativo)
    • Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare la gcloud CLI, rispondi Y quando richiesto.
    • Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando richiesto.
  5. Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale per applicare le modifiche.
  6. Per inizializzare la gcloud CLI, esegui gcloud init: 
    7. ./google-cloud-sdk/bin/gcloud init
  7. Facoltativo. Installa 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 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. L'installatore è firmato da Google LLC.

    Se utilizzi uno screen reader, seleziona la casella di controllo Attiva la modalità dello screen reader. Questa opzione configura gcloud in modo da utilizzare gli indicatori di stato anziché gli spinner Unicode, visualizzare l'avanzamento come percentuale e appiattire le tabelle. Per ulteriori informazioni, consulta la guida alle funzionalità di accessibilità.

  3. Google Cloud CLI richiede Python; le versioni supportate sono da Python 3.8 a 3.13. Per impostazione predefinita, la versione di Google Cloud CLI per Windows è fornita in bundle con Python 3. Per utilizzare Google Cloud CLI, il 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 di Python richiesta. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione di Python esistente deselezionando l'opzione Installa Python incluso. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.

  4. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie sul menu Start e sul desktop, avviare la shell Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare selezionate le opzioni per avviare la shell e configurare l'installazione. Il programma di installazione avvia una finestra del terminale ed esegue il comando gcloud init.

  5. L'installazione predefinita non include le estensioni 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. In genere, si tratta di C:\WINDOWS\system32;.
  • Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di reinstallarlo.
  • Se l'estrazione non va a buon fine, esegui il programma di installazione come amministratore.

Altre opzioni di installazione

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

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

Gestire un'installazione

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

Nota: se hai utilizzato apt-get o yum per installare gcloud CLI, devi utilizzare apt-get o yum per aggiornare o rimuovere i componenti, non gcloud components.

Versioni precedenti dell'interfaccia a riga di comando gcloud

Se hai bisogno di una versione diversa di gcloud CLI, installa la versione corrente seguendo le istruzioni riportate 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 Creata.

Versioni di Python supportate

Google Cloud CLI richiede Python 3.8-3.13. 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