Installa gcloud CLI

Questa pagina contiene le 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à gcloud CLI, vedi 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, come i comandi dell'interfaccia a riga della gcloud CLI a livello di release alpha o beta, consulta Gestione della gcloud CLI gcloud.

Linux
  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python da 3.8 a 3.11. 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 uno dei seguenti elementi:
    Piattaforma Nome pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    		 google-cloud-cli-455.0.0-linux-x86_64.tar.gz 199,2 MB cffa560f0820ffe2390ccb73c4def91bba8fa2d0c9244f6207e190cee3d2287d
    Linux a 64 bit

    (Arm)

    		 google-cloud-cli-455.0.0-linux-arm.tar.gz 117,1 MB ad6031ecc452b48aeb28ead5287d1b22a6bddf5950420759f8eb64c04d1d0556
    Linux a 32 bit

    (x86)

    		 google-cloud-cli-455.0.0-linux-x86.tar.gz 115,2 MB 271ac3c227a34c7290e7f0be8d8dde3378d91b7c7acf7a6f3687293221b37e9a

    Per scaricare il file di archivio Linux, esegui questo comando: 

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

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

  3. Per estrarre i contenuti del file nel tuo file system (preferibilmente nella tua home directory), esegui questo comando: 
    tar -xf google-cloud-cli-455.0.0-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. Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla directory principale della cartella in cui hai estratto utilizzando questo comando: 
    ./google-cloud-sdk/install.sh
    Questa operazione può anche essere eseguita in modo non interattivo (ad esempio, utilizzando uno script) e fornendo le preferenze sotto forma di flag. Per visualizzare i flag disponibili, esegui: 
    ./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 dei comandi, rispondi Y quando richiesto.
  5. Apri un nuovo terminale per applicare le modifiche.
  6. Per inizializzare gcloud CLI, esegui gcloud init: 
    7. ./google-cloud-sdk/bin/gcloud init
  7. (Facoltativo) Installa i componenti aggiuntivi utilizzando Gestione componenti.
Debian/Ubuntu

Contenuto della confezione

Gcloud CLI è disponibile in formato di 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 utilizzare 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 ancora raggiunto la fine del ciclo di vita.
  • Di recente ha aggiornato i suoi pacchetti: 
    sudo apt-get update
  • Ha apt-transport-https e curl installato: 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl sudo
Installazione
  1. Importa la chiave pubblica di Google Cloud.

    • Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e versioni successive), esegui questo 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 meno recenti, esegui questo 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 questo comando:

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

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

  2. Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud come origine del pacchetto.
    • Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e versioni successive), esegui questo 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 meno recenti che non supportano l'opzione "firmato da", 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
  3. Aggiorna e installa gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
    Per ulteriori opzioni di apt-get, come la disattivazione dei prompt o delle prove, consulta le pagine man di apt-get.

    Suggerimento 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] 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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -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] 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
  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 gcloud CLI#39;interfaccia a riga di comando gcloud

Per ripristinare una versione specifica dellgcloud CLI, dove VERSION è nel formato 123.0.0, esegui questo 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

Contenuto della confezione

L'gcloud CLI è disponibile in formato di 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 mediante 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. Consulta l'elenco dei pacchetti disponibili. Il seguente comando di esempio si riferisce a 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

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

Se vuoi ripristinare una versione specifica dell'interfaccia alla gcloud CLI, dove 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 disporre di una versione supportata di Python:
    • Per verificare la versione attuale di Python, esegui python3 -V o python -V. Le versioni supportate sono Python da 3.8 a 3.11.
    • Lo script di installazione principale offre l'installazione del linguaggio Python 3.11 di CPython.
    • Altrimenti, per installare una versione Python supportata, visita la pagina relativa alle versioni di Python per macOS di Python.org.
    • Se hai più interpreti Python installati sulla tua macchina, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che punti al percorso del tuo interprete preferito.
    • Per maggiori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
  2. Scarica uno dei seguenti elementi:

    3. Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit

    (x86_64)

    		 google-cloud-cli-455.0.0-darwin-x86_64.tar.gz 122,8 MB 561db89e1eb9c84329fa267c7b60ea2eb31752bd90c399d316eb372903fb9fd9
    macOS a 64 bit

    (ARM64, Apple M1 silicon)

    		 google-cloud-cli-455.0.0-darwin-arm.tar.gz 119,9 MB c92972969d6f07e312226fbc133546b5e679a7882a8e2063c1fcc67773eadb1f
    macOS a 32 bit

    (x86)

    		 google-cloud-cli-455.0.0-darwin-x86.tar.gz 121,5 MB 44c2165dcfc7d2a5430bd2190444bf72c87f2ce3ddc2500a9cf69161f534bad6
    1. Estrai l'archivio in qualsiasi posizione del file system (preferibilmente nella directory Home). In macOS, è possibile aprire 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 strumenti dell'interfaccia a riga di comando gcloud CLI a PATH.Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche sull'utilizzo e installare Python 3.11.

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

      ./google-cloud-sdk/install.sh
      Questa operazione può anche essere eseguita in modo non interattivo (ad esempio, utilizzando uno script) fornendo le preferenze sotto forma di flag. Per descrivere i flag disponibili, esegui: 
      ./google-cloud-sdk/install.sh --help
      Per eseguire lo script di installazione con la modalità screen reader su: 
      ./google-cloud-sdk/install.sh --screen-reader=true
      Apri un nuovo terminale per applicare le modifiche.
    3. Per inizializzare gcloud CLI, esegui gcloud init: 
      4. ./google-cloud-sdk/bin/gcloud init
    4. Facoltativo. 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 di 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 la modalità screen reader. Questa opzione configura gcloud in modo che utilizzi i tracker di stato anziché le rotelline Unicode, mostri l'avanzamento come percentuale e suddividi le tabelle. Per ulteriori informazioni, consulta la guida alle funzioni di accessibilità.

  3. Google Cloud CLI richiede Python; le versioni supportate sono Python 3.8-3.11. Per impostazione predefinita, la versione Windows di Google Cloud CLI include Python 3. Per utilizzare Google Cloud CLI, 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. Mentre Google Cloud CLI installa e gestisce 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 offre la possibilità di creare scorciatoie al menu Start e sul desktop, avviare la shell di 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 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 perché il comando find non viene riconosciuto, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. Di solito è C:\WINDOWS\system32;.
  • Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installare di nuovo l'interfaccia a riga di comando gcloud.
  • 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 gcloud CLI:

  • Utilizzi gcloud CLI con gli script o l'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 dell'interfaccia a riga di comando gcloud per la release più recente (o una versione specifica) di gcloud CLI.
  • Se utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Utilizza un pacchetto di snapshot per installare l'interfaccia a riga di comando gcloud.
  • Per le installazioni interattive su 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.

Gestisci 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 dei componenti e l'upgrade a una nuova versione o il downgrade a una versione specifica dellgcloud CLI.

Versioni precedenti di gcloud CLI

Se hai bisogno di una versione diversa di gcloud CLI, installa la versione corrente seguendo 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 da 3.8 a 3.11. 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