Diese Seite wurde von der Cloud Translation API übersetzt.

Hochstufen von Releases und Fortsetzen von Roll-outs in Cloud Deploy automatisieren

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Deploy eine Version automatisch auf ein Ziel hochstufen und ein Roll-out in die nächste Phase übergehen.

Dieser Schnellstart erläutert folgende Schritte:

Erstellen Sie zwei GKE-Cluster oder zwei Cloud Run-Dienste.
Erstellen Sie eine Skaffold-Konfiguration und entweder ein Kubernetes-Manifest oder eine Cloud Run-Dienstdefinition.
Definieren Sie Ihre Cloud Deploy-Bereitstellungspipeline und Bereitstellungsziele.

Die Pipeline wird auf zwei Ziele bereitgestellt: dev und staging. Für das Ziel staging wird eine Canary-Bereitstellungsstrategie verwendet.
Definieren Sie zwei Automatisierungsregeln:
- Eine Automatisierung, die den Release nach erfolgreichem Roll-out auf dev auf das Ziel staging hochstuft.
- Eine Automatisierung, die das Roll-out nach Abschluss der Phase canary-25 in die Phase stable fortsetzt.
Instanziieren Sie Ihre Bereitstellungspipeline. Dazu erstellen Sie einen Release, der automatisch für das dev-Ziel bereitgestellt wird.
Rufen Sie die Lieferpipeline und den Release in der Google Cloud Console auf.

Aufgrund der automatischen Umstellung wird dieser Release automatisch in die staging hochgestuft.

Da für das Ziel staging eine Canary-Bereitstellungsstrategie verwendet wird und dies die erste Bereitstellung in dieser Laufzeit ist, wird die Phase canary-25 übersprungen. Weitere Informationen dazu, warum die Canary-Phase beim ersten Mal übersprungen wird, finden Sie unter Warum Phasen manchmal übersprungen werden.

Aufgrund der automatischen Phasenüberleitung wird das Roll-out in die Phase stable fortgesetzt.

Hinweise

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, Cloud Run, and Cloud Storage APIs.

Enable the APIs

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, Cloud Run, and Cloud Storage APIs.

Enable the APIs

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Wenn Sie die Befehlszeile bereits installiert haben, prüfen Sie, ob Sie die neueste Version verwenden:

gcloud components update

Achten Sie darauf, dass das Compute Engine-Standarddienstkonto ausreichend Berechtigungen hat.

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

Fügen Sie zuerst 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"

Die clouddeploy.releaser-Rolle hinzufügen:

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.releaser"

Fügen Sie die Entwicklerrolle für Ihre jeweilige Laufzeit hinzu.

Für GKE:

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

Für Cloud Run:

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"

Fügen Sie die Rolle iam.serviceAccountUser hinzu, die die Berechtigung actAs für das Standarddienstkonto zum Bereitstellen in der Laufzeit umfasst:

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

Fügen Sie sich die Rolle iam.serviceAccountUser mit der Berechtigung actAs hinzu, um das Standarddienstkonto zu verwenden:

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

In diesem Fall ist YOUR_EMAIL_ADDRESS die E-Mail-Adresse, mit der Sie auf Google Cloud zugreifen.

Laufzeitumgebungen erstellen

Wenn Sie die Bereitstellung in Cloud Run ausführen, können Sie diesen Befehl überspringen.

Erstellen Sie für GKE zwei Cluster: automation-quickstart-cluster-dev und automation-quickstart-cluster-staging mit den Standardeinstellungen. Die Kubernetes API-Endpunkte der Cluster müssen über das öffentliche Internet erreichbar sein. GKE-Cluster sind standardmäßig extern zugänglich.

gcloud container clusters create-auto automation-quickstart-cluster-dev \
                 --project=PROJECT_ID \
                 --region=us-central1 \
                 && gcloud container clusters create-auto automation-quickstart-cluster-staging \
                 --project=PROJECT_ID \
                 --region=us-central1

Rufen Sie Ihre Projektnummer ab.

Sie benötigen Ihre Projektnummer, um das Standarddienstkonto zu identifizieren. Dies ist für die Konfiguration der Automatisierungsressource erforderlich.

