gcloud CLI-Komponenten verwalten

Komponenten sind die installierbaren Teile der Google Cloud CLI. Eine Komponente kann ein Befehlszeilentool (gcloud, bq und gsutil), eine Reihe von gcloud-Befehlen auf der Releasestufe Alpha oder Beta oder ein Paket sein, das Abhängigkeiten enthält, die von einem Tool in der gcloud CLI verwendet werden.

Die gängigsten Komponenten werden standardmäßig installiert. Wenn Sie interaktiv einen gcloud alpha- oder gcloud beta-Befehl ausführen und die Komponente alpha oder beta nicht installiert ist, werden Sie von der gcloud CLI gefragt, ob Sie sie installieren möchten. Wenn ja, wird die Komponente installiert und der Befehl danach ausgeführt. Andere Komponenten werden bei Bedarf von der gcloud CLI installiert, wenn Sie Befehle ausführen, die diese Komponenten erfordern.

Überzeugen Sie sich selbst

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Jetzt kostenlos starten

Standardkomponenten

Wenn Sie die gcloud CLI installieren, werden die folgenden Komponenten standardmäßig installiert:

ID Name Beschreibung
gcloud Standardmäßige gcloud CLI-Befehle Tool für die Interaktion mit Google Cloud. Mit dieser Komponente werden nur Befehle der Releasestufen "Allgemeine Verfügbarkeit" und "Vorschau" installiert. Wenn Sie Befehle anderer Releasestufen verwenden möchten, müssen Sie die gcloud alpha- bzw. gcloud beta-Befehle als separate Komponenten installieren.
bq BigQuery-Befehlszeilentool Tool für die Arbeit mit Daten in BigQuery.
gsutil Cloud Storage-Befehlszeilentool Tool für Aufgaben in Zusammenhang mit Cloud Storage.
core Kernbibliotheken der gcloud CLI Bibliotheken, die intern von den gcloud CLI-Tools verwendet werden.

Alpha- und Betakomponenten

Die gcloud CLI bietet zwei Komponenten mit den Alpha- und Beta-Befehlen der gcloud CLI. Diese Komponenten werden nicht standardmäßig installiert. Sie können sie aber jederzeit nach der Erstinstallation der gcloud CLI manuell installieren. Diese Komponenten sind:

ID Name Beschreibung
alpha Alpha-Befehle der gcloud CLI gcloud CLI-Befehle auf Alpha-Release-Ebene.
beta Betabefehle der gcloud CLI gcloud CLI-Befehle auf Betarelease-Ebene.

gcloud-Kommandozeilenbefehle auf der Releasestufe „Allgemeine Verfügbarkeit“ sind Teil der gcloud CLI und werden automatisch installiert, wenn Sie die gcloud CLI installieren.

Unten sehen Sie eine Liste aller verfügbaren zusätzlichen Komponenten und externen Paketmanager, die nicht standardmäßig installiert sind.

gcloud CLI-Komponenten verwalten

Sie können gcloud CLI-Komponenten nach Ihren Anforderungen installieren, aktualisieren und entfernen.

Komponenten auflisten

Um eine Liste der verfügbaren und derzeit installierten Komponenten aufzurufen, führen Sie gcloud components list aus:

gcloud components list

Das folgende Beispiel ist keine vollständige Auflistung aller verfügbaren Komponenten. Wenn Sie die neuesten Komponentenangebote sehen möchten, aktualisieren Sie die Installation der gcloud CLI und führen Sie dann gcloud components list aus.

