Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Kurzanleitung: Anwendung mit Google Cloud Deploy in Cloud Run bereitstellen

Anwendung mit Google Cloud Deploy in Cloud Run bereitstellen

Auf dieser Seite wird beschrieben, wie Sie mit Google Cloud Deploy ein Beispielanwendungs-Image mit dem Namen hello in einer Sequenz von zwei Cloud Run-Diensten bereitstellen.

Dieser Schnellstart erläutert folgende Schritte:

  1. Skaffold-Konfiguration erstellen

  2. Erstellen Sie Dienstdefinitionsdateien für zwei Cloud Run-Dienste.

    Diese Dateien definieren die Dienste und geben das (vordefinierte) Container-Image an, das bereitgestellt werden soll.

  3. Definieren Sie Ihre Google Cloud Deploy-Bereitstellungspipeline und Bereitstellungsziele, die auf die beiden Dienste verweisen.

    Sie können Ihre Ziele in derselben Datei wie die Lieferpipeline oder in einer anderen Datei bzw. Dateien definieren. Der Einfachheit halber werden Sie meist in derselben Datei gespeichert.

  4. Instanziieren Sie Ihre Lieferpipeline. Dazu erstellen Sie einen Release, der automatisch für das erste Ziel bereitgestellt wird.

  5. Werben Sie den Release für das zweite Ziel.

  6. Sehen Sie sich beide Roll-outs in der Google Cloud Console an.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch 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.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  4. Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs aktivieren.

    Aktivieren Sie die APIs

  5. Installieren und initialisieren Sie Google Cloud CLI.
  6. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  7. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  8. Google Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs aktivieren.

    Aktivieren Sie die APIs

  9. Installieren und initialisieren Sie Google Cloud CLI.
  10. Wenn die Befehlszeile bereits installiert ist, prüfen Sie, ob Sie die neueste Version ausführen:

    gcloud components update
    

  11. Prüfen Sie, ob das Compute Engine-Standarddienstkonto die erforderlichen Berechtigungen hat.

    Das Dienstkonto hat möglicherweise bereits die erforderlichen Berechtigungen. Diese Schritte sind für Projekte erforderlich, die automatische Rollenzuweisungen für Standarddienstkonten deaktivieren.

    1. Fügen Sie die Rolle clouddeploy.jobRunner hinzu:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/clouddeploy.jobRunner"
      

    2. Gewähren Sie dem standardmäßigen Ausführungsdienstkonto actAs die Berechtigung zum Bereitstellen von Arbeitslasten in Cloud Run:

      gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/iam.serviceAccountUser" \
          --project=PROJECT_ID
      

    3. Fügen Sie die Cloud Run-Entwicklerberechtigungen hinzu:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/run.developer"
      

      Wenn Sie Probleme beim Hinzufügen dieser Rollen haben, wenden Sie sich an Ihren Projektadministrator.

Skaffold-Konfiguration vorbereiten

Google Cloud Deploy verwendet Skaffold, um die Details für die Bereitstellung und die korrekte Bereitstellung für Ihre separaten Ziele bereitzustellen.

In dieser Kurzanleitung erstellen Sie eine skaffold.yaml-Datei, die das Kubernetes-Manifest angibt, das zum Bereitstellen der Beispielanwendung verwendet werden soll.

  1. Öffnen Sie ein Terminalfenster.

  2. Erstellen Sie ein neues Verzeichnis mit dem Namen deploy-run-quickstart und rufen Sie dieses Verzeichnis auf.

    mkdir deploy-run-quickstart
    cd deploy-run-quickstart
    
  3. Erstellen Sie eine Datei mit dem Namen skaffold.yaml und mit folgendem Inhalt:

    apiVersion: skaffold/v3alpha1
    kind: Config
    metadata:
      name: deploy-run-quickstart
    profiles:
    - name: dev
      manifests:
        rawYaml:
        - run-dev.yaml
    - name: prod
      manifests:
        rawYaml:
        - run-prod.yaml
    deploy:
      cloudrun: {}
    

    Diese Datei ist eine minimale Skaffold-Konfiguration, die Ihre Cloud Run-Dienste identifiziert. Weitere Informationen zu dieser Datei finden Sie in der Referenz zu skaffold.yaml.

Cloud Run-Dienste vorbereiten

Für diese Kurzanleitung erstellen Sie zwei verschiedene Cloud Run-Dienste im selben Projekt. Google Cloud Deploy unterstützt auch die Bereitstellung in mehreren Projekten. Außerdem verwenden wir Skaffold-Profile, um zwei Dienste im selben Projekt zu ermöglichen. Wenn Sie verschiedene Projekte verwenden, benötigen Sie möglicherweise keine Skaffold-Profile.

  1. Erstellen Sie eine Datei mit dem Namen run-dev.yaml und mit folgendem Inhalt:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: deploy-qs-dev
    spec:
      template:
        spec:
          containers:
          - image: my-app-image
    

    Diese Datei definiert einen Cloud Run-Dienst. Wie der Name deploy-qs-dev bereits sagt, ist dies Ihr dev-Dienst und entspricht dem ersten Ziel im Fortschritt der Bereitstellungspipeline.

  2. Erstellen Sie eine Datei mit dem Namen run-prod.yaml und mit folgendem Inhalt:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: deploy-qs-prod
    spec:
      template:
        spec:
          containers:
          - image: my-app-image
    

    Diese Datei definiert den prod-Dienst.

Lieferpipeline und Ziele erstellen