Führen Sie den folgenden Befehl aus, um Ihre Projektnummer zu ermitteln:
```
gcloud projects describe PROJECT_ID
```
Kopieren Sie die Projektnummer aus der Befehlszeilenausgabe und fügen Sie sie hier ein.

Sie müssen diesen Befehl nicht ausführen. Wenn Sie es hier einfügen, wird die Dienstkontoreferenz später in dieser Kurzanleitung in der Automatisierungskonfiguration eingefügt.
```
PROJECT_NUMBER
```

Skaffold-Konfiguration und Anwendungsmanifest vorbereiten

Cloud Deploy verwendet Skaffold, um Details zu den bereitzustellenden Elementen und deren korrekte Bereitstellung für separate Ziele anzugeben.

In dieser Kurzanleitung erstellen Sie eine skaffold.yaml-Datei, die das Anwendungsmanifest angibt, das für die Bereitstellung der Beispielanwendung verwendet werden soll.

Öffnen Sie ein Terminalfenster.

Erstellen Sie ein neues Verzeichnis und rufen Sie es auf.

GKE

mkdir deploy-automation-gke-quickstart
cd deploy-automation-gke-quickstart

Cloud Run

mkdir deploy-automation-run-quickstart
cd deploy-automation-run-quickstart

Erstellen Sie eine Datei mit dem Namen skaffold.yaml und mit folgendem Inhalt:

GKE

apiVersion: skaffold/v4beta7
kind: Config
metadata:
  name: gke-automation
manifests:
  rawYaml:
  - k8s-deployment.yaml
deploy:
  kubectl: {}

Cloud Run

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

Diese Datei ist eine minimale Skaffold-Konfiguration. In dieser Kurzanleitung erstellen Sie die Datei. Sie können aber auch Cloud Deploy bitten, eine für Sie zu erstellen, wenn es sich um einfache Anwendungen handelt, die nicht für die Produktion bestimmt sind.

Weitere Informationen zu dieser Datei finden Sie in der skaffold.yaml-Referenz.

Erstellen Sie die Definition für Ihre Anwendung – ein Paar Dienstdefinitionen für Cloud Run oder ein Kubernetes-Manifest für GKE.

GKE

Erstellen Sie eine Datei mit dem Namen k8s-deployment.yaml und folgendem Inhalt:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
  labels:
    app: my-app
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: nginx
        image: my-app-image
---
apiVersion: v1
kind: Service
metadata:
  name: my-service
  namespace: default
spec:
  selector:
    app: my-app
  ports:
    - protocol: TCP
      port: 80

Diese Datei ist ein einfaches Kubernetes-Manifest, das zum Bereitstellen der Anwendung verwendet wird. Das bereitzustellende Container-Image wird hier als Platzhalter (my-app-image) festgelegt. Es wird durch das spezifische Image ersetzt, wenn Sie die Version erstellen.

Cloud Run

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

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

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

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

Diese Dateien sind einfache Cloud Run-Dienstdefinitionen, die zum Bereitstellen der Anwendung verwendet werden. Das zu implementierende Container-Image wird hier als Platzhalter (my-app-image) festgelegt. Es wird durch das spezifische Image ersetzt, wenn Sie die Version erstellen.

Bereitstellungspipeline, Ziele und Automatisierung erstellen

Sie können die Lieferpipeline und die Ziele in einer Datei oder in separaten Dateien definieren. Sie können eine Automatisierungsaktion auch in einer separaten Datei definieren. In dieser Kurzanleitung wird eine Datei für Pipeline, Ziele und Automatisierung verwendet.

So erstellen Sie eine Bereitstellungspipeline, Zieldefinitionen und eine Automatisierungsaktion:

