Installa Google Cloud CLI

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 dell'interfaccia a riga di comando gcloud CLI per visualizzare le 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

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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI versione 589.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 elementi:
   Nota:per determinare la tua piattaforma Linux, esegui uname -a dalla riga di comando.

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	93,5 MB	817026aec0adea0e2ee8ed3a1ba3eabfe9e5177581fbe16595a8fe495a601300
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	54,1 MB	c7b9abef0649e0fccc70bf2aaaa031a0aa6202863e45fabe938698dc93d4934c
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	54,1 MB	69f2e18bd0e706a6b31d005381bdf6b17ede01bcf6ce1804a42e2e7cef09bd9c

   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 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.

Disponibilità delle versioni dei pacchetti:le versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

Nota:per configurazioni specifiche, sono disponibili metodi di installazione alternativi:

• Se utilizzi una versione moderna di Ubuntu con Snap Package Manager e vuoi aggiornamenti automatici, puoi installare Google Cloud CLI come pacchetto Snap.
• Se utilizzi un'istanza Compute Engine, gcloud CLI potrebbe essere già installata. Per un elenco delle immagini del sistema operativo che includono la CLI per impostazione predefinita, vedi Dettagli del sistema operativo.

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 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 ultimi aggiornamenti a causa di una chiave scaduta, ottieni l'ultimo file della chiave apt-get.gpg.

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

   Nota: assicurati di non avere voci duplicate per il repository cloud-sdk in /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

   Nota:se l'installazione viene eseguita in macchine virtuali, immagini container o runner CI/CD automatizzati con risorse limitate, puoi esportare la variabile di ambiente CLOUDSDK_SKIP_PY_COMPILATION=1 durante l'installazione per ignorare la compilazione Python lato host. In questo modo, il tempo di installazione del pacchetto si riduce da minuti a secondi:

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli

   L'impostazione di questa variabile ignora la compilazione dei byte durante l'installazione, scambiando una certa velocità di configurazione del pacchetto con un overhead di esecuzione dei comandi interattivi minore.
   Per ulteriori 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 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-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-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 Red Hat Enterprise Linux 7, 8, 9 e 10; Fedora 41 e 42; e sistemi 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.

Disponibilità delle versioni dei pacchetti:le versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

Nota:se utilizzi un'istanza su Compute Engine, Google Cloud CLI è installata per impostazione predefinita su una serie di immagini del sistema operativo. Per un elenco completo, vedi Dettagli del sistema operativo.

Installazione

1. Aggiorna DNF con le informazioni sul repository 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

   Nota: se l'installazione avviene in macchine virtuali, immagini container o runner CI/CD automatizzati con risorse limitate, puoi esportare la variabile di ambiente CLOUDSDK_SKIP_PY_COMPILATION=1 durante l'installazione per saltare la compilazione Python lato host. In questo modo, il tempo di installazione del pacchetto si riduce da minuti a secondi:

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli

   L'impostazione di questa variabile salta la compilazione dei byte durante l'installazione, sacrificando un po' di velocità di configurazione del pacchetto per un sovraccarico minore di esecuzione dei comandi interattivi.
   Nota: se non hai eseguito il passaggio a dnf sul tuo sistema, puoi eseguire questi comandi utilizzando yum.

   Puoi anche utilizzare le opzioni dnf/yum, ad esempio disattivare i prompt o i dry run, con i comandi forniti.

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-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-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

Eseguire 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 3.10-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:
   Nota: per determinare la tua piattaforma, esegui uname -m da una riga di comando.

   Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
   macOS a 64 bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	54,3 MB	b49e8cb9d348267d46fade7b9c916a1aed7ce0ec07e142ce41cc0d24a95a9651
   macOS a 64 bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	54,2 MB	71b37ca07ab0f9bc43898e42c913e10f143166230ab31e0bbea3632dbc77b010
   macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	52,6 MB	bc9d328fbf56f650b57d9a70eb267993c98d0a9cbd15864b0b8fee949ea1039f

   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 nel tuo file system. È prassi comune estrarlo nella directory principale.

   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 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.14 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 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 di 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-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-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 Google Cloud console, 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 migliore 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 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 mostra un elenco di account con credenziali:

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  [e-mail]
                      [e-mail]
   

2. 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 = [e-mail]
   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) 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

• Leggi la guida di gcloud CLI per una panoramica di gcloud CLI, inclusa una rapida introduzione a concetti chiave, convenzioni dei comandi e 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.