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 istruzioni per scegliere e gestire l'installazione di Google Cloud CLI. L'interfaccia a riga di comando di Google Cloud include gli strumenti a riga di comando gcloud, gsutil e bq. Per un elenco delle funzionalità dell'interfaccia a riga di comando gcloud, 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 di comando gcloud a livello di release alpha o beta, consulta la sezione Gestione dei componenti dell'interfaccia a riga di comando gcloud.

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 x86_64 per 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 uno dei seguenti elementi:
    Piattaforma Pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    google-cloud-cli-410.0.0-linux-x86_64.tar.gz 163,8 MB de3525b315d7ea3c3696eba466ddd97313ccad45f6f684bcdd9224374baa6c08
    Linux a 64 bit

    (ARM)

    google-cloud-cli-410.0.0-linux-arm.tar.gz 95,7 MB ce382528da5f5d5daf84f63ec4289ed60069e78f0cd8d9fa11c46ae5993854ea
    Linux a 32 bit

    (x86)

    google-cloud-cli-410.0.0-linux-x86.tar.gz 96,7 MB 3296b9b31ad570da97e75220c8bb4257ed01df89c1519db520f401b913565033

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-410.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-410.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-410.0.0-linux-x86.tar.gz
  3. Estrai i contenuti del file in qualsiasi posizione del file system (preferibilmente la 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-410.0.0-linux-x86.tar.gz
  4. Aggiungi l'interfaccia a riga di comando gcloud al percorso. Esegui lo script di installazione dalla directory principale della cartella in cui hai estratto il file 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 impostando le preferenze come flag. Per visualizzare i flag disponibili, esegui:
    ./google-cloud-sdk/install.sh --help
    
    (Facoltativo) Per inviare statistiche sull'utilizzo anonime per migliorare l'interfaccia a riga di comando gcloud, rispondi Y quando richiesto.
    Per aggiungere l'interfaccia a riga di comando gcloud a PATH e abilitare il completamento dei comandi, rispondi Y quando richiesto.
  5. Apri un nuovo terminale in modo che le modifiche vengano applicate.
  6. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init:
  7. ./google-cloud-sdk/bin/gcloud init
    
  8. Facoltativi. Installa i componenti aggiuntivi utilizzando il gestore dei componenti.
Debian/Ubuntu

Contenuto 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 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 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 per utenti che hanno effettuato l'accesso, 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 aggiornamenti più recenti 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 altre opzioni apt-get, come la disattivazione dei messaggi o delle prove, fai riferimento alle pagine man di apt-get.

    Suggerimento di Docker: se installi l'interfaccia a riga di comando gcloud in 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 o più 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-datalab
    • 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 delle versioni dell'interfaccia a riga di comando gcloud

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

Cappello rosso/Fedora/CentOS

Contenuto della confezione

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

Installazione
  1. Aggiorna DNF con le informazioni del repository dell'interfaccia a riga di comando gcloud. Il seguente comando di esempio è relativo a 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 per 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 o più dei componenti aggiuntivi seguenti:
    • 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-datalab
    • 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 delle versioni 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 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 scoprire di più 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-410.0.0-darwin-x86_64.tar.gz 98,9 MB 26db63460c7f71c7154c753fcb01030d1a509a3fade20f7ab0241f74e7986ec3
    macOS a 64 bit

    (ARM64, Apple M1 silicon)

    google-cloud-cli-410.0.0-darwin-arm.tar.gz 97,3 MB 331b6a1f48c8e76f1a0ebfc25b290a944af9f3dae42a22704b297fc496518375
    macOS a 32 bit

    (x86)

    google-cloud-cli-410.0.0-darwin-x86.tar.gz 109,9 MB 2902809e78407fd5a5b9ba60ab20a5d5e54e54587b2ef1a42097d86eadff7ba3
    1. Estrai l'archivio in una posizione qualsiasi sul tuo file system (preferibilmente la tua directory Home). Su macOS, puoi ottenere questo risultato aprendo il file di archivio .tar.gz 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 dell'interfaccia a riga di comando gcloud a PATH.Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche di utilizzo e installare Python 3.7.

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

      ./google-cloud-sdk/install.sh
      
      L'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 attiva:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      Apri un nuovo terminale in modo che le modifiche vengano applicate.
    3. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Facoltativi. Installa i componenti aggiuntivi utilizzando il gestore dei componenti.
Windows
    Google Cloud CLI funziona su Windows 8.1 e versioni successive e su Windows Server 2012 e versioni successive.
  1. Scarica il programma di installazione dell'interfaccia a riga di comando di Google Cloud.

    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 la modalità screen reader. Questa opzione configura gcloud in modo che utilizzi tracker di stato invece di spinner Unicode, visualizza l'avanzamento in percentuale e appiatti 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 è integrata 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 bundle Python. Consulta la pagina gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.

  4. Al termine dell'installazione, il programma di installazione ti consente di creare menu Start e scorciatoie sul desktop, avviare la shell di Google Cloud CLI e configurare l'interfaccia a riga di comando gcloud. 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. 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 a causa del mancato riconoscimento del comando find, assicurati che la variabile di ambiente PATH sia impostata per includere la cartella contenente find. Di solito, questo è C:\WINDOWS\system32;.
  • Se hai disinstallato l'interfaccia a riga di comando gcloud, devi riavviare il sistema prima di installare di nuovo l'interfaccia a riga di comando gcloud.
  • Se la decompressione non riesce, esegui il programma di installazione come amministratore.

Altre opzioni di installazione

A seconda delle tue esigenze di sviluppo, invece di utilizzare l'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/il deployment continui? 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 di gcloud CLI per l'ultima release (o una versione specifica) di gcloud CLI.
  • Vuoi eseguire Ubuntu e preferisci gli aggiornamenti automatici? Usa un snap package 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 l'ultima release dell'interfaccia a riga di comando gcloud.

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. 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 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 seguendo le istruzioni riportate in precedenza in questa pagina e 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 Create.

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