Installa Google Cloud CLI

Questa guida rapida descrive il metodo consigliato per installare e inizializzare Google Cloud CLI. Dopo l'inizializzazione, esegui alcuni comandi principali di gcloud CLI per visualizzare le informazioni sull'installazione e verificare che sia andata a buon fine.

Prima di iniziare

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI versione 590.0.0

Linux
  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python dalla versione 3.10 alla 3.15. Il pacchetto Linux x86_64 include un interprete Python integrato che verrà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta la documentazione di gcloud topic startup.
  2. Scarica uno dei seguenti file:
    Piattaforma Nome pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    google-cloud-cli-linux-x86_64.tar.gz 94,0 MB 351ed4a2812c5525c1cee00334257a42c020fcaffa27d3067c1eec0a618dd83f
    Linux a 64 bit

    (Arm)

    google-cloud-cli-linux-arm.tar.gz 54,4 MB dc3ad610faefe6f9d2e4472affe1db71836315f43ab3a3747221eb7595b431cb
    Linux a 32 bit

    (x86)

    google-cloud-cli-linux-x86.tar.gz 54,4 MB 704d32be816d1aef1250721e52fc2d9e0802eab6eac513aef97db4c7ace19b2b

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

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

    Consulta la tabella precedente 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, esegui questo comando:
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
    Per sostituire un'installazione esistente, elimina la directory google-cloud-sdk esistente, quindi estrai l'archivio nella stessa posizione.
  4. Esegui lo script di installazione dalla directory principale della cartella che hai estratto:
    ./google-cloud-sdk/install.sh
    Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi Y quando richiesto.
    • Aggiungi gcloud CLI al tuo PATH.
    • Abilita il completamento dei comandi.
    • Attiva l'invio di statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI.
    Puoi anche eseguire l'installazione in modo non interattivo fornendo i flag. Per visualizzare i flag disponibili, esegui:
    ./google-cloud-sdk/install.sh --help
  5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale per applicare le modifiche.
Debian/Ubuntu

Contenuto della confezione

gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi Debian e Ubuntu. Questo pacchetto contiene solo gli strumenti a riga di comando 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 gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

  • È una release di Ubuntu che non ha raggiunto la fine del ciclo di vita o una release stabile di Debian che non ha raggiunto la fine del ciclo di vita.
  • Di recente ha aggiornato i suoi pacchetti. Per farlo ora, esegui questo comando:
    sudo apt-get update
  • Ha installato ca-certificates, gnupg e curl. Per installare questi pacchetti, esegui il seguente comando:
    sudo apt-get install ca-certificates gnupg curl