GKE

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

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-automation-demo-app-1
description: Automation demonstration pipeline
serialPipeline:
  stages:
  - targetId: automation-quickstart-dev
  - targetId: automation-quickstart-staging
    profiles: []
    strategy:
      canary:
        runtimeConfig:
          kubernetes:
            serviceNetworking:
              service: "my-service"
              deployment: "my-deployment"
        canaryDeployment:
          percentages: [25]
          verify: false
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: automation-quickstart-dev
description: Dev cluster to demonstrate deploy automation
gke:
  cluster: projects/PROJECT_ID/locations/us-central1/clusters/automation-quickstart-cluster-dev
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: automation-quickstart-staging
description: Staging cluster to demonstrate deploy automation
gke:
  cluster: projects/PROJECT_ID/locations/us-central1/clusters/automation-quickstart-cluster-staging
---

apiVersion: deploy.cloud.google.com/v1
kind: Automation
metadata:
  name: my-automation-demo-app-1/promote
description: promotes a release
suspended: false
serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
selector:
  targets:
  - id: automation-quickstart-dev
rules:
- promoteReleaseRule:
    name: "promote-release"
    wait: 1m
    toTargetId: "@next"
---

apiVersion: deploy.cloud.google.com/v1
kind: Automation
metadata:
  name: my-automation-demo-app-1/advance
description: advances a rollout
suspended: false
serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
selector:
  targets:
  - id: automation-quickstart-staging
rules:
- advanceRolloutRule:
    name: "advance-rollout"
    sourcePhases: ["canary-25"]
    wait: 1m

Cloud Run

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

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-automation-demo-app-1
description: Automation demonstration pipeline
serialPipeline:
  stages:
  - targetId: automation-quickstart-dev
    profiles: [dev]
  - targetId: automation-quickstart-staging
    profiles: [staging]
    strategy:
      canary:
        runtimeConfig:
          cloudRun:
            automaticTrafficControl: true
        canaryDeployment:
          percentages: [25]
          verify: false
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: automation-quickstart-dev
description: Dev cluster to demonstrate deploy automation
run:
  location: projects/PROJECT_ID/locations/us-central1
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: automation-quickstart-staging
description: Staging cluster to demonstrate deploy automation
run:
  location: projects/PROJECT_ID/locations/us-central1
---

apiVersion: deploy.cloud.google.com/v1
kind: Automation
metadata:
  name: my-automation-demo-app-1/promote
description: Promotes a release to the next target
suspended: false
serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
selector:
  targets:
  - id: automation-quickstart-dev
rules:
- promoteReleaseRule:
    name: "promote-release"
    wait: 1m
    toTargetId: "@next"
---

apiVersion: deploy.cloud.google.com/v1
kind: Automation
metadata:
  name: my-automation-demo-app-1/advance
description: advances a rollout
suspended: false
serviceAccount: PROJECT_NUMBER-compute@developer.gserviceaccount.com
selector:
  targets:
  - id: automation-quickstart-staging
rules:
- advanceRolloutRule:
    name: "advance-rollout"
    sourcePhases: ["canary-25"]
    wait: 1m

Registrieren Sie Ihre Pipeline und Ziele beim Cloud Deploy-Dienst:
```
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
```
Sie haben jetzt eine Pipeline mit einem Mehrfachziel, das aus zwei GKE- oder Cloud Run-Zielen besteht, und können Ihre Anwendung bereitstellen.
Bestätigen Sie Pipeline und Ziele:

Rufen Sie in der Google Cloud Console die Seite Lieferpipelines von Cloud Deploy auf, um eine Liste der verfügbaren Lieferpipelines aufzurufen.

Zur Seite der Lieferpipelines

Die soeben erstellte Bereitstellungspipeline wird angezeigt. In der Spalte Ziele sind zwei Ziele aufgeführt.
Klicken Sie auf den Namen der Pipeline, um die Visualisierung und die Details der Lieferpipeline zu öffnen.
Wählen Sie unter Details zur Bereitstellungspipeline den Tab Automatisierungen aus.

Die beiden von Ihnen erstellten Automatisierungen werden angezeigt.

Release erstellen

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

GKE

Führen Sie folgenden Befehl im Verzeichnis deploy-automation-gke-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-automation-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa

Beachten Sie das --images=-Flag, mit dem Sie den Platzhalter (my-app-image) im Manifest durch das spezifische, SHA-qualifizierte Image ersetzen. Google empfiehlt, Ihre Manifeste auf diese Weise zu modellieren und beim Erstellen von Releases SHA-qualifizierte Image-Namen zu verwenden.