Sie können Pipeline und Ziele in einer Datei oder in separaten Dateien definieren. In dieser Kurzanleitung erstellen Sie nur eine Datei.

  1. Erstellen Sie im deploy-run-quickstart-Verzeichnis die neue Datei clouddeploy.yaml mit folgendem Inhalt:

    apiVersion: deploy.cloud.google.com/v1
    kind: DeliveryPipeline
    metadata:
     name: my-run-demo-app-1
    description: main application pipeline
    serialPipeline:
     stages:
     - targetId: run-qsdev
       profiles: [dev]
     - targetId: run-qsprod
       profiles: [prod]
    ---
    
    apiVersion: deploy.cloud.google.com/v1
    kind: Target
    metadata:
     name: run-qsdev
    description: Cloud Run development service
    run:
     location: projects/PROJECT_ID/locations/us-central1
    ---
    
    apiVersion: deploy.cloud.google.com/v1
    kind: Target
    metadata:
     name: run-qsprod
    description: Cloud Run production service
    run:
     location: projects/PROJECT_ID/locations/us-central1
    
  2. Registrieren Sie Ihre Pipeline und Ziele beim Google Cloud Deploy-Dienst:

    gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
    

    Sie haben jetzt eine Pipeline mit Zielen und können Ihre Anwendung für das erste Ziel bereitstellen.

  3. Bestätigen Sie Pipeline und Ziele:

    Rufen Sie in der Google Cloud Console die Google Cloud Deploy-Seite Bereitstellungspipelines auf, um eine Liste der verfügbaren Bereitstellungspipelines zu sehen.

    Zur Seite der Lieferpipelines

    Die soeben erstellte Lieferpipeline wird angezeigt und die beiden Ziele werden in der Spalte Ziele aufgeführt.

    Bereitstellungspipeline in der Google Cloud Console angezeigt

Release erstellen

Ein Release ist die zentrale Ressource von Google Cloud Deploy, die die bereitgestellten Änderungen darstellt. Die Bereitstellungspipeline definiert den Lebenszyklus dieses Release. Weitere Informationen zu diesem Lebenszyklus finden Sie unter Dienstarchitektur von Google Cloud Deploy.

Führen Sie folgenden Befehl im Verzeichnis deploy-run-quickstart aus, um eine release-Ressource zu erstellen, die das bereitzustellende Container-Image darstellt:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=my-run-demo-app-1 \
  --images=my-app-image=gcr.io/cloudrun/hello

Da dieser Release der erste ist (er wird im ersten angegebenen Ziel bereitgestellt), erstellt Google Cloud Deploy automatisch auch eine rollout-Ressource. Die Anwendung wird automatisch für das erste Ziel in der Sequenz bereitgestellt.

Release hochstufen

  1. Klicken Sie auf der Seite Lieferpipelines auf die Pipeline my-run-demo-app-1.

    Zur Seite der Lieferpipelines

    Die Seite mit den Details der Lieferpipeline zeigt eine grafische Darstellung des Fortschritts der Lieferpipeline. In diesem Fall wird gezeigt, dass die Version am run-qsdev-Ziel bereitgestellt wurde.

    Visualisierung der Bereitstellungspipeline in der Google Cloud Console

  2. Klicken Sie für das erste Ziel in der Visualisierung der Lieferpipeline auf Hochstufen.

    Das Dialogfeld Release hochstufen wird angezeigt. Er zeigt die Details des Ziels an, zu dem Sie hochstufen.

  3. Klicken Sie auf Werben.

    Der Release wird jetzt für die Bereitstellung in qsprod in die Warteschlange gestellt. Wenn die Bereitstellung abgeschlossen ist, wird sie in der Visualisierung der Bereitstellungspipeline als bereitgestellt angezeigt:

    Visualisierung der Bereitstellungspipeline in der Google Cloud Console mit dem im Produktions-Release bereitgestellten Release

Ergebnisse in der Google Cloud Console ansehen

  1. Rufen Sie in der Google Cloud Console die Google Cloud Deploy-Seite Bereitstellungspipelines auf, um Ihre Bereitstellungspipeline my-run-demo-app-1 aufzurufen.

    Zur Seite der Lieferpipelines

  2. Klicken Sie auf den Namen Ihrer Bereitstellungspipeline „my-run-demo-app-1“.

    Die Pipelinevisualisierung zeigt den Fortschritt der Anwendung durch die Pipeline.

    Visualisierung der Bereitstellungspipeline in der Google Cloud Console

    Ihre Version wird auf dem Tab Releases unter Details zur Lieferpipeline aufgeführt.

  3. Klicken Sie auf den Releasenamen, test-release-001.

    Ihre Roll-outs werden unter Roll-outs angezeigt. Sie können auf ein Roll-out klicken, um die Details einschließlich des Bereitstellungsprotokolls anzusehen.

    Roll-outs in der Google Cloud Console

Bereinigen

So vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

  1. Löschen Sie den Cloud Run-Dienst deploy-qs-dev:

    gcloud run services delete deploy-qs-dev --region=us-central1 --project=PROJECT_ID
    
  2. Löschen Sie den Dienst deploy-qs-prod:

    gcloud run services delete deploy-qs-prod --region=us-central1 --project=PROJECT_ID
    
  3. Löschen Sie die Bereitstellungspipeline, einschließlich des Releases und der Roll-outs:

    gcloud deploy delivery-pipelines delete my-run-demo-app-1 --force --region=us-central1 --project=PROJECT_ID
    

    Dieser Befehl löscht die Lieferpipeline selbst sowie alle release- und rollout-Ressourcen, die Google Cloud Deploy für diese Pipeline erstellt hat.

  4. Löschen Sie die von Google Cloud Deploy erstellten Cloud Storage-Buckets.

    Eines davon endet mit _clouddeploy und das andere [region].deploy-artifacts.[project].appspot.com.

    Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte