Docker-Image der Google Cloud CLI installieren

Mit dem Docker-Image der Google Cloud CLI können Sie eine bestimmte Version der gcloud CLI als Docker-Image aus Artifact Registry abrufen und Google Cloud CLI-Befehle in einem isolierten, korrekt konfigurierten Container schnell ausführen.

Das Docker-Image der Google Cloud CLI ist die gcloud CLI, die auf einem Debian- oder Alpine-Image installiert wird. Das Docker-Image wird in Artifact Registry mit dem folgenden Repository-Namen gehostet: gcr.io/google.com/cloudsdktool/google-cloud-cli. Die Images sind auch mit den Repositories us.gcr.io, eu.gcr.io und asia.gcr.io verfügbar.

Docker-Image-Optionen

Es gibt fünf Docker-Images für die Google Cloud CLI: „latest“, „slim“, „emulators“, „debian_component_based“ und „Alpin“. Sie können dies mithilfe des entsprechenden Tags nach dem Namen des Host-Repositorys festlegen:

  • :latest, :VERSION: großes (Debian-basiertes) Image mit vorinstallierten zusätzlichen Komponenten
  • :slim, :VERSION-slim: kleineres (Debian-basiertes) Image ohne vorinstallierte Komponenten.
  • :emulators, :VERSION-emulators: kleineres (Debian-basiertes) Image mit vorinstallierten Emulatorkomponenten
  • :alpine, :VERSION-alpine: Kleinstes (Alpine-basiertes) Image ohne installierte zusätzliche Komponenten. Dieses Image unterstützt linux/arm.
  • :debian_component_based, :VERSION-debian_component_based: Debian-basiert mit allen Komponenten Im Gegensatz zu :latest, das deb-Pakete verwendet hat, nutzt dieses Image den Komponentenmanager zur Installation von Komponenten. Dieses Image unterstützt linux/arm.

Ein bestimmtes Docker-Image installieren

  1. Um das Image des neuesten Release der Google Cloud CLI, gcr.io/google.com/cloudsdktool/google-cloud-cli:latest, zu verwenden, rufen Sie es aus Artifact Registry ab. Führen Sie dazu den folgenden Befehl aus:

    docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:latest
    
  2. Wenn Sie die neueste Version abgerufen haben, prüfen Sie die Installation, indem Sie Folgendes ausführen:

    docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:latest gcloud version
    

    Wenn Sie eine bestimmte Version abgerufen haben, prüfen Sie die Installation. Führen Sie dazu einen Befehl wie im folgenden Beispiel aus:

    docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:<release_version> gcloud version
    
  3. Authentifizieren Sie sich mit der Google Cloud CLI, indem Sie folgenden Befehl ausführen:

    docker run -ti --name gcloud-config gcr.io/google.com/cloudsdktool/google-cloud-cli gcloud auth login
    

    Nach der erfolgreichen Authentifizierung werden die Anmeldedaten im Volume von gcloud-config container aufbewahrt.

  4. Führen Sie den Container mit --volumes-from aus, um Compute-Instanzen aufzulisten, die diese Anmeldedaten zur Prüfung verwenden:

    docker run --rm --volumes-from gcloud-config gcr.io/google.com/cloudsdktool/google-cloud-cli gcloud compute instances list --project your_project
    

Zusätzliche Komponenten installieren

Standardmäßig sind in den neuesten Images (gcr.io/google.com/cloudsdktool/google-cloud-cli:latest und gcr.io/google.com/cloudsdktool/google-cloud-cli:VERSION) alle Komponenten der Google Cloud CLI installiert.

Bei den Images gcr.io/google.com/cloudsdktool/google-cloud-cli:slim, gcr.io/google.com/cloudsdktool/google-cloud-cli:emulators und gcr.io/google.com/cloudsdktool/google-cloud-cli:alpine sind jedoch keine zusätzlichen Komponenten vorinstalliert.

Wenn Sie zusätzliche Komponenten für Alpine-basierte Images installieren möchten, erstellen Sie ein Dockerfile, das das Image der Google Cloud CLI als Basis-Image verwendet. Wenn Sie beispielsweise die Komponenten kubectl und app-engine-java hinzufügen möchten, erstellen Sie ein Dockerfile, das so aussieht:

FROM gcr.io/google.com/cloudsdktool/google-cloud-cli:alpine
RUN apk --update-cache add openjdk7-jre
RUN gcloud components install app-engine-java kubectl

Wenn openjdk7-jre nicht funktioniert, versuchen Sie es mit openjdk8-jre.

Führen Sie anschließend den folgenden Befehl aus:

docker build -t my-cloud-sdk-docker:alpine .

Bestimmte Versionen der Google Cloud CLI installieren

Wenn Sie bestimmte Versionen der Google Cloud CLI installieren möchten, geben Sie Ihre bevorzugte Version der gcloud CLI an, wenn Sie den Befehl docker build ausführen:

docker build -t my-cloud-sdk-docker:alpine --build-arg CLOUD_SDK_VERSION=<release_version> .

Prüfen Sie die aktuelle Version der Google Cloud CLI und alle früheren Versionen der Google Cloud CLI.