Gestione dei componenti dell'interfaccia a riga di comando gcloud

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 a livello di rilascio alpha o beta oppure un pacchetto che contiene 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, l'interfaccia a riga di comando gcloud 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 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 l'interfaccia a riga di comando gcloud, i seguenti componenti sono installati per impostazione predefinita:

ID Nome Descrizione
gcloud Comandi dell'interfaccia a riga di comando gcloud predefinita Strumento per l'interazione con Google Cloud. Con questo componente sono installati solo i comandi a livello di disponibilità generale e anteprima. Devi installare separatamente i componenti Commands gcloud alpha e/o gcloud beta se vuoi utilizzare i comandi ad 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 principali dell'interfaccia a riga di comando gcloud Librerie utilizzate internamente dagli strumenti dell'interfaccia a riga di comando gcloud.

Componenti alpha e beta

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

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

I comandi dell'interfaccia a riga di comando gcloud a livello di release in disponibilità generale fanno parte del componente dell'interfaccia a riga di comando gcloud e vengono installati automaticamente quando installi l'interfaccia a riga di comando gcloud.

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

Gestione dei componenti dell'interfaccia a riga di comando gcloud

Puoi elencare, installare, aggiornare e rimuovere i componenti dell'interfaccia a riga di comando gcloud 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

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

Stato Nome componente ID Dimensioni
Installata Estensioni di App Engine Go motore-app-go 97,7 MiB
Non installata AppCtl appctl 21 MiB
Installata Strumento a riga di comando di Cloud Bigtable cbt 4,0 MiB
Installata Emulatore di Cloud Bigtable bigtable 3,8 MiB
Installata Emulatore di Cloud Datastore emulatore-di-cloud-datastore 17,8 MiB
Non installata Emulatore di Cloud Firestore emulatore cloud-firestore 60,4 MiB
Installata Emulatore di Cloud Pub/Sub emulatore pubsub 33,2 MiB
Installata Cloud SQL Proxy proxy_sql_cloud 7,6 MiB
Installata Emulatore di Cloud Spanner emulatore di cloud-spanner 21,8 MiB
Installata Builder locale per Google Cloud Build locale-build-cloud 4,4 MiB
Installata Estensioni Java dell'app gcloud app-engine-java 118,9 MiB
Installata Estensioni PHP dell'app gcloud php-app-motore 21,9 MiB
Installata Estensioni Python dell'app gcloud (librerie extra) extra-python-motore-app 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 di Cloud Storage gsutil 3,3 MiB
Installata Comandi gcloud Alpha alpha < 1 MiB
Installata Comandi gcloud beta beta < 1 MiB
Installata Estensioni Python per l'app gcloud app-engine-python 6,1 MiB

Installazione dei componenti

Per installare un componente nella versione attuale dell'installazione dell'interfaccia a riga di comando gcloud, esegui gcloud components install:

gcloud components install [COMPONENT-ID]

L'interfaccia a riga di comando gcloud 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 di 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 tornare a una versione valida in precedenza e hai installato direttamente l'interfaccia a riga di comando gcloud (al di fuori di un gestore di pacchetti, incluso l'utilizzo del programma di installazione interattivo, delle versioni statiche, del programma di installazione Windows o di Homebrew), utilizza gcloud components update per ripristinare la versione specificata:

gcloud components update --version VERSION

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

Rimozione dei 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 dell'interfaccia a riga di comando gcloud sono disponibili nell'interfaccia a riga di comando gcloud, 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 di pacchetti esterni

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

Componente 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