Gestione dei componenti della 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 ai livelli di release Alpha o Beta o un pacchetto che contiene le dipendenze utilizzate da uno strumento nell'interfaccia a riga di comando gcloud.

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'interfaccia a riga di comando gcloud 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 gcloud CLI predefiniti uno strumento per interagire con Google Cloud. Solo i comandi ai livelli di disponibilità generale e di release di anteprima vengono installati con questo componente. 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 le funzionalità di Comandi gcloud storage .
core Librerie di base dell'interfaccia a riga di comando gcloud Librerie utilizzate internamente dagli strumenti gcloud CLI.

Componenti alpha e beta

gcloud CLI fornisce due componenti che 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 della CLI gcloud. Questi componenti sono:

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

I comandi gcloud CLI al livello di release per la disponibilità generale sono del componente gcloud CLI e vengono installati automaticamente quando installi 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 della gcloud CLI

Puoi elencare, installare, aggiornare e rimuovere i componenti della gcloud CLI che risponda alle tue esigenze.

Nota: queste istruzioni non funzionano se hai installato l'app gcloud CLI utilizzando un gestore di pacchetti come APT o yum perché il gestore dei componenti della gcloud CLI è disabilitato quando si utilizza quel metodo dell'installazione. Utilizza questi packages.

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 e poi esegui gcloud components list.

Stato Nome componente ID Dimensioni
Installata Estensioni di App Engine Go app-engine-go 97,7 MiB
Non installata AppCtl appctl 21,0 MiB
Installata Strumento a riga di comando di 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 Emulatore Cloud Pub/Sub 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 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 gcloud app 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 di Cloud BigQuery bq < 1 MiB
Installata Librerie principali di Cloud SDK core 7,2 MiB
Installata Strumento a riga di comando Cloud Storage gsutil 3,3 MiB
Installata Comandi alpha di gcloud 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 di gcloud CLI installazione, eseguire 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 la gcloud components update per aggiornare tutti i componenti installati all'ultima versione disponibile gcloud CLI:

gcloud components update

Se hai installato una versione precedente dell'interfaccia a riga di comando gcloud, l'interfaccia a riga di comando gcloud 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, incluso l'utilizzo dell'installatore interattivo, delle versioni statiche, dell'installatore per Windows o di Homebrew), utilizza gcloud components update per ripristinare la versione specificata:

gcloud components update --version VERSION
Per il downgrade delle versioni dell'interfaccia a riga di comando gcloud installate utilizzando un gestore di pacchetti, consulta queste istruzioni per specificare le versioni durante il download utilizzando apt-get o yum.

Rimozione dei componenti

Utilizza la 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

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 gcloud CLI tramite apt o yum gestori di pacchetti, puoi anche installare componenti aggiuntivi di gcloud CLI usando gli stessi gestori di pacchetti. Se le tue non riesce a trovare questi pacchetti, leggi il installare con apt o guide all'installazione con yum per scoprire come configurare https://packages.cloud.google.com/ come origine del pacchetto.

Componente dell'interfaccia a riga di comando gcloud 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