Anwendung mit Cloud Deploy in Cloud Run bereitstellen

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Deploy ein Beispielanwendungs-Image namens hello an eine Abfolge von zwei Cloud Run-Diensten oder zwei Cloud Run-Jobs senden.

Dieser Schnellstart erläutert folgende Schritte:

  1. Skaffold-Konfiguration erstellen

  2. Erstellen Sie Konfigurationsdateien für zwei Cloud Run-Dienste oder zwei Jobs.

    Diese Dateien definieren die Dienste oder Jobs und geben die (vordefinierten) Container-Images an, die bereitgestellt werden sollen.

  3. Definieren Sie die Bereitstellungspipeline und Ziele für die Cloud Deploy-Bereitstellung, die auf die beiden Dienste oder die beiden Jobs verweisen.

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

  5. Stufen Sie den Release zum zweiten Ziel hoch.

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

Hinweise

  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 Google Cloud-Projekt muss aktiviert sein.

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

    Aktivieren Sie die APIs

  5. Installieren Sie die Google Cloud CLI.

  6. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init
    7.

  7. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  8. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  9. Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs aktivieren.

    Aktivieren Sie die APIs

  10. Installieren Sie die Google Cloud CLI.

  11. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init
    12.

    Wenn Sie die Befehlszeile bereits installiert haben, prüfen Sie, ob es sich um die neueste Version handelt: 

    gcloud components update

  12. 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 enthalten, bei denen automatische Rollenzuweisungen für Standarddienstkonten deaktiviert werden.

    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 die Berechtigung zum Bereitstellen von Arbeitslasten in Cloud Run actAs: 

      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 einer dieser Rollen haben, wenden Sie sich an Ihren Projektadministrator.

Skaffold-Konfiguration vorbereiten

Cloud Deploy verwendet Skaffold, um Details zur Bereitstellung und zur ordnungsgemäßen Bereitstellung für Ihre separaten Ziele bereitzustellen.

Für diese Kurzanleitung erstellen Sie eine skaffold.yaml-Datei, die den Cloud Run-Dienst oder die Jobdefinition angibt, die 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:

    Dienste 

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

    Jobs 

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

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

Cloud Run-Dienste oder -Jobs vorbereiten

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

Dienste

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

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

    Diese Datei definiert einen Cloud Run-Dienst. Wie der Name deploy-run-service-dev schon sagt, ist dies Ihr dev-Dienst und entspricht dem ersten Ziel in der Abfolge der Bereitstellungspipeline.

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

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

    Diese Datei definiert einen weiteren Cloud Run-Dienst. Wie der Name deploy-run-service-prod impliziert, ist dies Ihr prod-Dienst und entspricht dem zweiten Ziel in der Abfolge der Bereitstellungspipeline.

Jobs

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

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: deploy-run-job-dev
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: my-app-image

    Diese Datei definiert einen Cloud Run-Job. Wie der Name deploy-run-job-dev schon sagt, ist dies Ihr dev-Job und entspricht dem ersten Ziel in der Abfolge der Bereitstellungspipeline.

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

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: deploy-run-job-prod
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: my-app-image

    Diese Datei definiert einen weiteren Cloud Run-Job. Wie der Name deploy-run-job-prod schon sagt, ist dies Ihr prod-Job und entspricht dem zweiten Ziel in der Verteilungspipeline.

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 Verzeichnis deploy-run-quickstart eine 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 mit dem 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 Cloud Deploy-Seite Bereitstellungspipelines auf, um eine Liste der verfügbaren Bereitstellungspipelines aufzurufen.

    Zur Seite der Lieferpipelines

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

    In der Google Cloud Console angezeigte Bereitstellungspipeline

Release erstellen

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

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

Dienste 

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:6063adf8f687702b4065151acddba6781c47bc602167eb9f3bec8aebc9ce95cc

Jobs 

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/job@sha256:d7c33651fbad911a9a0a0c16f2f9b3a79f0b9e3e89afb205603af706067feac5

Wie bei allen Releases (sofern sie nicht --disable-initial-rollout enthalten) erstellt Cloud Deploy automatisch eine Rollout-Ressource. Die Anwendung wird automatisch am ersten Ziel der Abfolge 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. Es zeigt die Details des Ziels, zu dem Sie hochstufen.

  3. Klicke auf Werben.

    Der Release wird jetzt zur Bereitstellung in run-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, die den in der Produktion bereitgestellten Release zeigt

Ergebnisse in der Google Cloud Console ansehen

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

    Zur Seite der Lieferpipelines

  2. Klicken Sie auf den Namen der 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 zugehörigen Details anzusehen, einschließlich des Bereitstellungslogs.

    Roll-outs in der Google Cloud Console

Auf Ihren Cloud Run-Dienst zugreifen

Sie müssen standardmäßig authentifiziert sein, um auf neu erstellte Cloud Run-Dienste zugreifen zu können. In der Authentifizierungsübersicht für Cloud Run erfahren Sie, wie Sie Anmeldedaten bereitstellen und welche Konfiguration von Identity and Access Management für den Zugriff auf den Dienst ohne Authentifizierung erforderlich ist. Dies gilt nicht für Cloud Run-Jobs.

Bereinigen

Mit den folgenden Schritten 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 oder -Job deploy-qs-dev:

    Dienste 

    gcloud run services delete deploy-run-service-dev --region=us-central1 --project=PROJECT_ID

    Jobs 

    gcloud run jobs delete deploy-run-job-dev --region=us-central1 --project=PROJECT_ID

  2. Löschen Sie den Dienst deploy-qs-prod:

    Dienste 

    gcloud run services delete deploy-run-service-prod --region=us-central1 --project=PROJECT_ID

    Jobs 

    gcloud run jobs delete deploy-run-job-prod --region=us-central1 --project=PROJECT_ID

  3. Löschen Sie die Bereitstellungspipeline, Ziele, den Release und die Roll-outs:

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

  4. Löschen Sie die Cloud Storage-Buckets, die von Cloud Deploy erstellt wurden.

    Eine endet mit _clouddeploy, die andere mit [region].deploy-artifacts.[project].appspot.com.

    Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte