Installa Google Cloud CLI

Installa Google Cloud CLI

Questa guida rapida ti illustra l'installazione e l'inizializzazione di Google Cloud CLI e l'esecuzione di alcuni comandi principali di gcloud CLI.

---

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

Procedura guidata

---

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

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

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

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

Make sure that billing is enabled for your Google Cloud project.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la sezione Pulizia.

Installazione dell'ultima versione di gcloud CLI (530.0.0)

Nota: se utilizzi un proxy/firewall, consulta la pagina Impostazioni proxy per ulteriori informazioni sull'installazione.

Linux

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-3.13. Tieni presente che 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, vedi gcloud topic startup.
2. Scarica uno dei seguenti elementi:
   Nota: per determinare la tua piattaforma Linux, esegui uname -a nella riga di comando.

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	149,7 MB	1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	56,3 MB	e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	56,3 MB	09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

   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 riportata sopra 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 (preferibilmente nella home directory), esegui questo comando:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   (Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
4. (Facoltativo) Aggiungi gcloud CLI al tuo PATH. Puoi anche attivare il completamento dei comandi per la shell e la raccolta delle statistiche di utilizzo. Esegui lo script di installazione (dalla radice della cartella che hai estratto nell'ultimo passaggio) utilizzando questo comando:

   ./google-cloud-sdk/install.sh

   Questa operazione può essere eseguita anche in modo non interattivo (ad esempio utilizzando uno script) e fornendo le preferenze come flag. Per visualizzare i flag disponibili, esegui:

   ./google-cloud-sdk/install.sh --help

   • Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI, rispondi Y quando ti viene richiesto.
   • Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando ti viene chiesto.
5. Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
6. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

7. (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore di componenti.

Debian/Ubuntu

Nota: a seconda della configurazione, puoi scegliere altri metodi di installazione:

• Se vuoi che gcloud si aggiorni automaticamente all'ultima versione e utilizzi una versione moderna di Ubuntu che utilizza Snap Package Manager, puoi installare Google Cloud CLI come pacchetto snap.
• Se utilizzi un'istanza su Compute Engine, gcloud CLI è installata per impostazione predefinita su una serie di immagini del sistema operativo. Per un elenco completo, vedi Dettagli del sistema operativo.

Contenuti del pacchetto

gcloud CLI è 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 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:

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

  sudo apt-get update

• Ha installato apt-transport-https e curl:

  sudo apt-get install apt-transport-https 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 comando seguente:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • Per le distribuzioni precedenti, 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 il seguente 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 dell'interfaccia a riga di comando gcloud come origine pacchetto.
   • Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), 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 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

   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

   Per altre opzioni di apt-get, ad esempio la disattivazione dei prompt o delle prove generali, consulta le pagine di 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 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:
   • 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-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

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

Le dieci versioni più recenti sono sempre disponibili nel repository.

NOTA: per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Red Hat/Fedora/CentOS

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, consulta Dettagli del sistema operativo.

Contenuti del pacchetto

gcloud CLI è disponibile in formato pacchetto per l'installazione su Red Hat Enterprise Linux 7, 8 e 9; 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 App Engine richieste per 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. Il seguente comando di esempio è per un'installazione compatibile con Red Hat Enterprise Linux 9, ma assicurati di aggiornare le impostazioni in base alle tue esigenze di 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

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 non hai eseguito la migrazione a dnf sul tuo sistema, puoi eseguire questi comandi utilizzando yum.

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

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

Eseguire il downgrade delle versioni della gcloud CLI

Se vuoi ripristinare una versione specifica della gcloud CLI, dove VERSION è nel formato 123.0.0, esegui: sudo dnf downgrade google-cloud-cli-VERSION Nel repository saranno sempre disponibili le dieci versioni più recenti. NOTA: per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

macOS

1. Verifica di avere una versione supportata di Python:
   • Per controllare la versione attuale di Python, esegui python3 -V o python -V. Le versioni supportate sono Python 3.9-3.13.
   • Lo script di installazione principale offre l'installazione di Python 3.12 di CPython.
     • Per installare Python sono necessari gli strumenti a riga di comando Xcode.
     • Verifica che Xcode Command Line Tools sia installato eseguendo: xcode-select -p.
     • Se Xcode Command Line Tools non è installato, installalo eseguendo: sudo xcode-select --install.
   • In caso contrario, per installare una versione di Python supportata, visita la pagina Python Releases for macOS su Python.org.
   • Se sulla tua macchina sono installati più interpreti Python, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che punti al percorso dell'interprete che preferisci.
   • Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
2. Scarica uno dei seguenti elementi:
   Nota: per determinare il nome dell'hardware della macchina, 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	56,4 MB	0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
macOS a 64 bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,4 MB	80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	54,9 MB	53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a

3. Estrai l'archivio in una posizione qualsiasi del file system (preferibilmente nella directory Home). Su macOS, puoi farlo aprendo il file .tar.gz archivio scaricato nella posizione che preferisci. In alternativa, esegui questo comando:

   tar -xf google-cloud-cli-darwin-arm.tar.gz

   (Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.

4. Esegui lo script di installazione (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando il seguente comando:

   ./google-cloud-sdk/install.sh

   Lo script ti chiederà di installare Python 3.12 e alcuni moduli consigliati.

   L'installazione può essere eseguita anche in modo non interattivo (ad esempio, utilizzando uno script) fornendo 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

   (Facoltativo)
   • Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI, rispondi Y quando ti viene richiesto.
   • Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando ti viene chiesto.
5. Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
6. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

7. Facoltativo. Installa componenti aggiuntivi utilizzando il gestore di componenti.

Windows

Google Cloud CLI funziona su Windows 8.1 e versioni successive e 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 la Guida alle funzionalità di accessibilità.

3. Google Cloud CLI richiede Python; le versioni supportate sono Python 3.9-3.13. Per impostazione predefinita, la versione Windows di Google Cloud CLI viene fornita in bundle 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. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare un'installazione di Python esistente, se necessario, deselezionando l'opzione Installa Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.

4. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop, avviare la shell Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare selezionate le opzioni per avviare la shell e configurare l'installazione. Il programma di installazione avvia una finestra del terminale ed esegue il comando gcloud init.

5. L'installazione predefinita non include le estensioni App Engine necessarie per il deployment di un'applicazione utilizzando i comandi gcloud. Questi componenti possono essere installati utilizzando il gestore di componenti gcloud CLI.

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. Attiva la funzionalità Linux su Chromebook. L'installazione di Google Cloud CLI su Chromebook richiede questa funzionalità.
2. Aggiungi l'URI di distribuzione di gcloud CLI come origine pacchetto:

   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 Google Cloud chiave pubblica:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

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
   • 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, il componente google-cloud-cli-app-engine-java può essere installato come segue:

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

6. Esegui gcloud init per iniziare:

   gcloud init

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

Le dieci versioni più recenti sono sempre disponibili nel repository.

NOTA: per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

(Facoltativo) Installa le librerie client Cloud più recenti

Puoi scaricare le librerie client di Cloud per i linguaggi supportati.

Inizializzazione di gcloud CLI

Utilizza il comando gcloud init per eseguire diverse attività di configurazione comuni di gcloud CLI. Questi includono l'autorizzazione di gcloud CLI ad accedere a Google Cloud utilizzando le credenziali del tuo account utente e la configurazione predefinita.

1. Inizializza gcloud CLI:

   gcloud init
   

   Nota: per impedire al comando di avviare un browser web, utilizza gcloud init --console-only. Per autorizzare senza un browser web e in modo non interattivo, crea un account di servizio con gli ambiti appropriati utilizzando la consoleGoogle Cloud e utilizza gcloud auth activate-service-account con il file della chiave JSON corrispondente.

2. Accetta l'opzione di accesso con il tuo account utente Google:

   To continue, you must log in. Would you like to log in (Y/n)? Y
   

3. Nel browser, accedi al tuo account utente Google quando richiesto e fai clic su Consenti per concedere l'autorizzazione ad accedere alle risorse Google Cloud .

4. Al prompt dei comandi, seleziona un progetto Google Cloud dall'elenco di progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore:

   Pick cloud project to use:
    [1] [my-project-1]
    [2] [my-project-2]
    ...
    Please enter your numeric choice:
   

   Se hai un solo progetto, gcloud init lo seleziona automaticamente.

   Se hai accesso a più di 200 progetti, ti verrà chiesto di inserire un ID progetto, creare un nuovo progetto o elencare i progetti.

   This account has a lot of projects! Listing them all can take a while.
    [1] Enter a project ID
    [2] Create a new project
    [3] List projects
   Please enter your numeric choice:
   

   Nota: se scegli di creare un progetto, dovrai anche abilitare la fatturazione nel progetto per utilizzare i servizi Google Cloud .

5. Se hai abilitato l'API Compute Engine, gcloud init ti consente di scegliere una zona di Compute Engine predefinita:

   Which compute zone would you like to use as project default?
    [1] [asia-east1-a]
    [2] [asia-east1-b]
    ...
    [14] Do not use default zone
    Please enter your numeric choice:
   

   gcloud init conferma che hai completato correttamente i passaggi di configurazione:

   Run `gcloud help config` to learn how to change individual settings
   
   This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
   Run `gcloud topic configurations` to learn more.
   
   Some things to try next:
   
   * Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
   * Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
   * Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.
   

6. (Facoltativo) Per migliorare l'esperienza con lo screen reader, attiva la proprietà accessibility/screen_reader:

   gcloud config set accessibility/screen_reader true
   

   Per maggiori dettagli sulle funzionalità di accessibilità incluse in gcloud CLI, consulta la guida Attivare le funzionalità di accessibilità.

Esecuzione dei 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 sull'installazione di gcloud CLI e sulla configurazione attiva:

   gcloud info
   

   gcloud CLI mostra un riepilogo delle informazioni sull'installazione. Sono incluse informazioni sul sistema, sui componenti installati, sull'account utente attivo e sul progetto corrente e sulle proprietà nella configurazione attiva.

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

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini, elimini anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

• Leggi la guida di gcloud CLI per una panoramica dell'interfaccia a riga di comando gcloud, inclusa una rapida introduzione ai concetti chiave, alle convenzioni dei comandi e a suggerimenti utili.
• Consulta 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.
• Installa componenti aggiuntivi come gli emulatori App Engine o kubectl utilizzando il gestore di componenti gcloud CLI.