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.

Überzeugen Sie sich selbst

Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie 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

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 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 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.

Hinweis: Diese Anleitung gilt nicht, wenn Sie die gcloud CLI mit einem Paketmanager wie APT oder yum installiert haben, weil der gcloud CLI-Komponentenmanager dann 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. 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
Informationen zum Downgrade von gcloud CLI-Versionen, die über einen Paketmanager installiert wurden, finden Sie in der Anleitung zum Angeben von Versionen beim Herunterladen über 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 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.

Externe Paketmanager

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