gcloud CLI-Komponenten verwalten

Komponenten sind die installierbaren Teile der Google Cloud CLI. Eine Komponente kann ein Befehlszeilentool wie gcloud, bq oder gsutil, eine Reihe von gcloud-Befehlen auf Alpha- oder Beta-Releasestufe 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 Befehl gcloud alpha oder gcloud beta ausführen und die Komponente alpha oder beta nicht installiert ist, werden Sie von der gcloud CLI gefragt, ob Sie diese Komponente 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 sie erfordern.

Standardkomponenten

Bei der Installation der gcloud CLI werden folgende Komponenten standardmäßig installiert:

ID Name Beschreibung
gcloud Standardmäßige gcloud-Befehlszeilenbefehle Tool für die Interaktion mit Trusted 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 Altes Tool für Cloud Storage-Aufgaben. Verwenden Sie stattdessen gcloud storage-Befehle.
core gcloud CLI-Kernbibliotheken Bibliotheken, die von den gcloud CLI-Tools intern verwendet werden.

Alpha- und Betakomponenten

Die gcloud CLI bietet zwei Komponenten, die Alpha- und Betabefehle der gcloud CLI enthalten. Diese Komponenten werden nicht standardmäßig installiert, können jedoch jederzeit nach der gcloud CLI-Erstinstallation manuell installiert werden. Diese Komponenten sind:

ID Name Beschreibung
alpha Alphabefehle der gcloud CLI gcloud-Kommandozeilenbefehle auf Alpha-Releasestufe
beta Betabefehle der gcloud CLI-Befehlszeile gcloud-Kommandozeilenbefehle auf Beta-Releasestufe

gcloud-Kommandozeilenbefehle auf der Releasestufe „Allgemeine Verfügbarkeit“ sind Teil der gcloud-Kommandozeilenkomponente und werden bei der Installation der gcloud CLI automatisch installiert.

Eine Liste aller verfügbaren zusätzlichen Komponenten und externen Paketmanager, die nicht standardmäßig installiert sind, finden Sie weiter unten.

Komponenten der gcloud CLI verwalten

Sie können gcloud CLI-Komponenten entsprechend Ihren Anforderungen auflisten, 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. Sie können die neuesten verfügbaren Komponenten aufrufen. Aktualisieren Sie hierzu die gcloud CLI-Installation und führen Sie 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 pubsub-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 Extensions app-engine-java 118,9 MiB
Installiert gcloud app PHP-Erweiterungen app-engine-php 21,9 MiB
Installiert gcloud app Python Extensions (Extra Libraries) 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 „gcloud app“-Python-Erweiterungen 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-Installation 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

Mit dem Befehl gcloud components update können Sie alle installierten Komponenten auf die neueste verfügbare Version der gcloud CLI aktualisieren:

gcloud components update

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

Wenn Sie ein Downgrade auf eine stabile ältere Version ausführen müssen und die gcloud CLI direkt (außerhalb eines Paketmanagers über das interaktive Installationsprogramm, statische Versionen, das Windows-Installationsprogramm oder Homebrew) installiert haben, verwenden Sie gcloud components update, um ein Downgrade auf die angegebene Version auszuführen:

gcloud components update --version VERSION

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 jedoch nicht standardmäßig installiert. Eine ausführliche Liste der Komponenten erhalten Sie mit dem Befehl gcloud components list. Zusätzliche Komponenten, die installiert werden können, haben den Status Not Installed.