Installazione

  1. Importa la chiave pubblica Google Cloud .
    • Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), 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 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 aggiornamenti più recenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.

  2. Aggiungi l'URI di distribuzione di gcloud CLI come origine del pacchetto.
    • Per le distribuzioni più recenti (Debian 9 o versioni successive oppure Ubuntu 18.04 o 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 precedenti che non supportano l'opzione signed-by, esegui questo 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 ulteriori opzioni di apt-get, ad esempio la disattivazione dei prompt o i dry run, consulta le pagine del manuale di apt-get.

    Suggerimento per Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza un unico 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 | 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 meno recenti 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-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-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-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-tools
    • 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

Esegui il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud 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 versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

Red Hat/Fedora/CentOS

Contenuto della confezione

gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi Red Hat Enterprise Linux 7, 8, 9 e 10; Fedora 41 e 42; 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 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 sul repository di gcloud CLI.
    • Il seguente comando di esempio è per le installazioni compatibili con Red Hat Enterprise Linux 7, 8 o 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
    • Per le installazioni compatibili con RHEL 10, utilizza il seguente comando con gpgkey aggiornato:

      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-el10-x86_64
      enabled=1
      gpgcheck=1
      repo_gpgcheck=0
      gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
      EOM
    • Per le installazioni ARM64 (aarch64), utilizza https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (compatibile con RHEL 7, 8 o 9) o https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (compatibile con RHEL 10) come valore baseurl.

  2. 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-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-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-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, per installare il componente google-cloud-cli-app-engine-java, esegui questo comando:

    sudo dnf install google-cloud-cli-app-engine-java

Esegui il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, esegui questo comando. Sostituisci 123.0.0 con la versione che vuoi installare:

sudo dnf downgrade google-cloud-cli-123.0.0

Le versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

macOS
  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python dalla versione 3.10 alla 3.15.

    Per controllare la versione di Python, esegui python3 -V o python -V.

    Per impostazione predefinita, il programma di installazione di gcloud installerà Python v3.14 e i moduli di estensione richiesti.

    Per saperne di più sulla configurazione dell'interprete Python, consulta la documentazione di gcloud topic startup.

  2. Scarica uno dei seguenti file:
    Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit

    (x86_64)

    google-cloud-cli-darwin-x86_64.tar.gz 54,5 MB 9ff4e7c7fa49eca2e61af3d6ba31735ed08f90e5fae503d19d4c1c520f818736
    macOS a 64 bit

    (ARM64, Apple silicon)

    google-cloud-cli-darwin-arm.tar.gz 54,4 MB b1f80ffe9cc970ff1935b4adfddd0fb89d7e7b3341a88d70216d4283211b8d2d
    macOS a 32 bit

    (x86)

    google-cloud-cli-darwin-x86.tar.gz 52,9 MB b2da028700b7af4ebc2364fc59398921a3c2d67f91fe63d3a7a42648a54eb6ab

    In alternativa, puoi scaricare l'archivio dalla riga di comando. Sostituisci FILE_NAME con il nome del pacchetto per la tua piattaforma indicato nella tabella precedente.

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
  3. Estrai i contenuti del file nella posizione che preferisci nel file system. Una pratica comune è estrarlo nella directory home.

    Su macOS, puoi farlo aprendo il file .tar.gz scaricato nella posizione che preferisci. In alternativa, dalla riga di comando, esegui:

    tar -xf FILE_NAME

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

  4. Esegui lo script di installazione dalla directory principale della cartella che hai estratto:
    ./google-cloud-sdk/install.sh
    Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi Y quando richiesto.
    • Se necessario, installa Python 3.14 e i moduli consigliati.
    • Aggiungi gcloud CLI alla tua PATH e abilita il completamento dei comandi.
    • Attiva l'invio di statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI.
    Puoi anche eseguire l'installazione in modo non interattivo fornendo i flag. Per visualizzare 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
  5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale per applicare le modifiche.
Windows

Google Cloud CLI su Windows richiede Windows 8.1 e versioni successive o 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. 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é gli spinner Unicode, visualizzi l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta la guida alle funzioni di accessibilità.
    • Google Cloud CLI richiede Python; le versioni supportate sono Python dalla 3.10 alla 3.15. Per impostazione predefinita, la versione per Windows di Google Cloud CLI è integrata con 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 di Python richiesta. Sebbene Google Cloud CLI installi e gestisca Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione Python esistente deselezionando l'opzione per l'installazione di Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.
  3. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e collegamenti sul desktop e di avviare la shell di Google Cloud CLI. Deseleziona l'opzione per avviare la shell. Eseguirai e configurerai gcloud CLI nei passaggi successivi.

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. In genere, si tratta di C:\WINDOWS\system32;.
  • Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installarla di nuovo.
  • Se la decompressione non va a buon fine, esegui il programma di installazione come amministratore.
Chromebook
  1. Configura l'ambiente di sviluppo Linux su Chromebook.
  2. Aggiungi l'URI di distribuzione di gcloud CLI come origine del pacchetto. 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
  3. Importa la chiave pubblica Google Cloud :
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
  4. Aggiorna e installa gcloud CLI:
    sudo apt-get update && sudo apt-get install google-cloud-cli
  5. (Facoltativo) Installa uno dei seguenti componenti aggiuntivi:
    • 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-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-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, per installare il componente google-cloud-cli-app-engine-java, esegui questo comando:

    sudo apt-get install google-cloud-cli-app-engine-java

Esegui il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, esegui questo comando. Sostituisci 123.0.0 con la versione che vuoi installare:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Le versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

Inizializza e autorizza gcloud CLI

Se utilizzi un proxy o un firewall, consulta Configurazione del proxy per abilitare l'accesso di rete per gcloud CLI.

Dopo aver installato gcloud CLI, inizializzala per autorizzare l'accesso a Google Cloud e configurare una configurazione predefinita. Per saperne di più, consulta gcloud init.

  1. Esegui gcloud init per inizializzare gcloud CLI:

    gcloud init
    

    Per impostazione predefinita, questo comando apre un browser web per autorizzare l'accesso. Per eseguire l'autorizzazione dalla riga di comando, aggiungi il flag --console-only. Per l'autorizzazione non interattiva, crea un service account con gli ambiti appropriati nella consoleGoogle Cloud , quindi utilizza gcloud auth activate-service-account con il relativo file della chiave JSON.

  2. Segui le istruzioni per autorizzare e configurare:

    • Quando ti viene chiesto di accedere, accetta e accedi al tuo Account Google nel browser. Fai clic su Consenti per concedere l'autorizzazione ad accedere alle risorse.

    • Dall'elenco dei progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore, seleziona un progetto. Se hai un solo progetto, gcloud init lo seleziona per te.

      Se hai più di 200 progetti, ti viene chiesto di inserire un ID progetto, creare un progetto o elencare i progetti. Se scegli di creare un progetto, devi anche abilitare la fatturazione.

    • Se hai abilitato l'API Compute Engine, seleziona una zona Compute Engine predefinita.

  3. (Facoltativo) Per un'esperienza di screen reader migliorata, attiva la proprietà accessibility/screen_reader con il seguente comando:

    gcloud config set accessibility/screen_reader true
    

    Per saperne di più, consulta la guida Attivazione delle funzioni di accessibilità.

Esegui i comandi principali

Esegui i comandi principali per visualizzare le informazioni sull'installazione di gcloud CLI:

  1. Elenca gli account le cui credenziali sono archiviate nel sistema locale:

    gcloud auth list
    

    gcloud CLI visualizza un elenco di account con credenziali:

    Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@example.com
                       example-user-2@example.com
    

  2. Elenca le proprietà della configurazione dell'interfaccia a riga di comando gcloud attiva:

    gcloud config list
    

    gcloud CLI visualizza l'elenco delle proprietà:

    [core]
    account = example-user-1@example.com
    disable_usage_reporting = False
    project = example-project
    

  3. Visualizza le informazioni sui comandi gcloud e altri argomenti:

    gcloud help
    

    Ad esempio, per visualizzare la guida di gcloud compute instances create:

    gcloud help compute instances create
    

    gcloud CLI visualizza un argomento della guida che contiene una descrizione del comando, un elenco di flag e argomenti del comando ed esempi di come utilizzare il comando.

(Facoltativo) Installa i componenti aggiuntivi

Per installare componenti aggiuntivi, come gli emulatori App Engine, kubectl o i comandi gcloud CLI a livello di release alpha o beta, consulta Gestione dei componenti gcloud CLI.

Passaggi successivi

  • Leggi la guida di gcloud CLI per una panoramica di gcloud CLI, tra cui una rapida introduzione ai concetti chiave, alle convenzioni dei comandi e ai suggerimenti utili.
  • Leggi la guida di riferimento di gcloud CLI per pagine dettagliate su ogni comando gcloud CLI, incluse descrizioni, flag ed esempi, che puoi utilizzare per eseguire una serie di attività su Google Cloud.
  • Consulta la scheda di riferimento di gcloud CLI per un elenco di comandi di uso comune e concetti chiave.