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 gcloud CLI ai livelli di release Alpha, Beta o Preview oppure un pacchetto che contiene le dipendenze utilizzate da uno strumento in gcloud CLI.

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

Componenti predefiniti

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

ID Nome Descrizione
gcloud Comandi gcloud CLI predefiniti Strumento per interagire con Cloud de Confiance. Con questo componente vengono installati solo i comandi a livello di release di disponibilità generale. Devi installare separatamente i componenti gcloud alpha Commands, gcloud beta Commands e/o gcloud preview Commands se vuoi utilizzare i comandi ad altri livelli di release.
bq Strumento a riga di comando BigQuery Strumento per lavorare con i dati in BigQuery
gsutil Strumento legacy per l'esecuzione di attività di Cloud Storage. Utilizza invece i comandi gcloud storage.
core Librerie principali di gcloud CLI Librerie utilizzate internamente dagli strumenti gcloud CLI.

Componenti alpha, beta e di anteprima

gcloud CLI fornisce componenti che contengono i comandi alpha, beta e di anteprima di gcloud CLI. Questi componenti non vengono 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 di gcloud CLI Comandi gcloud CLI a livello di versione alpha.
beta Comandi beta di gcloud CLI Comandi gcloud CLI a livello di versione beta.
preview Comandi di anteprima di gcloud CLI Comandi gcloud CLI a livello di versione di anteprima.

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 di pacchetti esterni disponibili, che non vengono installati per impostazione predefinita.

Gestione dei componenti di gcloud CLI

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

Componenti di elenco

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 ultime offerte di componenti, aggiorna l'installazione di gcloud CLI, quindi esegui gcloud components list.

Stato Nome del componente ID Dimensioni
Installato Estensioni Go di App Engine app-engine-go 97,7 MiB
Installato Strumento a riga di comando di Cloud Bigtable cbt 4,0 MiB
Installato Emulatore Cloud Bigtable bigtable 3,8 MiB
Installato Emulatore di Cloud Datastore cloud-datastore-emulator 17,8 MiB
Non installata Emulatore di Cloud Firestore cloud-firestore-emulator 60,4 MiB
Installato Emulatore Cloud Pub/Sub pubsub-emulator 33,2 MiB
Installato Emulatore Cloud Spanner cloud-spanner-emulator 21,8 MiB
Installato Google Cloud Build Local Builder cloud-build-local 4,4 MiB
Installato Estensioni Java per gcloud app app-engine-java 118,9 MiB
Installato Estensioni PHP di gcloud app app-engine-php 21,9 MiB
Installato Estensioni Python per gcloud app (librerie aggiuntive) app-engine-python-extras 27,8 MiB
Installato kubectl kubectl 12,2 MiB
Installato Strumento a riga di comando di Cloud BigQuery bq < 1 MiB
Installato Librerie principali di Cloud SDK core 7,2 MiB
Installato Strumento a riga di comando di Cloud Storage gsutil 3,3 MiB
Installato Comandi gcloud Alpha alfa < 1 MiB
Installato Comandi gcloud beta beta < 1 MiB
Non installata Comandi gcloud Preview anteprima < 1 MiB
Installato Estensioni Python per gcloud app app-engine-python 6,1 MiB

Installazione dei componenti

Per installare un componente nella versione corrente della tua 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 alla versione più recente 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 funzionante e hai installato gcloud CLI direttamente (all'esterno 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

Rimozione dei 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 vengono 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.