Installa l'interfaccia a riga di comando gcloud

Questa pagina contiene le istruzioni per scegliere e gestire un'installazione dell'interfaccia a riga di comando di Google Cloud. 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 Google Cloud utilizzando un linguaggio di programmazione supportato, puoi scaricare le librerie client di Cloud.

Istruzioni di installazione

Queste istruzioni riguardano l'installazione dell'interfaccia a riga di comando di Google Cloud. 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 la sezione Gestione dei componenti dell'interfaccia a riga di comando gcloud.

Linux
  1. Verifica di avere una versione supportata di Python. L'interfaccia a riga di comando di Google Cloud richiede Python 3 (da 3.5 a 3.8, 3.7 consigliato) e Python 2 (2.7.9 o versioni successive). Per informazioni su come scegliere e configurare l'interprete Python, consulta la sezione gcloud topic startup.

    Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.

  2. Scarica uno dei seguenti elementi:
    Piattaforma Pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    google-cloud-cli-392.0.0-linux-x86_64.tar.gz 104,3 MB a7e88856a07ed75cf310ebe5415c922c9b516021a6c7e66b3eb8f2859b9351bc
    Linux a 64 bit

    (braccia)

    google-cloud-cli-392.0.0-linux-arm.tar.gz 101,2 MB 6585b33a56806f95378bdfbd3f5c78f90adca1b50730639e32d674404a7e6c07
    Linux a 32 bit

    (x86)

    google-cloud-cli-392.0.0-linux-x86.tar.gz 102,2 MB 3b466c3cfb3ea3848fec45077c2fd8d926b15724f68709235dd7ade05e051121

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

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

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-392.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-392.0.0-linux-x86.tar.gz
  3. Estrai i contenuti del file in qualsiasi punto del tuo file system (preferibilmente nella tua home directory). Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
    tar -xf google-cloud-cli-392.0.0-linux-x86.tar.gz
  4. (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud al PATH. Puoi anche attivare il completamento dei comandi per la shell e la raccolta delle statistiche di utilizzo.

    Esegui lo script (dalla radice della cartella estratta) utilizzando il seguente comando:

    ./google-cloud-sdk/install.sh
    
    Questa operazione può anche essere eseguita in modo non interattivo (ad esempio utilizzando uno script) e specificando le preferenze come flag. Tali risorse sono descritte in:
    ./google-cloud-sdk/install.sh --help
    
  5. Se vuoi inviare statistiche di utilizzo anonime per migliorare l'interfaccia a riga di comando gcloud, rispondi Y quando richiesto.
  6. Per aggiungere l'interfaccia a riga di comando gcloud al PATH e abilitare il completamento del comando, rispondi Y quando richiesto.
  7. Apri un nuovo terminale in modo che le modifiche abbiano effetto.
  8. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init:
  9. ./google-cloud-sdk/bin/gcloud init
    
  10. (Facoltativo) Installa i componenti aggiuntivi utilizzando il gestore 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 utilizzare 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:

Installazione
  1. Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud come origine pacchetto. Se la tua distribuzione supporta l'opzione firmata, 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 "Firmato", 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
  2. Importa la chiave pubblica di Google Cloud. Se il comando apt-key di Distribution 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 di distribuzione e #39 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 o versioni successive) non supporta apt-key, esegui il seguente comando:

    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 ulteriori opzioni apt-get, ad esempio per disabilitare le richieste o le prove, consulta le pagine dedicate a apt-get.

    Suggerimento Docker: se installi l'interfaccia a riga di comando gcloud all'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 | 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-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, 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 più avanti in questa sezione.

Installazione
  1. Aggiorna DNF con le informazioni del repository dell'interfaccia a riga di comando gcloud. Il comando di esempio riportato di seguito 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 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/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. Se installi 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-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 disporre di una versione supportata di Python:
    • Per controllare la versione corrente del tuo Python, esegui python3 -V o python -V. Le versioni moderne di macOS includono la versione appropriata di Python richiesta per Cloud SDK. Le versioni supportate sono Python 3 (da 3.5 a 3.8, 3.7 consigliate) e Python 2 (2.7.9 o versioni successive).

      Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.

    • Per Cloud SDK 352.0.0 e versioni successive, lo script di installazione principale offre l'installazione di Python 3.7 su 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-392.0.0-darwin-x86_64.tar.gz 104,6 MB 08917f5a269aad838615db8d873e1b2d828649d451753babcadaa8feccf8ebc9
    macOS a 64 bit

    (arm64, silicone per Apple M1)

    google-cloud-cli-392.0.0-darwin-arm.tar.gz 103,3 MB 4a975e2320b87de80b40854e012f61493252f8b9011f11347517cd07558d6328
    macOS a 32 bit

    (x86)

    google-cloud-cli-392.0.0-darwin-x86.tar.gz 107,9 MB 8de8154f4d5aea39cb3b9c2d969340bd0dc78a6c1c91bf5b9f91a4ab16a75010
    1. Estrai l'archivio in qualsiasi punto del file system (preferibilmente la tua home directory). Su macOS, puoi eseguire questa operazione 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 al tuo PATH. Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche sull'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ò anche essere eseguita in modo non interattivo (ad esempio, utilizzando uno script) assegnando 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 in modo che le modifiche abbiano effetto.
    3. Per inizializzare l'interfaccia a riga di comando gcloud, esegui gcloud init:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. (Facoltativo) Installa i componenti aggiuntivi utilizzando il gestore componenti.
Windows
    L'interfaccia a riga di comando di Google Cloud 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 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 in modo che utilizzi tracker di stato anziché 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 (opzione preferita, da 3.5 a 3.8) e Python 2 (2.7.9 o versioni successive). Per impostazione predefinita, la versione Windows di Cloud SDK include bundle Python 3 e Python 2. Per utilizzare Cloud SDK, il tuo sistema operativo deve essere in grado di eseguire una versione supportata di Python.

    Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.

    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 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 menu Start e collegamenti sul desktop, avviare la shell dell'interfaccia a riga di comando di Google Cloud e configurare l'interfaccia a riga di comando gcloud. Assicurati di lasciare le opzioni necessarie per avviare la shell e di configurare l'installazione. Il programma di installazione avvia una finestra di 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 riesce 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, anziché l'installazione consigliata, puoi utilizzare un metodo alternativo per l'installazione dell'interfaccia a riga di comando gcloud:

  • Utilizzi l'interfaccia a riga di comando gcloud con 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 dell'interfaccia a riga di comando gcloud per la release più recente (o una versione specifica) dell'interfaccia a riga di comando gcloud.
  • Se utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Usa un pacchetto di snapshot per installare l'interfaccia a riga di comando gcloud.
  • Per le installazioni interattive di 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 visualizzate 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 l'opzione Ordina e filtra e fai clic sulla colonna Creata.

Versioni di Python supportate

Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.

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