Was sind Komponenten?
Komponenten sind die installierbaren Teile des SDK. Eine Komponente kann ein Befehlszeilentool wie gcloud, bq und gsutil, eine Reihe von gcloud-Kommandozeilenbefehlen 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 aus gcloud alpha oder gcloud beta ausführen und die Komponente alpha oder beta nicht installiert ist, werden Sie von der gcloud-Kommandozeile 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-Kommandozeilenbefehle | Tool für die Interaktion mit der Google Cloud Platform. 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-Kommandozeile | gcloud-Kommandozeilenbefehle auf Alpha-Releasestufe |
beta |
Betabefehle der gcloud-Kommandozeilenbefehle | 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
Führen Sie gcloud components list aus, um eine Liste der verfügbaren und aktuell installierten Komponenten aufzurufen:
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-Kommandozeile installiert die angegebene Komponente.
Geben Sie beispielsweise zum Installieren des kubectl-Befehls Folgendes ein:
gcloud components install kubectl
Komponenten aktualisieren
Mit dem Befehl gcloud components update aktualisieren Sie alle installierten Komponenten auf die neueste verfügbare Cloud SDK-Version:
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 Versionen des Cloud SDK, 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 Komponenten jederzeit mit dem Befehl gcloud components install wieder installieren.
Zusätzliche Komponenten
Zusätzliche Komponenten, die Abhängigkeiten für verschiedene gcloud-Kommandozeilenbefehle enthalten, sind auch im SDK verfügbar, jedoch nicht standardmäßig installiert. Einige dieser Komponenten sind nachfolgend aufgeführt. Eine ausführliche Liste erhalten Sie mit dem Befehl $ gcloud components list:
| ID | Name | Beschreibung |
|---|---|---|
app-engine-python |
gcloud-App-Python-Erweiterungen |
Google App Engine SDK-Pakete für Python. Diese werden installiert, wenn Sie mit dem Befehl gcloud app deploy eine Python-Anwendung in App Engine bereitstellen. |
app-engine-java |
gcloud-App-Java-Erweiterungen |
Google App Engine SDK-Pakete für Java. Diese werden installiert, wenn Sie mit dem Befehl gcloud app deploy eine Java-Anwendung in App Engine bereitstellen. |
app-engine-go |
gcloud-App-Go-Erweiterungen |
Google App Engine SDK-Pakete für Go. Diese werden installiert, wenn Sie mit dem Befehl gcloud app deploy eine Go-Anwendung in App Engine bereitstellen. |
gcd-emulator |
Cloud Datastore-Emulator | Emulator für Google Cloud Datastore. Dieser wird installiert, wenn Sie Befehle aus der Befehlsgruppe gcloud beta emulators datastore verwenden. |
pubsub-emulator |
Cloud Pub/Sub-Emulator | Emulator für Google Cloud Pub/Sub. Dieser wird installiert, wenn Sie Befehle aus der Befehlsgruppe gcloud beta emulators pubsub verwenden. |
cbt |
Cloud Bigtable-CLI | Google Cloud Bigtable-Befehlszeilentool |
cloud-build-local |
Cloud Build Local Builder | Google Cloud Build Local Builder |
bigtable |
Cloud Bigtable-Emulator | Emulator für Google Cloud Bigtable. Dieser wird installiert, wenn Sie Befehle aus der Befehlsgruppe gcloud beta emulators bigtable verwenden. |
kubectl |
kubectl |
Kubernetes-Befehlszeilentool. Wenn Sie Befehle aus der Befehlsgruppe gcloud container ausführen, werden Sie zur Installation dieser Komponente aufgefordert. kubectl wird zwar nicht zur Erstellung von Container-Clustern benötigt, jedoch für ihre Ausführung. |
docker-credential-gcr |
docker-credential-gcr |
Docker Credential Helper für Google Container Registry. Aktivieren Sie diese Komponente nach der Installation, indem Sie docker-credential-gcr configure-docker ausführen.
Weitere Informationen finden Sie im Projekt auf GitHub. |
datalab |
datalab |
Cloud Datalab-Befehlszeilentool. |
cloud-build-local |
Google Cloud Build Local |
Lokales Tool für Cloud Build. Nach der Installation können Sie Builds auf Ihrem lokalen Rechner ausführen. Weitere Informationen finden Sie unter Lokale Erstellung und Fehlerbehebung. |
Externe Paketmanager
Falls Sie das Cloud SDK mit einem externen Paketmanager wie APT, über das deb-Format oder YUM installiert haben, können Sie zusätzliche Komponenten installieren, siehe folgende Tabelle.
| 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 |
