Gestione dei componenti gcloud CLI

I componenti sono le parti installabili di Google Cloud CLI. Un componente può essere uno strumento a riga di comando (gcloud, bq e gsutil), un set di comandi dell'interfaccia a riga della gcloud CLI a livello di release alpha o beta o un pacchetto contenente dipendenze utilizzate da uno strumento nellgcloud CLI.

I componenti più utilizzati sono installati per impostazione predefinita. Se esegui un comando gcloud alpha o gcloud beta in modo interattivo e il componente alpha o beta non è installato, gcloud CLI ti chiede se vuoi installarlo. Una risposta affermativa installa il componente e poi esegue il comando. Gli altri componenti vengono installati on demand da gcloud CLI quando esegui comandi che li richiedono.

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

Componenti predefiniti

Quando installi gcloud CLI, i seguenti componenti sono installati per impostazione predefinita:

ID Nome Descrizione
gcloud Comandi predefiniti dell'interfaccia a riga di comando gcloud Strumento per interagire con Google Cloud. Con questo componente vengono installati solo i comandi a livello di disponibilità generale e di release in anteprima. Devi installare separatamente i componenti Comandi gcloud alpha e/o Comandi gcloud beta se vuoi utilizzare comandi in altri livelli di release.
bq Strumento a riga di comando di BigQuery Strumento per lavorare con i dati in BigQuery
gsutil Strumento a riga di comando di Cloud Storage Strumento per l'esecuzione di attività relative a Cloud Storage.
core Librerie di base di gcloud CLI Librerie utilizzate internamente dagli strumenti gcloud CLI.

Componenti alpha e beta

gcloud CLI fornisce due componenti che contengono i comandi alpha e beta di gcloud CLI. Questi componenti non sono installati per impostazione predefinita, ma puoi installarli manualmente in qualsiasi momento dopo l'installazione iniziale di gcloud CLI. Questi componenti sono:

ID Nome Descrizione
alpha Comandi alpha gcloud CLI I comandi dell'interfaccia a riga di comando gcloud a livello di release alpha.
beta Comandi beta gcloud CLI Comandi dell'interfaccia a riga di comando gcloud CLI a livello di release beta.

I comandi gcloud CLI a livello di release di disponibilità generale fanno parte del componente gcloud CLI e vengono installati automaticamente quando installi gcloud CLI.

Di seguito è riportato un elenco di tutti i componenti aggiuntivi e i gestori pacchetti esterni disponibili, non installati per impostazione predefinita.

Gestione dei componenti gcloud CLI

Puoi elencare, installare, aggiornare e rimuovere i componenti di gcloud CLI in base alle tue esigenze.

Elenco dei componenti

Per visualizzare un elenco dei componenti disponibili e attualmente installati, esegui gcloud components list:

gcloud components list

Il seguente esempio non è un elenco completo di tutti i componenti disponibili. Per visualizzare le ultime offerte per i componenti, aggiorna l'installazione di gcloud CLI, quindi esegui gcloud components list.

Stato Nome componente ID Dimensioni
Installata Estensioni Go di App Engine app-engine-go 97,7 MiB
Non installata AppCtl appctl 21,0 MiB
Installata Strumento a riga di comando Cloud Bigtable cbt 4,0 MiB
Installata Emulatore di Cloud Bigtable bigtable 3,8 MiB
Installata Emulatore di Cloud Datastore emulatore-datastore-cloud 17,8 MiB
Non installata Emulatore di Cloud Firestore emulatore-cloud-firestore 60,4 MiB
Installata Emulatore Cloud Pub/Sub emulatore pubsub 33,2 MiB
Installata Cloud SQL Proxy cloud_sql_proxy 7,6 MiB
Installata Emulatore di Cloud Spanner emulatore-cloud-spanner 21,8 MiB
Installata Builder locale di Google Cloud Build cloud-build-local 4,4 MiB
Installata Estensioni Java dell'app gcloud app-engine-java 118,9 MiB
Installata Estensioni PHP dell'app gcloud app-engine-php 21,9 MiB
Installata gcloud app Python Extensions (Extra Libraries) app-engine-python-extras 27,8 MiB
Installata kubectl kubectl 12,2 MiB
Installata Strumento a riga di comando Cloud BigQuery bq < 1 MiB
Installata Librerie Cloud SDK Core core 7,2 MiB
Installata Strumento a riga di comando di Cloud Storage gsutil 3,3 MiB
Installata Comandi gcloud alfa alpha < 1 MiB
Installata Comandi gcloud beta beta < 1 MiB
Installata Estensioni Python dell'app gcloud app-engine-python 6,1 MiB

Installazione dei componenti

Per installare un componente nella versione attuale dell'installazione di gcloud CLI, esegui gcloud components install:

gcloud components install [COMPONENT-ID]

Gcloud CLI installa il componente specificato.

Ad esempio, se vuoi installare il comando kubectl:

gcloud components install kubectl

Aggiornamento dei componenti

Utilizza il comando gcloud components update per aggiornare tutti i componenti installati all'ultima versione disponibile di gcloud CLI:

gcloud components update

Se hai installato una versione precedente di gcloud CLI, gcloud CLI aggiorna tutti i componenti installati.

Se devi ripristinare una versione precedente nota e hai installato gcloud CLI direttamente (al di fuori di un gestore di pacchetti, ad esempio utilizzando il programma di installazione interattivo, le versioni statiche, il programma di installazione di Windows o Homebrew), utilizza gcloud components update per ripristinare la versione specificata:

gcloud components update --version VERSION

Per eseguire il downgrade delle versioni di gcloud CLI installate utilizzando un gestore di pacchetti, consulta queste istruzioni per specificare le versioni durante il download utilizzando apt-get o yum.

Rimozione di componenti

Utilizza il comando gcloud components remove per rimuovere un componente specificato in base al suo ID:

gcloud components remove [COMPONENT-ID]

Puoi reinstallare un componente utilizzando il comando gcloud components install in qualsiasi momento.

Componenti aggiuntivi

Anche i componenti aggiuntivi che contengono dipendenze per i comandi di gcloud CLI sono disponibili in gcloud CLI, ma non sono installati per impostazione predefinita. Per un elenco completo dei componenti, esegui gcloud components list. I componenti aggiuntivi che possono essere installati sono contrassegnati con lo stato Not Installed.

Gestori pacchetti esterni

Se hai installato gcloud CLI tramite i gestori di pacchetti apt o yum, puoi anche installare componenti aggiuntivi dell'interfaccia a riga di comando utilizzando gli stessi gestori di pacchetti. Se il gestore di pacchetti non riesce a trovare questi pacchetti, leggi le guide relative all'installazione con apt o all'installazione con yum per scoprire come configurare https://packages.cloud.google.com/ come origine pacchetto.

Componente gcloud CLI Pacchetto APT Pacchetto YUM
app-engine-go google-cloud-cli-app-engine-go google-cloud-cli-app-engine-go
app-engine-java google-cloud-cli-app-engine-java google-cloud-cli-app-engine-java
app-engine-python google-cloud-cli-app-engine-python google-cloud-cli-app-engine-python
bigtable google-cloud-cli-bigtable-emulator google-cloud-cli-bigtable-emulator
cbt google-cloud-cli-cbt google-cloud-cli-cbt
cloud-build-local google-cloud-cli-cloud-build-local google-cloud-cli-cloud-build-local
docker-credential-gcr Non ancora disponibile. Non ancora disponibile.
gcd-emulator google-cloud-cli-datastore-emulator google-cloud-cli-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-pubsub-emulator