Questa pagina contiene le istruzioni per scegliere e gestire un'installazione dell'interfaccia a riga di comando di Google Cloud. L'interfaccia a riga di comando di Google Cloud include gli strumenti a riga di comando gcloud
, gsutil
e bq
. Per un elenco delle funzionalità dell'interfaccia a riga di comando gcloud, vedi
Tutte le funzionalità.
Per accedere alle API Google Cloud utilizzando un linguaggio di programmazione supportato, puoi scaricare le librerie client di Cloud.
Istruzioni di installazione
Queste istruzioni riguardano l'installazione dell'interfaccia a riga di comando di Google Cloud. Per informazioni sull'installazione di componenti aggiuntivi, ad esempio i comandi dell'interfaccia a riga di comando gcloud a livello di release alpha o beta, consulta la sezione Gestione dei componenti dell'interfaccia a riga di comando gcloud.
- Verifica di avere una versione supportata di Python. L'interfaccia a riga di comando di Google Cloud richiede Python 3 (da 3.5 a 3.8, 3.7 consigliato) e Python 2 (2.7.9 o versioni successive). Per informazioni su come scegliere e configurare l'interprete Python, consulta la sezione
gcloud topic startup
.Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.
- Scarica uno dei seguenti elementi:
Piattaforma Pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-392.0.0-linux-x86_64.tar.gz 104,3 MB a7e88856a07ed75cf310ebe5415c922c9b516021a6c7e66b3eb8f2859b9351bc Linux a 64 bit (braccia)
google-cloud-cli-392.0.0-linux-arm.tar.gz 101,2 MB 6585b33a56806f95378bdfbd3f5c78f90adca1b50730639e32d674404a7e6c07 Linux a 32 bit (x86)
google-cloud-cli-392.0.0-linux-x86.tar.gz 102,2 MB 3b466c3cfb3ea3848fec45077c2fd8d926b15724f68709235dd7ade05e051121 In alternativa, per scaricare il file di archivio a 64 bit di Linux, nella riga di comando esegui:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-392.0.0-linux-x86_64.tar.gz
Per il file di archivio braccio a 64 bit, esegui:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-392.0.0-linux-arm.tar.gz
Per il file di archivio a 32 bit, esegui:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-392.0.0-linux-x86.tar.gz
- Estrai i contenuti del file in qualsiasi punto del tuo file system (preferibilmente
nella tua home directory). Per sostituire un'installazione esistente, rimuovi la directory
google-cloud-sdk
esistente ed estrai l'archivio nella stessa posizione.tar -xf google-cloud-cli-392.0.0-linux-x86.tar.gz
- (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud al
PATH
. Puoi anche attivare il completamento dei comandi per la shell e la raccolta delle statistiche di utilizzo.Esegui lo script (dalla radice della cartella estratta) 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 come flag. Tali risorse sono descritte in:./google-cloud-sdk/install.sh --help
- Se vuoi inviare statistiche di utilizzo anonime per migliorare l'interfaccia a riga di comando gcloud,
rispondi
Y
quando richiesto. - Per aggiungere l'interfaccia a riga di comando gcloud al
PATH
e abilitare il completamento del comando, rispondiY
quando richiesto.
Apri un nuovo terminale in modo che le modifiche abbiano effetto.
- Per inizializzare l'interfaccia a riga di comando gcloud, esegui
gcloud init
: - (Facoltativo) Installa i componenti aggiuntivi utilizzando il gestore componenti.
./google-cloud-sdk/bin/gcloud init
Contenuti della confezione
L'interfaccia a riga di comando gcloud è 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 di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud
. Se vuoi utilizzare questi componenti, devi
installarli separatamente.
Prima di installare l'interfaccia a riga di comando gcloud, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:
- Una release Ubuntu che non ha raggiunto fine della vita o una release stabile di Debian che non ha raggiunto fine della vita
- apt-transport-https è installato:
sudo apt-get install apt-transport-https ca-certificates gnupg
- Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud come origine pacchetto. Se la tua distribuzione supporta l'opzione firmata, esegui il comando seguente:
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
Se la tua distribuzione non supporta l'opzione "Firmato", esegui il seguente comando:
echo "deb 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 di Google Cloud. Se il comando
apt-key
di Distribution distribuzione supporta l'argomento--keyring
, esegui il comando seguente: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 di distribuzione e #39 non supporta l'argomento
--keyring
, esegui il comando seguente:curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Se la tua distribuzione (Debian 11+ o Ubuntu 21.10 o versioni successive) non supporta
apt-key
, esegui il seguente comando:curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg
Se non riesci a ricevere gli aggiornamenti più recenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.
- Aggiorna e installa l'interfaccia a riga di comando gcloud:
sudo apt-get update && sudo apt-get install google-cloud-cli
Per ulteriori opzioniapt-get
, ad esempio per disabilitare le richieste o le prove, consulta le pagine dedicate aapt-get
.Suggerimento Docker: se installi l'interfaccia a riga di comando gcloud all'interno di un'immagine Docker, utilizza invece un singolo passaggio RUN:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://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
Se il comandoapt-key
non è supportato:RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -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-datalab
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
Downgrade delle versioni dell'interfaccia a riga di comando gcloud
Per ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, dove VERSION
è nel
formato 123.0.0
, esegui il comando seguente:
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 della confezione
L'interfaccia a riga di comando gcloud è disponibile in formato pacchetto per l'installazione su sistemi Red Hat Enterprise Linux
7, Red Hat Enterprise Linux 8, Fedora 33, Fedora 34, CentOS 7 e Centos 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.
- Aggiorna DNF con le informazioni del repository dell'interfaccia a riga di comando gcloud. Il comando di esempio riportato di seguito riguarda un'installazione compatibile con Red Hat Enterprise Linux 8. Per un'installazione compatibile con Red Hat Enterprise Linux 7, sostituisci
el8
conel7
nel valore perbaseUrl
.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-el8-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
-
Se installi Fedora 34 o 35, installa
libcrypt-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-datalab
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
Downgrade delle versioni dell'interfaccia a riga di comando gcloud
Se vuoi ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, in cui 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 disporre di una versione supportata di Python:
-
Per controllare la versione corrente del tuo Python, esegui
python3 -V
opython -V
. Le versioni moderne di macOS includono la versione appropriata di Python richiesta per Cloud SDK. Le versioni supportate sono Python 3 (da 3.5 a 3.8, 3.7 consigliate) e Python 2 (2.7.9 o versioni successive).Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.
- Per Cloud SDK 352.0.0 e versioni successive, lo script di installazione principale offre l'installazione di Python 3.7 su CPython su Mac basati su Intel.
-
Per scoprire di più su come scegliere e configurare l'interprete Python, consulta
gcloud topic startup
.
-
Per controllare la versione corrente del tuo Python, esegui
- Scarica uno dei seguenti elementi:
-
Estrai l'archivio in qualsiasi punto del file system (preferibilmente la tua home directory). Su macOS, puoi eseguire questa operazione aprendo il file di archivio
.tar.gz
nella posizione preferita.Per sostituire un'installazione esistente, rimuovi la directory
google-cloud-sdk
esistente, quindi estrai l'archivio nella stessa posizione. -
(Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud al tuo
PATH
. Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche sull'utilizzo e installare Python 3.7.Esegui lo script (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando questo comando:
./google-cloud-sdk/install.sh
Questa operazione può anche essere eseguita in modo non interattivo (ad esempio, utilizzando uno script) assegnando 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 attivata:./google-cloud-sdk/install.sh --screen-reader=true
Apri un nuovo terminale in modo che le modifiche abbiano effetto. -
Per inizializzare l'interfaccia a riga di comando gcloud, esegui
gcloud init
: - (Facoltativo) Installa i componenti aggiuntivi utilizzando il gestore componenti.
Piattaforma | Pacchetto | Dimensioni | Checksum SHA256 |
---|---|---|---|
macOS a 64 bit
(x86_64) |
google-cloud-cli-392.0.0-darwin-x86_64.tar.gz | 104,6 MB | 08917f5a269aad838615db8d873e1b2d828649d451753babcadaa8feccf8ebc9 |
macOS a 64 bit
(arm64, silicone per Apple M1) |
google-cloud-cli-392.0.0-darwin-arm.tar.gz | 103,3 MB | 4a975e2320b87de80b40854e012f61493252f8b9011f11347517cd07558d6328 |
macOS a 32 bit
(x86) |
google-cloud-cli-392.0.0-darwin-x86.tar.gz | 107,9 MB | 8de8154f4d5aea39cb3b9c2d969340bd0dc78a6c1c91bf5b9f91a4ab16a75010 |
./google-cloud-sdk/bin/gcloud init
-
L'interfaccia a riga di comando di Google Cloud funziona su Windows 8.1 e versioni successive e su Windows Server 2012 e versioni successive.
-
Scarica il programma di installazione dell'interfaccia a riga di comando di Google Cloud.
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 modalità screen reader. Questa opzione configura
gcloud
in modo che utilizzi tracker di stato anziché spinner Unicode, visualizza l'avanzamento in percentuale e appiatti le tabelle. Per ulteriori informazioni, consulta la guida alle funzioni di accessibilità. -
Cloud SDK richiede Python; le versioni supportate sono Python 3 (opzione preferita, da 3.5 a 3.8) e Python 2 (2.7.9 o versioni successive). Per impostazione predefinita, la versione Windows di Cloud SDK include bundle Python 3 e Python 2. Per utilizzare Cloud SDK, il tuo sistema operativo deve essere in grado di eseguire una versione supportata di Python.
Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.
Il programma di installazione installa tutte le dipendenze necessarie, inclusa la versione Python necessaria. Anche se Cloud SDK 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 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 menu Start e collegamenti sul desktop, avviare la shell dell'interfaccia a riga di comando di Google Cloud e configurare l'interfaccia a riga di comando gcloud. Assicurati di lasciare le opzioni necessarie per avviare la shell e di configurare l'installazione. Il programma di installazione avvia una finestra di 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 riesce a causa del mancato riconoscimento del comando
find
, assicurati che la variabile di ambientePATH
sia impostata per includere la cartella contenentefind
. Di solito, questo èC:\WINDOWS\system32;
. - Se hai disinstallato l'interfaccia a riga di comando gcloud, devi riavviare il sistema prima di installare di nuovo l'interfaccia a riga di comando gcloud.
- Se la decompressione non riesce, esegui il programma di installazione come amministratore.
Altre opzioni di installazione
A seconda delle tue esigenze di sviluppo, anziché l'installazione consigliata, puoi utilizzare un metodo alternativo per l'installazione dell'interfaccia a riga di comando gcloud:
- Utilizzi l'interfaccia a riga di comando gcloud con script o l'integrazione/il deployment continui? Scarica un archivio con versione per un'installazione non interattiva di una versione specifica dell'interfaccia a riga di comando gcloud.
- Devi eseguire l'interfaccia a riga di comando gcloud come immagine Docker? Utilizza l'immagine Docker dell'interfaccia a riga di comando gcloud per la release più recente (o una versione specifica) dell'interfaccia a riga di comando gcloud.
- Se utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Usa un pacchetto di snapshot per installare l'interfaccia a riga di comando gcloud.
- Per le installazioni interattive di Windows e macOS e per tutti gli altri casi d'uso, esegui il programma di installazione interattivo per installare l'ultima release dell'interfaccia a riga di comando gcloud.
Gestire un'installazione
Dopo aver installato l'interfaccia a riga di comando gcloud, puoi utilizzare i comandi nel gruppo di comandi gcloud components
per gestire l'installazione. Ciò include la visualizzazione dei componenti installati, l'aggiunta e la rimozione di componenti e l'upgrade a una nuova versione o il downgrade a una versione specifica dell'interfaccia a riga di comando gcloud.
Versioni precedenti dell'interfaccia a riga di comando gcloud
Se hai bisogno di una versione diversa dell'interfaccia a riga di comando gcloud, installa la versione corrente seguendo le istruzioni visualizzate in precedenza in questa pagina e quindi accedi. Dopo aver eseguito l'accesso, puoi scaricare le release precedenti. Per visualizzare le versioni ordinate per data, assicurati di attivare l'opzione Ordina e filtra e fai clic sulla colonna Creata.
Versioni di Python supportate
Dal 1° gennaio 2020 la community Python non aggiorna più, risolve bug, patch o problemi di sicurezza per Python 2. Ti consigliamo di eseguire l'upgrade a Python 3 il prima possibile. Per ulteriori informazioni, vedi Assistenza Python 2 su Google Cloud.
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