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 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:
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.
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.createpermission. Learn how to grant roles.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- Verifica di avere una versione supportata di Python. Google Cloud CLI richiede
Python 3.9-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
gcloud topic startup. - 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 202,9 MB 71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a Linux a 64 bit (Arm)
google-cloud-cli-linux-arm.tar.gz 57,7 MB 001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3 Linux a 32 bit (x86)
google-cloud-cli-linux-x86.tar.gz 57,8 MB 921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc 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.gzche si applica alla tua configurazione. - Per estrarre i contenuti del file nel file system, esegui questo comando:
Per sostituire un'installazione esistente, elimina la directorytar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdkesistente ed estrai l'archivio nella stessa posizione. - Esegui lo script di installazione dalla radice della cartella che hai estratto:
Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi./google-cloud-sdk/install.sh
Yquando 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.
./google-cloud-sdk/install.sh --help - Aggiungi gcloud CLI al tuo
- (Facoltativo) Se hai aggiornato
PATHnel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate. - 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
apt-transport-https,ca-certificates,gnupgecurl. Per installare questi pacchetti, esegui il seguente comando:sudo apt-get install apt-transport-https ca-certificates gnupg curl
- 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 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.
- 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 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
- Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), esegui il seguente comando:
- Aggiorna e installa gcloud CLI:
Per altre opzioni disudo apt-get update && sudo apt-get install google-cloud-cli
apt-get, ad esempio la disattivazione dei prompt o delle prove generali, consulta le pagine del manuale diapt-get.Suggerimento per Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza un singolo passaggio RUN:
Per le immagini di base precedenti che non supportano il comandoRUN 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
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
- (Facoltativo) Installa uno dei seguenti
componenti aggiuntivi:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
Ad esempio, il componente
google-cloud-cli-app-engine-javapuò essere installato come segue:sudo apt-get install google-cloud-cli-app-engine-java
- Aggiorna DNF con le informazioni sul repository gcloud CLI.
-
Il seguente comando di esempio è per 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
gpgkeyaggiornato: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
-
-
Installa
libxcrypt-compat.x86_64.sudo dnf install libxcrypt-compat.x86_64
- Installa gcloud CLI:
sudo dnf install google-cloud-cli
- (Facoltativo) Installa uno dei seguenti
componenti aggiuntivi:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
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
- Verifica di avere una versione supportata di Python. Google Cloud CLI richiede
Python 3.9-3.14.
Per controllare la versione di Python, esegui
python3 -Vopython -V.Se necessario, lo script di installazione può installare Python. Per farlo sono necessari gli strumenti a riga di comando Xcode. Per installarli, esegui
sudo xcode-select --install. In alternativa, puoi installare una versione di Python supportata da python.org.Per ulteriori informazioni sulla configurazione dell'interprete Python, soprattutto se hai installato più versioni, consulta la documentazione
gcloud topic startup. -
Scarica uno dei seguenti elementi:
Piattaforma Pacchetto Dimensioni Checksum SHA256 macOS a 64 bit (x86_64)
google-cloud-cli-darwin-x86_64.tar.gz 57,9 MB 6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8 macOS a 64 bit (ARM64, Apple silicon)
google-cloud-cli-darwin-arm.tar.gz 57,8 MB 36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339 macOS a 32 bit (x86)
google-cloud-cli-darwin-x86.tar.gz 56,3 MB eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56 In alternativa, puoi scaricare l'archivio dalla riga di comando. Sostituisci
FILE_NAMEcon il nome del pacchetto per la tua piattaforma dalla tabella precedente.curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
- Estrai i contenuti del file nella posizione che preferisci nel tuo file
system. È prassi comune estrarlo nella directory home.
Su macOS, puoi farlo aprendo il file
.tar.gzscaricato 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-sdkesistente ed estrai l'archivio nella stessa posizione. - Esegui lo script di installazione dalla radice della cartella che hai estratto:
Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi./google-cloud-sdk/install.sh
Yquando richiesto.- Se necessario, installa Python 3.13 e i moduli consigliati.
- Aggiungi gcloud CLI a
PATHe attiva il completamento dei comandi. - Attiva l'invio di statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI.
Per eseguire lo script di installazione con la modalità screen reader attivata:./google-cloud-sdk/install.sh --help./google-cloud-sdk/install.sh --screen-reader=true
- (Facoltativo) Se hai aggiornato
PATHnel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate. -
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
-
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
gcloudin 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à. - Google Cloud CLI richiede Python; le versioni supportate sono Python 3.9-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 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
Python esistente, se necessario, deselezionando l'opzione per installare Python in bundle.
Consulta
gcloud topic startupper scoprire come utilizzare un'installazione di Python esistente.
- Se utilizzi uno screen reader, seleziona la casella di controllo Attiva la modalità screen reader. Questa
opzione configura
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.
- Se l'installazione non va a buon fine
perché il comando
findnon viene riconosciuto, assicurati che la variabile di ambientePATHsia impostata in modo da includere la cartella contenentefind. In genere, si tratta diC:\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.
- Configura l'ambiente di sviluppo Linux sul tuo Chromebook.
- 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
- Importa la chiave pubblica Google Cloud :
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
- Aggiorna e installa gcloud CLI:
sudo apt-get update && sudo apt-get install google-cloud-cli
- (Facoltativo) Installa uno dei seguenti
componenti aggiuntivi:
google-cloud-cli-anthos-authgoogle-cloud-cli-app-engine-gogoogle-cloud-cli-app-engine-grpcgoogle-cloud-cli-app-engine-javagoogle-cloud-cli-app-engine-pythongoogle-cloud-cli-app-engine-python-extrasgoogle-cloud-cli-bigtable-emulatorgoogle-cloud-cli-cbtgoogle-cloud-cli-cloud-build-localgoogle-cloud-cli-cloud-run-proxygoogle-cloud-cli-config-connectorgoogle-cloud-cli-datastore-emulatorgoogle-cloud-cli-firestore-emulatorgoogle-cloud-cli-gke-gcloud-auth-plugingoogle-cloud-cli-kptgoogle-cloud-cli-kubectl-oidcgoogle-cloud-cli-local-extractgoogle-cloud-cli-minikubegoogle-cloud-cli-nomosgoogle-cloud-cli-pubsub-emulatorgoogle-cloud-cli-skaffoldgoogle-cloud-cli-spanner-emulatorgoogle-cloud-cli-terraform-validatorgoogle-cloud-cli-testskubectl
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
gcloud initper inizializzare gcloud CLI:gcloud initPer 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 utilizzagcloud auth activate-service-accountcon il relativo file della chiave JSON.Segui le istruzioni per autorizzare e configurare:
Quando ti viene chiesto di accedere, accetta e poi accedi al tuo Account Google nel browser. Fai clic su Consenti per concedere l'autorizzazione di accesso alle risorse.
Seleziona un progetto dall'elenco di progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore. Se hai un solo progetto,
gcloud initlo seleziona automaticamente.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.
(Facoltativo) Per un'esperienza migliore con lo screen reader, attiva la proprietà
accessibility/screen_readercon il seguente comando:gcloud config set accessibility/screen_reader truePer saperne di più, consulta la guida Attivare le funzionalità di accessibilità.
Elenca gli account le cui credenziali sono archiviate nel sistema locale:
gcloud auth listgcloud CLI mostra un elenco di account con credenziali:
Credentialed Accounts ACTIVE ACCOUNT * example-user-1@example.com example-user-2@example.comElenca le proprietà della configurazione dell'interfaccia a riga di comando gcloud attiva:
gcloud config listgcloud CLI mostra l'elenco delle proprietà:
[core] account = example-user-1@example.com disable_usage_reporting = False project = example-project
Visualizza informazioni sui comandi
gcloude altri argomenti:gcloud helpAd esempio, per visualizzare la guida per
gcloud compute instances create:gcloud help compute instances creategcloud 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.
- 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 ai 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.
Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.
Installa gcloud CLI versione 548.0.0
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, devi installarli separatamente.
Prima di iniziare
Prima di installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:
Installazione
Eseguire il downgrade delle versioni di 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. Per le versioni precedenti alla 371.0.0,
il nome del pacchetto è google-cloud-sdk
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 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, che possono essere
installate separatamente come descritto più avanti in questa sezione.
Installazione
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
Nel repository sono disponibili le dieci versioni più recenti. Per le versioni precedenti alla 371.0.0, utilizza
google-cloud-sdk come nome del pacchetto.
Google Cloud CLI su Windows richiede Windows 8.1 e versioni successive o Windows Server 2012 e versioni successive.
Suggerimenti per la risoluzione dei problemi
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, consulta Configurazione 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 ulteriori
informazioni, consulta gcloud init.
Esegui i comandi principali
Esegui i comandi principali per visualizzare le informazioni sull'installazione di gcloud CLI:
(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.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.