SDK-Komponenten verwalten

Was sind Komponenten?

Komponenten sind die installierbaren Teile des SDK. 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 im SDK 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-Befehlszeile 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-Kommandozeile installiert, wenn Sie Befehle ausführen, die sie erfordern.

Standardkomponenten

Bei der Installation des SDKs 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 Google BigQuery.
gsutil Cloud Storage-Befehlszeilentool Tool für Aufgaben in Zusammenhang mit Google Cloud Storage.
core Cloud SDK-Kernbibliotheken Bibliotheken, die von den SDK-Tools intern verwendet werden.

Alpha- und Betakomponenten

Das SDK enthält zwei Komponenten, die die Alpha- und Betabefehle der gcloud-Kommandozeile enthalten. Diese Komponenten werden nicht standardmäßig installiert, können jedoch jederzeit nach der SDK-Erstinstallation manuell installiert werden. Diese Komponenten sind:

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

gcloud-Kommandozeilenbefehle auf den Releasestufen "Allgemeine Verfügbarkeit" und "Vorschau" sind Teil der gcloud-Kommandozeilenkomponente und werden bei der Installation des SDK automatisch installiert.

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

Cloud SDK-Komponenten verwalten

Sie können Google Cloud SDK-Komponenten entsprechend Ihren Anforderungen 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
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                          │
├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status    │                         Name                  │            ID            │    Size   │
├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
│ Installed     │ Cloud Datastore Emulator (Legacy)             │ gcd-emulator             │  38.1 MiB │
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ BigQuery Command Line Tool                    │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└───────────────┴───────────────────────────────────────────────┴──────────────────────────┴───────────┘

Die oben angezeigte Ausgabe ist keine erschöpfende Liste aller verfügbaren Komponenten. Sie können die neuesten verfügbaren Komponenten aufrufen. Aktualisieren Sie hierzu die Cloud SDK-Installation und führen Sie gcloud components list aus.

Komponenten installieren

Führen Sie gcloud components install aus, um eine Komponente mit der aktuellen Version der Cloud SDK-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 Cloud SDK-Version aktualisieren:

gcloud components update

Wenn Sie eine ältere Version von Cloud SDK installiert haben, aktualisiert die gcloud-Kommandozeile alle installierten Komponenten.

Verwenden Sie den Befehl gcloud components update, um ein Downgrade auf eine stabile ältere Version auszuführen. Voraussetzung ist, dass das SDK 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 Cloud SDK-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 verschiedene Befehle der gcloud-Befehlszeile enthalten, sind auch im SDK verfügbar, jedoch nicht standardmäßig installiert. Eine ausführliche Liste 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 das Cloud SDK über einen der Paketmanager apt oder yum installiert haben, können Sie mit demselben Paketmanager auch zusätzliche Cloud SDK-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.

Cloud SDK-Komponente APT-Paket YUM-Paket
app-engine-go google-cloud-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr Noch nicht verfügbar. Noch nicht verfügbar.
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator