Komponenten der gcloud CLI 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-, Beta- oder Vorschau 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 gcloud alpha, gcloud beta oder gcloud preview Befehl ausführen und die alpha, beta oder preview Komponente nicht installiert ist, werden Sie von der gcloud CLI gefragt, ob Sie diese 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 noch kein Konto haben Google Cloud, erstellen Sie eines, um die Leistung 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.

Kostenlos starten

Standardkomponenten

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

ID Name Beschreibung
gcloud Standardbefehle der gcloud CLI Tool für die Interaktion mit Google Cloud. Mit dieser Komponente werden nur Befehle der Releasestufe „Allgemeine Verfügbarkeit“ installiert. Wenn Sie Befehle anderer Releasestufen verwenden möchten, müssen Sie die Komponenten gcloud alpha Befehle, gcloud beta Befehle und/oder gcloud preview Befehle als separate Komponenten installieren.
bq BigQuery-Befehlszeilentool Tool für die Arbeit mit Daten in BigQuery
gsutil Älteres Tool für die Ausführung von Cloud Storage-Aufgaben. Verwenden Sie gcloud storage Befehle stattdessen.
core Kernbibliotheken der gcloud CLI Bibliotheken, die von den gcloud CLI-Tools intern 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, Sie können sie aber jederzeit nach der ersten Installation der gcloud CLI manuell installieren. Diese Komponenten sind:

ID Name Beschreibung
alpha gcloud-Alphabefehle gcloud CLI-Befehle auf der Alpha-Releasestufe.
beta gcloud-Betabefehle gcloud CLI-Befehle auf der Beta-Releasestufe.
preview gcloud CLI-Vorschau-Befehle gcloud CLI-Befehle auf der Vorschau-Releasestufe.

gcloud-Befehle auf der Releasestufe „Allgemeine Verfügbarkeit“ sind Teil der gcloud-Komponente 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.

gcloud CLI-Komponenten 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 MB
Installiert Cloud Bigtable-Befehlszeilentool cbt 4,0 MB
Installiert Cloud Bigtable-Emulator bigtable 3,8 MB
Installiert Cloud Datastore-Emulator cloud-datastore-emulator 17,8 MB
Nicht installiert Cloud Firestore-Emulator cloud-firestore-emulator 60,4 MB
Installiert Cloud Pub/Sub-Emulator pubsub-emulator 33,2 MB
Installiert Cloud SQL Proxy cloud_sql_proxy 7,6 MB
Installiert Cloud Spanner-Emulator cloud-spanner-emulator 21,8 MB
Installiert Google Cloud Build Local Builder cloud-build-local 4,4 MB
Installiert gcloud app Java-Erweiterungen app-engine-java 118,9 MB
Installiert gcloud app PHP-Erweiterungen app-engine-php 21,9 MB
Installiert gcloud app Python-Erweiterungen (Zusatzbibliotheken) app-engine-python-extras 27,8 MB
Installiert kubectl kubectl 12,2 MB
Installiert Cloud BigQuery-Befehlszeilentool bq < 1 MB
Installiert Cloud SDK-Kernbibliotheken core 7,2 MB
Installiert Cloud Storage-Befehlszeilentool gsutil 3,3 MB
Installiert gcloud-Alphabefehle Alpha < 1 MB
Installiert gcloud-Betabefehle Beta < 1 MB
Nicht installiert gcloud-Vorschau-Befehle Vorschau < 1 MB
Installiert gcloud app Python-Erweiterungen app-engine-python 6,1 MB

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 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 gcloud components update Befehl, 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, aktualisiert die gcloud CLI alle installierten Komponenten.

Verwenden Sie den Befehl gcloud components update, um ein Downgrade auf eine stabile ältere Version auszuführen. Voraussetzung ist, dass die gcloud CLI direkt (außerhalb eines Paketmanagers über das interaktive Installationsprogramm, statische Versionen, das Windows-Installationsprogramm oder Homebrew) installiert wurde.

gcloud components update --version VERSION
Informationen zum Downgrade von gcloud CLI-Versionen, die über einen Paket manager 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-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 die Paketmanager apt oder yum installiert haben, können Sie auch zusätzliche gcloud CLI-Komponenten mit denselben Paketmanagern installieren. Wenn Ihr Paketmanager diese Pakete nicht finden kann, lesen Sie die Mit apt installieren oder Mit yum installieren Abschnitte, 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