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.

Überzeugen Sie sich selbst

Wenn Sie mit Google Cloudnoch 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 standardmäßig die folgenden Komponenten installiert:

ID Name Beschreibung
gcloud Standardmäßige gcloud CLI-Befehle Tool für die Interaktion mit Google Cloud. 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.

Hinweis: Diese Anleitung funktioniert nicht, wenn Sie die gcloud CLI mit einem Paketmanager wie APT oder yum installiert haben, da der gcloud CLI-Komponentenmanager bei dieser Installationsmethode deaktiviert ist. Verwenden Sie stattdessen diese Pakete.

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
Wenn Sie die Version der gcloud CLI, die mit einem Paketmanager installiert wurde, downgraden möchten, finden Sie in dieser Anleitung Informationen 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 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.

Externe Paketmanager

Wenn Sie die gcloud CLI über den Paketmanager apt oder yum installiert haben, können Sie zusätzliche gcloud CLI-Komponenten auch über diese Paketmanager 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.

gcloud CLI-Komponente 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 google-cloud-cli-docker-credential-gcr google-cloud-cli-docker-credential-gcr
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