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 insieme di comandi dell'interfaccia a riga di comando gcloud CLI ai livelli di release Alpha o Beta o un pacchetto che contiene le 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. Altri componenti vengono installati on demand dall'gcloud CLI quando esegui i 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 vengono installati per impostazione predefinita:

ID Nome Descrizione
gcloud Comandi dell'interfaccia a riga di comando gcloud CLI predefiniti Strumento per interagire con Google Cloud. Con questo componente vengono installati solo i comandi a livello di release di disponibilità generale e di anteprima. Se vuoi utilizzare i comandi a altri livelli di release, devi installare separatamente i componenti gcloud alpha Commands e/o gcloud beta Commands.
bq Strumento a riga di comando BigQuery Strumento per lavorare con i dati in BigQuery
gsutil Strumento precedente per l'esecuzione di attività di Cloud Storage. Utilizza i comandi gcloud storage.
core Librerie di base 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 gcloud CLI. Questi componenti non sono installati per impostazione predefinita, ma puoi installarli manualmente in qualsiasi momento dopo l'installazione iniziale gcloud CLI. Questi componenti sono:

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

I comandi dell'interfaccia a riga della gcloud CLI a livello di release di disponibilità generale fanno parte del componente dell'interfaccia alla gcloud CLI e vengono installati automaticamente quando installi l&#gcloud CLI.

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

Gestione dei componenti gcloud CLI

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

Nota: queste istruzioni non funzionano se hai installato gcloud CLI utilizzando un gestore dei pacchetti come APT o yum perché il gestore dei componenti dell'interfaccia a riga di comando gcloud è disattivato quando utilizzi questo metodo di installazione. Utilizza invece questi pacchetti.

Componenti della scheda

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

gcloud components list

L'esempio seguente non è un elenco completo di tutti i componenti disponibili. Per visualizzare le offerte di componenti più recenti, aggiorna l'installazione dell'interfaccia a riga di comando gcloud CLI ed esegui gcloud components list.

Stato Component Name 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 Cloud Bigtable Emulator bigtable 3,8 MiB
Installata Emulatore di Cloud Datastore cloud-datastore-emulator 17,8 MiB
Non installata Emulatore di Cloud Firestore cloud-firestore-emulator 60,4 MiB
Installata Cloud Pub/Sub Emulator pubsub-emulator 33,2 MiB
Installata Cloud SQL Proxy cloud_sql_proxy 7,6 MiB
Installata Emulatore Cloud Spanner cloud-spanner-emulator 21,8 MiB
Installata Costruttore locale Google Cloud Build cloud-build-local 4,4 MiB
Installata Estensioni Java gcloud app app-engine-java 118,9 MiB
Installata Estensioni PHP gcloud app app-engine-php 21,9 MiB
Installata Estensioni Python di gcloud app (librerie aggiuntive) 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 di base di Cloud SDK core 7,2 MiB
Installata Strumento a riga di comando Cloud Storage gsutil 3,3 MiB
Installata Comandi gcloud Alpha alpha < 1 MiB
Installata Comandi gcloud beta beta < 1 MiB
Installata Estensioni Python di gcloud app app-engine-python 6,1 MiB

Installazione dei componenti

Per installare un componente nella versione corrente dell'installazione dell'interfaccia alla 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 dellgcloud CLI:

gcloud components update

Se hai installato una versione precedente dellgcloud CLI, l'interfaccia alla gcloud CLI aggiorna tutti i componenti installati.

Se devi ripristinare una versione precedentemente nota come valida e hai installato gcloud CLI direttamente (al di fuori di un gestore pacchetti, ad esempio utilizzando l'installatore interattivo, le versioni statiche, l'installatore per Windows o Homebrew), utilizza gcloud components update per ripristinare la versione specificata:

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

Rimuovere i componenti

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

gcloud components remove [COMPONENT-ID]

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

Componenti aggiuntivi

Nell'interfaccia a riga di comando gcloud sono disponibili anche componenti aggiuntivi che contengono dipendenze per i comandi gcloud CLI, ma non sono installati per impostazione predefinita. Per un elenco esaustivo dei componenti, esegui gcloud components list. I componenti aggiuntivi che possono essere installati sono contrassegnati dallo stato Not Installed.

Gestori pacchetti esterni

Se hai installato l'interfaccia alla gcloud CLI tramite i gestori di pacchetti apt o yum, puoi anche installare componenti aggiuntivi dell'interfaccia alla gcloud CLI utilizzando gli stessi gestori di pacchetti. Se il gestore dei pacchetti non riesce a trovare questi pacchetti, leggi le guide sull'installazione con apt o sull'installazione con yum per scoprire come configurare https://packages.cloud.google.com/ come origine del 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