Komponenten der gcloud CLI verwalten

Komponenten sind die installierbaren Teile der Google Cloud CLI. Eine Komponente kann ein Befehlszeilentool (gcloud, bq und gsutil), eine Reihe von gcloud CLI-Befehlen auf den Release-Ebenen Alpha, Beta oder Vorschau 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 einen gcloud alpha-, gcloud beta- oder gcloud preview-Befehl interaktiv ausführen und die Komponente alpha, beta oder preview 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 von der gcloud CLI bei Bedarf installiert, wenn Sie Befehle ausführen, für die sie erforderlich sind.

Standardkomponenten

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

ID Name Beschreibung
gcloud Standardmäßige gcloud CLI-Befehle Tool für die Interaktion mit Cloud de Confiance. Mit dieser Komponente werden nur Befehle auf der Release-Stufe „Allgemeine Verfügbarkeit“ installiert. Sie müssen die Komponenten gcloud alpha-Befehle, gcloud beta-Befehle und/oder gcloud preview-Befehle separat installieren, wenn Sie Befehle auf anderen Release-Ebenen verwenden möchten.
bq BigQuery-Befehlszeilentool Tool für die Arbeit mit Daten in BigQuery.
gsutil Legacy-Tool zum Ausführen von Cloud Storage-Aufgaben. Verwenden Sie stattdessen gcloud storage-Befehle.
core gcloud CLI-Kernbibliotheken Bibliotheken, die intern von den gcloud CLI-Tools verwendet werden.

Alpha-, Beta- und Vorschaukomponenten

Die gcloud CLI bietet Komponenten, die Alpha-, Beta- und Vorschau-Befehle der gcloud CLI enthalten. Diese Komponenten werden nicht standardmäßig installiert, können aber jederzeit nach der ersten Installation der gcloud CLI manuell installiert werden. Diese Komponenten sind:

ID Name Beschreibung
alpha gcloud CLI-Alpha-Befehle gcloud CLI-Befehle auf Alpha-Release-Ebene.
beta gcloud CLI-Beta-Befehle gcloud CLI-Befehle auf Beta-Release-Ebene.
preview gcloud CLI-Vorschaubefehle gcloud CLI-Befehle auf der Vorabversionsebene.

gcloud CLI-Befehle auf der Release-Stufe „Allgemeine Verfügbarkeit“ sind Teil der gcloud CLI-Komponente und werden automatisch installiert, wenn Sie die gcloud CLI installieren.

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

gcloud CLI-Komponenten verwalten

Sie können gcloud CLI-Komponenten nach Bedarf 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. Wenn Sie die neuesten Komponentenangebote sehen möchten, aktualisieren Sie Ihre gcloud CLI-Installation 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
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 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
Nicht installiert gcloud-Vorschau-Befehle Vorschau < 1 MiB
Installiert gcloud app Python-Erweiterungen app-engine-python 6,1 MiB

Komponenten installieren

Wenn Sie eine Komponente in der aktuellen Version Ihrer gcloud CLI-Installation installieren möchten, führen Sie gcloud components install aus:

gcloud components install [COMPONENT-ID]

Die gcloud CLI 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 Sie eine ältere Version der gcloud CLI installiert haben, werden alle installierten Komponenten aktualisiert.

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

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 ebenfalls in der gcloud CLI verfügbar, werden aber nicht standardmäßig installiert. Eine vollständige Liste der Komponenten erhalten Sie mit gcloud components list. Zusätzliche Komponenten, die installiert werden können, haben den Status Not Installed.