Guida rapida: installa Google Cloud CLI (original) (raw)

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


Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud , fai clic su Procedura guidata:

Procedura guidata


Prima di iniziare

  1. Accedi al tuo account Google Cloud . 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 senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. 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 theresourcemanager.projects.create permission. Learn how to grant roles.
      Go to project selector
  3. Verify that billing is enabled for your Google Cloud project.

  4. 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 theresourcemanager.projects.create permission. Learn how to grant roles.
      Go to project selector
  5. Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI versione 573.0.0

Linux

  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.10-3.14. Il pacchetto Linux x86_64 include un interprete Python in bundle 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 elementi:
    Piattaforma Nome pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit (x86_64) google-cloud-cli-linux-x86_64.tar.gz 87,9 MB 3d6b3c9d45873e0f1d69c48b754e2c35fa729dc3cf10d6c1754b4823f886590d
    Linux a 64 bit (Arm) google-cloud-cli-linux-arm.tar.gz 60,8 MB f9ca605f186ac186e161df191406e72728356bc950535ea0fcfcf74501d5fdad
    Linux a 32 bit (x86) google-cloud-cli-linux-x86.tar.gz 60,8 MB f9e84d6bc95ff92ed021f8b8b99f64b6f4314482fd497f63746c1bb0943d5fc8
    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
    Fai riferimento alla tabella precedente e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto *.tar.gz che si applica 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 directorygoogle-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
  4. Esegui lo script di installazione dalla radice 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.
    • Attiva 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 in modo che le modifiche vengano applicate.

Debian/Ubuntu

Contenuti del pacchetto

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 App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Se vuoi questi componenti, deviinstallarli separatamente.

Prima di iniziare

Prima di installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

Installazione

  1. Importa la chiave pubblica Google Cloud .
  2. Aggiungi l'URI di distribuzione di gcloud CLI come origine pacchetto.
    • Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), 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 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 altre opzioni di apt-get, ad esempio la disattivazione dei prompt o delle prove generali, consulta le pagine del manuale di apt-get.
    Suggerimento per Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza 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 | 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:

Eseguire il downgrade delle versioni della gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, dove VERSION ha la forma 123.0.0, esegui questo comando:

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

Nel repository sono sempre disponibili le dieci release più recenti. Per le release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Red Hat/Fedora/CentOS

Contenuti del pacchetto

gcloud CLI è disponibile in formato pacchetto per l'installazione su Red Hat Enterprise Linux 7, 8, 9 e 10; Fedora 41 e 42; e sistemi CentOS 7 e 8. Questo pacchetto contiene solo i comandigcloud, gcloud alpha, gcloud beta, gsutil ebq. Non include kubectl o le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud, che possono essere installate separatamente come descritto più avanti in questa sezione.

Installazione

  1. Aggiorna DNF con le informazioni sul repository gcloud CLI.
  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 seguenticomponenti 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-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, per installare il componente google-cloud-cli-app-engine-java, esegui il comando seguente:
      sudo dnf install google-cloud-cli-app-engine-java

Eseguire il downgrade delle versioni della gcloud CLI

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

sudo dnf downgrade google-cloud-cli-123.0.0

Nel repository sono disponibili le dieci versioni più recenti. Per le versioni precedenti alla 371.0.0, utilizzagoogle-cloud-sdk come nome del pacchetto.

macOS

  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.10-3.14.
    Per controllare la versione di Python, esegui python3 -V o python -V.
    Il programma di installazione di gcloud installer installerà Python v3.14 e i moduli di estensione richiesti per impostazione predefinita.
    Per ulteriori informazioni sulla configurazione dell'interprete Python, consulta la documentazione di gcloud topic startup.
  2. Scarica uno dei seguenti elementi:
    Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit(x86_64) google-cloud-cli-darwin-x86_64.tar.gz 61 MB 4120743d00e42dfa0ae8609caff99c8bd90264b28ec3b2b70f629eea74c3d6dd
    macOS a 64 bit(ARM64, Apple silicon) google-cloud-cli-darwin-arm.tar.gz 60,9 MB 65582afb4c5f9f020831785978c8a0a158f627224bc3ac4573fae53c414abf00
    macOS a 32 bit(x86) google-cloud-cli-darwin-x86.tar.gz 59,3 MB d3cf00e96d387d2ed3a36462bf12931094700ff213e725d135aeac39fe672eaa
    In alternativa, puoi scaricare l'archivio dalla riga di comando. Sostituisci FILE_NAME con il nome del pacchetto per la tua piattaforma dalla 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 sul file system. Una pratica comune è estrarli 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 directorygoogle-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
  4. Esegui lo script di installazione dalla radice 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.13 e i moduli consigliati.
    • Aggiungi gcloud CLI a PATH e attiva 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 in modo che le modifiche vengano applicate.

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 indicatori di stato anziché spinner Unicode, mostri l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta laguida alle funzionalità di accessibilità.
    • Google Cloud CLI richiede Python; le versioni supportate sono Python 3.10-3.14. Per impostazione predefinita, la versione Windows di Google Cloud CLI viene 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, puoi utilizzare un'installazione Python esistente, se necessario, deselezionando l'opzione Installa Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.
  3. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop e di avviare la shell Google Cloud CLI. Deseleziona l'opzione per avviare la shell. Nei passaggi successivi eseguirai e configurerai gcloud CLI.

Suggerimenti per la risoluzione dei problemi

Chromebook

  1. Configura l'ambiente di sviluppo Linux su Chromebook.
  2. Aggiungi l'URI di distribuzione di gcloud CLI come origine 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-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, per installare il componente google-cloud-cli-app-engine-java, esegui il comando seguente:
      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

Nel repository sono disponibili le dieci versioni più recenti. Per le release precedenti alla 371.0.0, utilizza google-cloud-sdk come nome del pacchetto.

Inizializza e autorizza gcloud CLI

Se utilizzi un proxy o un firewall, consultaConfigurazione del proxy per attivare l'accesso alla 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 autorizzare dalla riga di comando, aggiungi il flag --console-only. Per l'autorizzazione non interattiva,crea un service account con gli ambiti appropriati nella Google Cloud console, quindi utilizza gcloud auth activate-service-accountcon il relativo file della chiave JSON. 2. Segui le istruzioni per autorizzare e configurare:

  1. (Facoltativo) Per un'esperienza migliorata con lo screen reader, attiva la proprietàaccessibility/screen_reader con il seguente comando:
gcloud config set accessibility/screen_reader true  

Per saperne di più, consulta la guidaAttivare le funzionalità 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 mostra un elenco di account con credenziali:
Credentialed Accounts
ACTIVE ACCOUNT

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

gcloud CLI mostra l'elenco delle proprietà:
[core]
account = example-user-1@example.com
disable_usage_reporting = False
project = example-project 3. Visualizza informazioni sui comandi gcloud e altri argomenti:

gcloud help  

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

gcloud help compute instances create  

gcloud CLI mostra 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) Installare 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