Questa pagina contiene istruzioni per scegliere e gestire un'installazione di Google Cloud CLI. Google Cloud CLI include gcloud
, gsutil
e bq
a riga di comando. Per un elenco delle funzionalità di gcloud CLI, consulta
Tutte le funzionalità.
Per accedere alle API Google Cloud utilizzando un linguaggio di programmazione, puoi scaricare Librerie client di Cloud.
Istruzioni di installazione
Queste istruzioni riguardano l'installazione di Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, come i comandi dell'interfaccia a riga di comando gcloud a livello di release alpha o beta, consulta Gestire i componenti dell'interfaccia a riga di comando gcloud.
- Verifica di avere una versione di Python supportata. Google Cloud CLI richiede
Python 3.8-3.12. Tieni presente che il pacchetto Linux x86_64 include un interprete Python in bundle che sarà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta
gcloud topic startup
. - Scarica una delle seguenti opzioni:
Piattaforma Nome pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 131,3 MB 5923f2039cea16c411f70c4099822d7e74b2974318cbe041d5ccd8c9697c4ffb Linux a 64 bit (Arm)
google-cloud-cli-linux-arm.tar.gz 53,6 MB c8d9e5893044454c9449d812740188462eb1ab7ab8ea64402321eaed58cc92f3 Linux a 32 bit (x86)
google-cloud-cli-linux-x86.tar.gz 53,6 MB e38086590c06aa3fbe343d98e60954c1a8e1a8d844dc82daf95fc4fff9bc48d7 Per scaricare il file dell'archivio Linux, esegui il seguente 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
applicabile alla tua configurazione. - Per estrarre i contenuti del file nel file system (preferibilmente
nella home directory), esegui questo comando:
(Facoltativo) Per sostituire un'installazione esistente, rimuovi quella esistentetar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdk
ed estrai l'archivio nella directory nella stessa località. - Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla radice della
cartella in cui hai eseguito l'estrazione utilizzando il seguente comando:
Questa operazione può essere eseguita anche in modo non interattivo (ad esempio, utilizzando uno script) e indicando le preferenze. come flag. Per visualizzare i flag disponibili, esegui:./google-cloud-sdk/install.sh
(Facoltativo)./google-cloud-sdk/install.sh --help
- Per inviare statistiche sull'utilizzo anonimizzate.
per contribuire a migliorare gcloud CLI, rispondi
Y
quando richiesto. -
Per aggiungere gcloud CLI a
PATH
e abilitare completamento comando, rispondiY
quando richiesto.
- Per inviare statistiche sull'utilizzo anonimizzate.
per contribuire a migliorare gcloud CLI, rispondi
- Apri un nuovo terminale per applicare le modifiche.
- Per inizializzare l'interfaccia a riga di comando gcloud, esegui
gcloud init
: - (Facoltativo) Installa i componenti aggiuntivi utilizzando Gestione componenti.
./google-cloud-sdk/bin/gcloud init
Contenuti del pacchetto
gcloud CLI è disponibile in formato di 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 installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti 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 propri pacchetti:
sudo apt-get update
- Sono installati
apt-transport-https
ecurl
:sudo apt-get install apt-transport-https ca-certificates gnupg curl
- Importa la chiave pubblica di Google Cloud.
Per le distribuzioni più recenti (Debian 9 o versioni successive o Ubuntu 18.04 o versioni successive), 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 comando 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 le ultime novità apt-get.gpg.
- Aggiungi l'URI di distribuzione della gcloud CLI come origine del pacchetto.
- Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e 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 firmato da, 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
- Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e versioni successive), esegui questo comando:
- Aggiorna e installa gcloud CLI:
Per ulteriori opzioni disudo apt-get update && sudo apt-get install google-cloud-cli
apt-get
, come la disattivazione dei prompt o delle prove, consulta le pagine man diapt-get
.Suggerimento Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza un'interfaccia singolo passaggio RUN:
Per le immagini di base meno recenti 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 | sudo 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 una delle seguenti app
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
- Esegui
gcloud init
per iniziare:gcloud init
Eseguire il downgrade delle versioni dell'interfaccia a riga di comando gcloud
Per ripristinare una versione specifica di gcloud CLI, dove VERSION
è del
formato 123.0.0
, esegui il seguente comando:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
Le dieci release più recenti sono sempre disponibili nel repository.
NOTA: per le release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk
Contenuti del pacchetto
gcloud CLI è disponibile in formato di pacchetto per l'installazione su
Red Hat Enterprise Linux 7, 8 e 9; Fedora 33 e 34; e CentOS 7 e 8.
Questo pacchetto contiene solo i comandi gcloud
, gcloud alpha
, gcloud beta
, gsutil
e bq
. Non include kubectl
o App Engine
necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud
, che possono essere
separatamente, come descritto
più avanti in questa sezione.
- Aggiorna DNF con le informazioni del 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 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
-
Se esegui l'installazione su Fedora 34 o 35, installa
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installa la gcloud CLI:
sudo dnf install google-cloud-cli
- (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
- Esegui
gcloud init
per iniziare:gcloud init
Eseguire il downgrade delle versioni di gcloud CLI
Se vuoi ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, dove VERSION
è del tipo 123.0.0
, esegui:
sudo dnf downgrade google-cloud-cli-VERSION
Le dieci release più recenti saranno sempre disponibili nel repository.
NOTA: per le release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk
-
Verifica di avere una versione di Python supportata:
-
Per controllare la tua versione Python attuale, esegui
python3 -V
opython -V
. Le versioni supportate sono da Python 3.8 a 3.12. - Lo script di installazione principale offre l'installazione di Python 3.11 di CPython.
- In caso contrario, per installare una versione di Python supportata, visita la pagina Uscite di Python per 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 indichi il percorso dell'interprete che preferisci.
-
Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta
gcloud topic startup
.
-
Per controllare la tua versione Python attuale, esegui
- Scarica uno dei seguenti file:
-
Estrai l'archivio in qualsiasi posizione del file system (preferibilmente nella home directory). Su
macOS, puoi farlo aprendo il file dell'archivio
.tar.gz
scaricato nella posizione che preferisci.Per sostituire un'installazione esistente, rimuovi quella esistente
google-cloud-sdk
ed estrai l'archivio nella stessa posizione. -
(Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud a
PATH
. Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche di utilizzo e installare Python 3.11.Esegui lo script (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando questo :
Questa operazione può essere eseguita anche in modo non interattivo, ad esempio utilizzando uno script, indicando le preferenze come flag. Per descrivere i flag disponibili, esegui:./google-cloud-sdk/install.sh
Per eseguire lo script di installazione con la modalità dello screen reader attiva:./google-cloud-sdk/install.sh --help
Apri un nuovo terminale per applicare le modifiche../google-cloud-sdk/install.sh --screen-reader=true
-
Per inizializzare gcloud CLI, esegui
gcloud init
: - Facoltativo. Installa i componenti aggiuntivi utilizzando Gestione componenti.
Piattaforma | Pacchetto | Dimensioni | Checksum SHA256 |
---|---|---|---|
macOS a 64 bit
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 53,6 MB | d5cf5912a84a1ef13417760282ebe9653851dfc71bd5dc76973f776a74ea80c1 |
macOS a 64 bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 53,6 MB | 8bd337c126ad99cb262ff5d427d57e6d6e457ec19fe1c300753fbc5047be8049 |
macOS a 32 bit
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 52,3 MB | c3fc7695bf5ace704d8c9572e1c42aa2b31e04e78971627f08ac4fc5aa007775 |
./google-cloud-sdk/bin/gcloud init
-
Google Cloud CLI funziona su Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive.
-
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. L'installatore è 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 da utilizzare gli indicatori di stato anziché gli spinner Unicode, visualizzare l'avanzamento come percentuale e appiattire le tabelle. Per ulteriori informazioni, consulta la guida alle funzionalità di accessibilità. -
Google Cloud CLI richiede Python; le versioni supportate sono da Python 3.8 a 3.12. Per impostazione predefinita, la versione di Google Cloud CLI per Windows è 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 Python necessaria. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare una libreria Installazione di Python se necessaria, deselezionando l'opzione Installa Python in bundle. Consulta le
gcloud topic startup
per imparerai a utilizzare un'installazione Python esistente. Al termine dell'installazione, il programma di installazione ti dà la possibilità di creare un menu Start e sul desktop, avvia la shell di Google Cloud CLI e con gcloud CLI. Assicurati di lasciare selezionate le opzioni per avviare la shell e configurare l'installazione. Il programma di installazione apre una finestra del terminale ed esegue Comando
gcloud init
.- L'installazione predefinita non include le estensioni di App Engine necessarie per eseguire il deployment di un'istanza
utilizzando i comandi
gcloud
. Questi componenti possono essere installati utilizzando Gestore dei componenti dell'interfaccia a riga di comando gcloud.
- Se l'installazione non va a buon fine
poiché il comando
find
non è stato riconosciuto, verifica chePATH
la variabile di ambiente è impostata per includere la cartella contenentefind
. Di solito, questo èC:\WINDOWS\system32;
. - Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di reinstallarlo.
- Se l'estrazione non va a buon fine, esegui il programma di installazione come amministratore.
Altre opzioni di installazione
A seconda delle tue esigenze di sviluppo, anziché la installazione consigliata, puoi utilizzare un metodo alternativo per installare gcloud CLI:
- Utilizzi gcloud CLI con script o integrazione/deployment continuo? Scarica un archivio con versione per un'installazione non interattiva di una versione specifica di gcloud CLI.
- Devi eseguire gcloud CLI come immagine Docker? Utilizza l'immagine Docker gcloud CLI per la release più recente (o una versione specifica) dell'interfaccia a riga di comando gcloud.
- Utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Utilizza un snap package per installare gcloud CLI.
- Per le installazioni interattive di Windows e macOS e per tutti gli altri casi d'uso, esegui il programma di installazione interattivo per installare la versione più recente dell'interfaccia a riga di comando gcloud.
Gestire un'installazione
Dopo aver installato gcloud CLI, puoi utilizzare i comandi del gruppo di comandi gcloud components
per gestire l'installazione. Ciò include la visualizzazione dei componenti installati, l'aggiunta e la rimozione di componenti, l'upgrade a una nuova versione o il downgrade a una versione specifica dell'interfaccia a riga di comando gcloud.
apt-get
o yum
per installare gcloud CLI,
deve utilizzare apt-get
o yum
per aggiornare o rimuovere componenti, non
gcloud components
.
Versioni precedenti di gcloud CLI
Se hai bisogno di una versione diversa di gcloud CLI, installa la versione corrente utilizzando le istruzioni visualizzate in precedenza in questa pagina e accedi. Dopo aver eseguito l'accesso, puoi scaricare le versioni precedenti. Per vedere le versioni ordinate per data, assicurati di attivare Ordina e filtra e fai clic sulla colonna Created (Creato).
Versioni di Python supportate
Google Cloud CLI richiede Python dalla versione 3.8 alla versione 3.12. Per informazioni
su come scegliere e configurare il tuo interprete Python, vedi
gcloud topic startup
Provalo
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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Inizia gratuitamente