Questa pagina contiene istruzioni per scegliere e gestire un'installazione di Google Cloud CLI. Google Cloud CLI include gli strumenti a riga di comando gcloud
, gsutil
e bq
. Per un elenco delle funzionalità di gcloud CLI, consulta Tutte le funzionalità.
Per accedere alle API Google Cloud utilizzando un linguaggio di programmazione supportato, puoi scaricare le librerie client di Cloud.
Istruzioni sull'installazione
Queste istruzioni riguardano l'installazione di Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, ad esempio i comandi dell'interfaccia a riga della gcloud CLI a livello di release alpha o beta, consulta Gestione della gcloud CLI gcloud.
- Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python da 3.8 a 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 il tuo interprete Python, vedi
gcloud topic startup
. - Scarica uno dei seguenti file:
Piattaforma Nome pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-479.0.0-linux-x86_64.tar.gz 130,4 MB 82b01bc36bd60ea9ce0284de3e424f7b09f54acc9118b353f15951d33c5fe15c Linux a 64 bit (Arm)
google-cloud-cli-479.0.0-linux-arm.tar.gz 51,9 MB 84d5686ad0d9b5c39476911134b97f7a1e84032972b13b68d4aea22b691563d7 Linux a 32 bit (x86)
google-cloud-cli-479.0.0-linux-x86.tar.gz 51,9 MB 4653559382a9df4554c17d19584b253d9f04cb5142f277a5c2a1a72e2ce2e15a Per scaricare il file di archivio Linux, esegui questo comando:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-479.0.0-linux-x86_64.tar.gz
Fai riferimento alla tabella precedente e sostituisci google-cloud-cli-479.0.0-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 tua home directory), esegui questo comando:
tar -xf google-cloud-cli-479.0.0-linux-x86_64.tar.gz
Facoltativo: per sostituire un'installazione esistente, rimuovi la directorygoogle-cloud-sdk
esistente ed estrai l'archivio nella stessa posizione. - Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla directory radice della cartella che hai estratto utilizzando il seguente comando:
./google-cloud-sdk/install.sh
Questa operazione può anche essere eseguita in modo non interattivo (ad esempio utilizzando uno script) e specificando le preferenze sotto forma di flag. Per visualizzare i flag disponibili, esegui:./google-cloud-sdk/install.sh --help
Facoltativo:- Per inviare statistiche sull'utilizzo anonimo
per contribuire a migliorare gcloud CLI, rispondi
Y
quando richiesto. -
Per aggiungere gcloud CLI a
PATH
e abilitare il completamento dei comandi, rispondiY
quando richiesto.
- Per inviare statistiche sull'utilizzo anonimo
per contribuire a migliorare gcloud CLI, rispondi
- Apri un nuovo terminale per applicare le modifiche.
- Per inizializzare gcloud CLI, esegui
gcloud init
: - (Facoltativo) Installa 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:
- Si tratta di una release Ubuntu che non ha raggiunto la fine del ciclo di vita o di una release stabile Debian che non ha ancora raggiunto la fine del ciclo di vita.
- Di recente ha aggiornato i propri pacchetti:
sudo apt-get update
- Ha
apt-transport-https
ecurl
installati: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 e versioni successive o Ubuntu 18.04 e versioni successive) esegui questo 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 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 il file della chiave apt-get.gpg più recente.
- Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud 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:
sudo apt-get update && sudo apt-get install google-cloud-cli
Per ulteriori opzioni diapt-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 invece un singolo passaggio RUN:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
Per le immagini di base meno recenti che non supportano il comandogpg --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
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 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 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 sistemi 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 le estensioni di 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.
- 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 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
-
Se stai eseguendo l'installazione su Fedora 34 o 35, installa
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installa l'interfaccia a riga di comando gcloud:
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 tornare a una versione specifica di gcloud CLI, dove VERSION
è nel formato 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 versione Python attuale, esegui
python3 -V
opython -V
. Le versioni supportate sono Python dalla 3.8 alla 3.12. - Lo script di installazione principale offre l'installazione di Python 3.11 di CPython.
- In caso contrario, per installare una versione Python supportata, visita la pagina delle Release Python per macOS di Python.org.
- Se sulla 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 preferito.
-
Per maggiori informazioni su come scegliere e configurare il tuo interprete Python, vedi
gcloud topic startup
.
-
Per controllare la versione Python attuale, esegui
- Scarica uno dei seguenti file:
-
Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente nella tua home directory). Su macOS, puoi farlo aprendo il file di archivio
.tar.gz
scaricato nella posizione preferita.Per sostituire un'installazione esistente, rimuovi la directory
google-cloud-sdk
esistente ed estrai l'archivio nella stessa posizione. -
(Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti gcloud CLI a
PATH
.Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche sull'utilizzo e installare Python 3.11.Esegui lo script (dalla directory principale della cartella estratta nell'ultimo passaggio) utilizzando questo comando:
./google-cloud-sdk/install.sh
This can also be done non-interactively (for example, using a script) by providing preferences as flags. To describe the available flags, run:./google-cloud-sdk/install.sh --help
To run the install script with screen reader mode on:./google-cloud-sdk/install.sh --screen-reader=true
Open a new terminal so that the changes take effect. -
To initialize the gcloud CLI, run
gcloud init
: - Optional. Install additional components using the component manager.
Piattaforma | Pacchetto | Dimensioni | Checksum SHA256 |
---|---|---|---|
macOS a 64 bit
(x86_64) |
google-cloud-cli-479.0.0-darwin-x86_64.tar.gz | 52 MB | 4e79437b3c973a2c8b7a0915b778875012a0c6724ba88d98bcb3bae367b375ae |
macOS a 64 bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-479.0.0-darwin-arm.tar.gz | 52 MB | 7316ee41298a8db36f3e1a72115f491fc08214c7f7b374e7eb87cec3b2f2debc |
macOS a 32 bit
(x86) |
google-cloud-cli-479.0.0-darwin-x86.tar.gz | 50,7 MB | 1a6230246525ff948e55de8b9e1c394dfeeccdfa809c75d613a61fb989fab8fe |
./google-cloud-sdk/bin/gcloud init
-
The Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.
-
Download the Google Cloud CLI installer.
Alternatively, open a PowerShell terminal and run the following PowerShell commands:
(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 consente di configurare
gcloud
in modo che utilizzi tracker di stato anziché gli spinner Unicode, consente di visualizzare l'avanzamento in percentuale e di rendere più uniformi le tabelle. Per maggiori informazioni, consulta la guida alle funzionalità di accessibilità. -
Google Cloud CLI richiede Python; le versioni supportate sono Python dalla 3.8 alla 3.12. Per impostazione predefinita, la versione Windows di Google Cloud CLI è inclusa in 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 Python necessaria. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione Python esistente deselezionando l'opzione Installa Python in bundle. Consulta la pagina
gcloud topic startup
per scoprire come utilizzare un'installazione Python esistente. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie per il menu Start e desktop, avviare la shell di Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e configurare l'installazione selezionata. Il programma di installazione avvia una finestra del terminale ed esegue il comando
gcloud init
.- L'installazione predefinita non include le estensioni di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi
gcloud
. Questi componenti possono essere installati utilizzando il gestore dei componenti dell'interfaccia a riga di comando gcloud.
- Se l'installazione non va a buon fine
perché il comando
find
non è stato riconosciuto, assicurati che la variabile di ambientePATH
sia impostata in modo da includere la cartella contenentefind
. Solitamente, èC:\WINDOWS\system32;
. - Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installare di nuovo gcloud CLI.
- Se la decompressione non riesce, esegui il programma di installazione come amministratore.
Altre opzioni di installazione
A seconda delle tue esigenze di sviluppo, anziché all'installazione consigliata, puoi utilizzare un metodo alternativo per installare gcloud CLI:
- Utilizzi gcloud CLI con gli script o l'integrazione/il deployment continui? 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 dell'interfaccia a riga di comando gcloud per la release più recente (o una versione specifica) di gcloud CLI.
- Se utilizzi Ubuntu e preferisci gli aggiornamenti automatici, Utilizza un pacchetto Snap per installare gcloud CLI.
- Per le installazioni interattive per Windows e macOS e per tutti gli altri casi d'uso, esegui il programma di installazione interattivo per installare la release più recente di gcloud CLI.
Gestire un'installazione
Dopo aver installato gcloud CLI, puoi utilizzare i comandi nel gruppo di comandi gcloud components
per gestire l'installazione. Sono inclusi la visualizzazione dei componenti installati, l'aggiunta e la rimozione dei componenti, l'upgrade a una nuova versione o il downgrade a una versione specifica di gcloud CLI.
Versioni precedenti di gcloud CLI
Se hai bisogno di una versione diversa di gcloud CLI, installa la versione attuale utilizzando le istruzioni visualizzate in precedenza in questa pagina, quindi accedi. Dopo aver eseguito l'accesso, puoi scaricare le versioni precedenti. Per visualizzare le versioni ordinate per data, assicurati di attivare Ordina e filtra e fai clic sulla colonna Creata.
Versioni di Python supportate
Google Cloud CLI richiede Python dalla versione 3.8 alla versione 3.12. Per informazioni su come scegliere e configurare l'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