Cloud Run

Führen Sie folgenden Befehl im Verzeichnis deploy-automation-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-automation-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4

Beachten Sie das --images=-Flag, mit dem Sie den Platzhalter (my-app-image) in der Dienstdefinition durch das spezifische, SHA-qualifizierte Image ersetzen. Google empfiehlt, Ihre Dienst- und Jobdefinitionen auf diese Weise zu modellieren und beim Erstellen von Releases SHA-qualifizierte Image-Namen zu verwenden.

Wenn Sie einen Release erstellen, wird standardmäßig automatisch ein Roll-out für das erste Ziel in Ihrer Pipeline erstellt.

Da diese Kurzanleitung zwei Automatisierungen enthält, geschieht Folgendes automatisch:

Nach einer erfolgreichen Bereitstellung im ersten Ziel wird der Release automatisch auf das zweite Ziel hochgestuft.

Die Automatisierung der Werbung dauert eine Minute.
Beim zweiten Ziel, für das ein Canary mit 25% konfiguriert ist, führt die zweite Automatisierung das Roll-out von canary-25 auf stable fort.

Bei diesem ersten Release wird die Phase canary-25 übersprungen, da es keine vorhandene Version der App gibt, mit der der Canary verglichen werden kann. Das Roll-out wird automatisch auf stable fortgesetzt.

Die Vorab-Automatisierung hat eine Verzögerung von einer Minute.

Wenn alles abgeschlossen ist, wird die Anwendung erfolgreich auf beiden Zielen bereitgestellt, ohne dass Sie weitere Maßnahmen ergreifen müssen.

Weitere Informationen zum Ausführen einer Canary-Bereitstellungsstrategie finden Sie in der Canary-Schnellstartanleitung.

Ergebnisse in der Google Cloud Console ansehen

Sie können die Ergebnisse, einschließlich der Automatisierungsläufe, in der Google Cloud Console aufrufen.

Rufen Sie die Seite Bereitstellungspipelines von Cloud Deploy auf, um Ihre Bereitstellungspipeline aufzurufen.

Zur Seite der Lieferpipelines
Klicken Sie auf den Namen der Lieferpipeline „my-automation-demo-app-1“.

Die Pipelinevisualisierung zeigt den Bereitstellungsstatus der App. Nach ausreichender Zeit werden beide Ziele grün angezeigt.

Ihre Version wird auf dem Tab Releases unter Details zur Lieferpipeline aufgeführt.
Klicken Sie auf den Tab Automatisierungsläufe.

Es gibt zwei Einträge, einen für jede der beiden von Ihnen erstellten Automatisierungen. Sie können auf einen der beiden Links klicken, um die Details der Automatisierungsausführung aufzurufen.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Löschen Sie die GKE-Cluster oder Cloud Run-Dienste:

GKE

gcloud container clusters delete automation-quickstart-cluster-dev --region=us-central1 --project=PROJECT_ID \
&& gcloud container clusters delete automation-quickstart-cluster-staging --region=us-west1 --project=PROJECT_ID

Cloud Run

gcloud run services delete my-automation-run-service-dev --region=us-central1 --project=PROJECT_ID \
&& gcloud run services delete my-automation-run-service-staging --region=us-central1 --project=PROJECT_ID

So löschen Sie die Bereitstellungspipeline, Ziele, Automatisierungen, Releases und Roll-outs:

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

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

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

Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Hochstufen von Releases und Fortsetzen von Roll-outs in Cloud Deploy automatisieren

Hinweise

Laufzeitumgebungen erstellen

Rufen Sie Ihre Projektnummer ab.

Skaffold-Konfiguration und Anwendungsmanifest vorbereiten

GKE

Cloud Run

GKE

Cloud Run

GKE

Cloud Run

Bereitstellungspipeline, Ziele und Automatisierung erstellen

GKE

Cloud Run

Release erstellen

GKE

Cloud Run

Ergebnisse in der Google Cloud Console ansehen

Bereinigen

GKE

Cloud Run

Nächste Schritte