Status Komponentenname ID Größe
Installiert App Engine Go-Erweiterungen app-engine-go 97,7 MiB
Nicht installiert AppCtl appctl 21,0 MiB
Installiert Cloud Bigtable-Befehlszeilentool cbt 4,0 MiB
Installiert Cloud Bigtable-Emulator bigtable 3,8 MiB
Installiert Cloud Datastore-Emulator Cloud Datastore-Emulator 17,8 MiB
Nicht installiert Cloud Firestore-Emulator Cloud Firestore-Emulator 60,4 MiB
Installiert Cloud Pub/Sub-Emulator Pub/Sub-Emulator 33,2 MiB
Installiert Cloud SQL Proxy cloud_sql_proxy 7,6 MiB
Installiert Cloud Spanner-Emulator Cloud Spanner-Emulator 21,8 MiB
Installiert Google Cloud Build Local Builder cloud-build-local 4,4 MiB
Installiert gcloud app Java-Erweiterungen app-engine-java 118,9 MiB
Installiert gcloud app PHP-Erweiterungen app-engine-php 21,9 MiB
Installiert gcloud app Python-Erweiterungen (zusätzliche Bibliotheken) app-engine-python-extras 27,8 MiB
Installiert kubectl kubectl 12,2 MiB
Installiert Cloud BigQuery-Befehlszeilentool bq < 1 MiB
Installiert Cloud SDK-Kernbibliotheken core 7,2 MiB
Installiert Cloud Storage-Befehlszeilentool gsutil 3,3 MiB
Installiert gcloud-Alphabefehle Alpha < 1 MiB
Installiert gcloud-Betabefehle Beta < 1 MiB
Installiert Python-Erweiterungen für gcloud app app-engine-python 6,1 MiB

Komponenten installieren

Führen Sie gcloud components install aus, um eine Komponente mit der aktuellen Version der gcloud CLI zu installieren:

gcloud components install [COMPONENT-ID]

Die gcloud-Befehlszeile installiert die angegebene Komponente.

Wenn Sie beispielsweise den Befehl kubectl installieren möchten, gehen Sie so vor:

gcloud components install kubectl

Komponenten aktualisieren

Verwenden Sie den Befehl gcloud components update, um alle installierten Komponenten auf die neueste verfügbare Version der gcloud CLI zu aktualisieren:

gcloud components update

Wenn eine ältere Version der gcloud CLI installiert ist, aktualisiert die gcloud CLI alle installierten Komponenten.

Wenn Sie zu einer zuvor als fehlerfrei bekannten Version zurückkehren und die gcloud CLI direkt (außerhalb eines Paketmanagers, einschließlich des interaktiven Installationsprogramms, statischer Versionen, des Windows-Installationsprogramms oder Homebrew) installieren müssen, verwenden Sie gcloud components update, um zur angegebenen Version zurückzukehren:

gcloud components update --version VERSION

Informationen zum Downgrade von Versionen der gcloud CLI, die mit einem Paketmanager installiert wurden, finden Sie in dieser Anleitung zum Angeben von Versionen beim Herunterladen mit apt-get oder yum.

Komponenten entfernen

Mit dem Befehl gcloud components remove entfernen Sie eine bestimmte Komponente anhand der zugehörigen ID:

gcloud components remove [COMPONENT-ID]

Sie können eine Komponente jederzeit mit dem Befehl gcloud components install neu installieren.

Zusätzliche Komponenten

Zusätzliche Komponenten, die Abhängigkeiten für gcloud CLI-Befehle enthalten, sind auch in der gcloud CLI verfügbar, werden aber nicht standardmäßig installiert. Für eine vollständige Liste der Komponenten führen Sie gcloud components list aus. Zusätzliche Komponenten, die installiert werden können, haben den Status Not Installed.

Externe Paketmanager

Wenn Sie die gcloud CLI über den Paketmanager apt oder yum installiert haben, können Sie auch zusätzliche Komponenten der gcloud CLI mit denselben Paketmanagern installieren. Wenn Ihr Paketmanager diese Pakete nicht finden kann, lesen Sie die Abschnitte Mit apt installieren oder Mit yum installieren, um Anleitungen zur Konfiguration von https://packages.cloud.google.com/ als Paketquelle zu erhalten.

Komponente der gcloud CLI APT-Paket YUM-Paket
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 Noch nicht verfügbar. Noch nicht verfügbar.
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