Diese Seite wurde von der Cloud Translation API übersetzt.

Bereitstellungsparameter verwenden

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Deploy eine Beispielanwendung gleichzeitig an zwei Ziele bereitstellen (parallele Bereitstellung), wobei Sie jedem gerenderten Manifest oder jeder Dienstdefinition mithilfe von drei verschiedenen Methoden einen anderen Parameterwert übergeben.

Dieser Schnellstart erläutert folgende Schritte:

Erstellen Sie zwei GKE-Cluster oder zwei Cloud Run-Dienste.

Sie können auch GKE Enterprise-Cluster verwenden, aber in dieser Kurzanleitung werden Nur GKE und Cloud Run.
Erstellen Sie eine Skaffold-Konfiguration und entweder ein Kubernetes- Manifest oder eine Cloud Run-Dienstdefinition.

Die Manifest- oder Dienstdefinition ist für beide untergeordneten Zielen, aber zum Zeitpunkt der Bereitstellung hat das gerenderte Manifest oder die Dienstdefinition für jedes untergeordnete Ziel verschiedene Werte für die spezifischen Parameter an, die in dieser Kurzanleitung konfiguriert wurden.
Definieren Sie Ihre Cloud Deploy-Bereitstellungspipeline und Bereitstellungsziele.

Diese Pipeline enthält ein Multi-Ziel, das auf zwei untergeordnete Ziele verweist, um Ihre App an die beiden Cluster oder Dienste zu liefern.
Sie können Bereitstellungsparameter an drei verschiedenen Stellen definieren:
- In der Pipelineentwicklung
- Für die untergeordneten Ziele
- In der Befehlszeile beim Erstellen des Release
Instanziieren Sie Ihre Bereitstellungspipeline, indem Sie einen Release erstellen, der automatisch die Bereitstellungen gleichzeitig auf den beiden Zielen erfolgen.
„Controller-Roll-out“ ansehen und untergeordnete Roll-outs in der Google Cloud Console.

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, achten Sie darauf, dass Sie die neueste Version:

gcloud components update

Prüfen Sie, ob das Compute Engine-Standarddienstkonto die erforderlichen 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"

Fügen Sie die Entwicklerrolle für die 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 enthält die Berechtigung actAs zur Bereitstellung in der Laufzeit:

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

Laufzeitumgebungen erstellen

Wenn Sie eine Bereitstellung in Cloud Run vornehmen, können Sie diesen Befehl überspringen.

Erstellen Sie für GKE zwei Cluster: deploy-params-cluster-prod1 und deploy-params-cluster-prod2 mit den Standardeinstellungen. Die Kubernetes API-Endpunkte der Cluster müssen über das öffentliche Internet erreichbar sein. Auf GKE-Cluster kann standardmäßig extern zugegriffen werden.

gcloud container clusters create-auto deploy-params-cluster-prod1 \
                 --project=PROJECT_ID \
                 --region=us-central1 \
                 && gcloud container clusters create-auto deploy-params-cluster-prod2 \
                 --project=PROJECT_ID \
                 --region=us-west1

Skaffold-Konfiguration und -Manifeste 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, in der das Kubernetes-Manifest oder die Cloud Run-Dienstdefinition angegeben wird, die zum Bereitstellen der Beispielanwendung verwendet werden soll.

Öffnen Sie ein Terminalfenster.

Erstellen Sie ein neues Verzeichnis und wechseln Sie zu diesem Verzeichnis.

GKE

mkdir deploy-params-gke-quickstart
cd deploy-params-gke-quickstart

Cloud Run

mkdir deploy-params-run-quickstart
cd deploy-params-run-quickstart

Erstellen Sie eine Datei mit dem Namen skaffold.yaml und mit folgendem Inhalt:
GKE
```
apiVersion: skaffold/v4beta7
kind: Config
manifests:
  rawYaml:
  - kubernetes.yaml
deploy:
  kubectl: {}
```
Cloud Run
```
apiVersion: skaffold/v4beta7
kind: Config
manifests:
  rawYaml:
  - service.yaml
deploy:
  cloudrun: {}
```
Diese Datei ist eine minimale Skaffold-Konfiguration. Für diese Kurzanleitung erstellen Sie die -Datei. Sie können aber auch eine von Cloud Deploy erstellen lassen, für einfache Nicht-Produktionsumgebungen.

Siehe Referenz zu skaffold.yaml finden Sie weitere Informationen zu dieser Datei.

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

GKE

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

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  replicas: 1 # from-param: ${replicaCount}
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
      annotations:
        commit: defaultShaValue # from-param: ${git-sha}
    spec:
      containers:
      - name: nginx
        image: my-app-image
        env:
        - name: envvar1
          value: default1 # from-param: ${application_env1}
        - name: envvar2
          value: default2 # from-param: ${application_env2}

Diese Datei ist ein einfaches Kubernetes Manifest das auf den Cluster angewendet wird, um die Anwendung bereitzustellen.

Cloud Run

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

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: my-parallel-run-service
spec:
  autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      annotations:
        commit: defaultShaValue # from-param: ${git-sha}
    spec:
      containers:
      - image: my-app-image
        env:
        - name: envvar1
          value: defaultValue1 # from-param: ${application_env1}
        - name: envvar2
          value: defaultValue2 # from-param: ${application_env2}

Diese Datei ist eine einfache Cloud Run-Dienstdefinition, der bei der Bereitstellung zum Erstellen von Cloud Run verwendet wird Service.

Lieferpipeline und Ziele erstellen

Sie können Pipeline und Ziele in einer Datei oder in separaten Dateien definieren. In erstellen wir eine einzelne Datei.

Erstellen Sie die Bereitstellungspipeline und die Zieldefinition:

GKE

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

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-params-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: params-prod-multi
    deployParameters:
    - values:
        replicaCount: "2"
      matchTargetLabels:
        label1: label1
    - values:
        replicaCount: "3"
      matchTargetLabels:
        label2: label2
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-multi
description: production clusters
multiTarget:
  targetIds: [params-prod-a, params-prod-b]
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-a
  labels:
    label1: label1
description: production cluster 1
deployParameters:
  application_env1: "sampleValue1"
gke:
  cluster: projects/PROJECT_ID/locations/us-central1/clusters/deploy-params-cluster-prod1
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-b
  labels:
    label2: label2
description: production cluster 2
deployParameters:
  application_env2: "sampleValue2"
gke:
  cluster: projects/PROJECT_ID/locations/us-west1/clusters/deploy-params-cluster-prod2

Cloud Run

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

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-params-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: params-prod-multi
    deployParameters:
    - values:
        minInstances: "2"
      matchTargetLabels:
        label1: label1
    - values:
        minInstances: "3"
      matchTargetLabels:
        label2: label2
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-multi
description: production clusters
multiTarget:
  targetIds: [params-prod-a, params-prod-b]
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-a
  labels:
    label1: label1
description: production cluster 1
deployParameters:
  application_env1: "sampleValue1"
run:
  location: projects/PROJECT_ID/locations/us-central1
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: params-prod-b
  labels:
    label2: label2
description: production cluster 2
deployParameters:
  application_env2: "sampleValue2"
run:
  location: projects/PROJECT_ID/locations/us-west1

Registrieren Sie Ihre Pipeline und Ziele beim Cloud Deploy-Dienst:
```
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID 
```
Sie haben nun eine Pipeline mit mehreren Zielen, GKE- oder Cloud Run-Ziele, die sofort bereitgestellt werden können Ihre Anwendung.
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 Lieferpipeline wird angezeigt. Wie Sie sehen, gibt es eine in der Spalte Ziele aufgelistet, obwohl Sie drei Ziele (ein Mehrfachziel und zwei untergeordnete Ziele) in Ihren clouddeploy.yaml -Datei.

Beachten Sie, dass als einziges Ziel params-prod-multi mit mehreren Zielen aufgeführt ist. Kind Ziele werden nicht angezeigt.

Release erstellen

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

GKE

Führen Sie den folgenden Befehl über die deploy-gke-parallel-quickstart aus. Verzeichnis zum Erstellen einer release-Ressource, die den Container darstellt bereitzustellendes Image:

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-params-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa \
   --deploy-parameters="git-sha=f787cac"

Cloud Run

Führen Sie den folgenden Befehl über die deploy-run-parallel-quickstart aus. Verzeichnis zum Erstellen einer release-Ressource, die den Container darstellt bereitzustellendes Image:

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-params-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4 \
   --deploy-parameters="git-sha=f787cac"

Wie immer wird beim Erstellen eines Releases automatisch ein Roll-out für das erste Ziel in Ihrer Pipeline erstellt (oder, wie in diesem Fall, für ein bestimmtes Ziel, das mit --to-target= angegeben wird). In diesem Quickstart ist dieses Ziel ein Mehrfachziel. rollout ist also ein „Controller-Roll-out“ für zwei untergeordnete Ziele und es gibt keine nachfolgenden Ziele in der Bereitstellungspipeline. Das bedeutet, dass Ihre Anwendung nach der Roll-out-Erstellung überall bereitgestellt wird.

Ergebnisse in der Google Cloud Console ansehen

Nachdem Sie nun den Release, das Controller-Rollout und das untergeordnete Roll-outs erstellt wurden, sind diese untergeordneten Roll-outs jetzt bereitgestellt (oder befinden sich Bereitstellungsprozess) zu ihren jeweiligen GKE-Clustern oder Cloud Run-Dienste.

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

Zur Seite der Lieferpipelines
Klicken Sie auf den Namen Ihrer Bereitstellungspipeline „my-parallel-demo-app-1“.

Die Pipeline-Visualisierung zeigt den Bereitstellungsstatus der Anwendung. Da es nur eine Phase in der Pipeline gibt, wird in der Visualisierung nur ein Knoten angezeigt.

Ihre Version wird auf dem Tab Releases unter Details zur Lieferpipeline aufgeführt.
Klicken Sie auf den Releasenamen, test-release-001.

Ihre Roll-outs werden unter Roll-outs angezeigt. Sie können auf ein Roll-out klicken, Details, einschließlich des Bereitstellungsprotokolls.
Wählen Sie unter Release-Details den Tab Artefakte aus.

In der Tabelle Deployment-Parameter sind alle Parameter aufgeführt, die Sie in Ihrem Manifest konfiguriert haben, sowie die von Ihnen angegebenen Werte für diese Parameter:

GKE

Cloud Run

Zusätzlich zu den Parametern und Werten wird in der Tabelle angezeigt, welche Ziele für die der Parameter gilt.
Klicken Sie in der Spalte Release-Inspector für jedes Ziel auf Artefakte ansehen.
Klicken Sie auf Unterschied einblenden und wählen Sie dann params-prod-a für ein Ziel aus. params-prod-b für die andere.

Es wird ein Unterschied angezeigt, bei dem die gerenderten Manifeste der beiden Ziele verglichen werden. einschließlich der von Ihnen angegebenen Werte:

GKE

Cloud Run

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 deploy-params-cluster-prod1 --region=us-central1 --project=PROJECT_ID \
&& gcloud container clusters delete deploy-params-cluster-prod2 --region=us-west1 --project=PROJECT_ID

Cloud Run

gcloud run services delete my-parallel-run-service --region=us-central1 --project=PROJECT_ID \
&& gcloud run services delete my-parallel-run-service --region=us-west1 --project=PROJECT_ID

Bereitstellungspipeline, mehrere Ziele, untergeordnete Ziele, Release und Einführungen:

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!

Nächste Schritte

Bereitstellungsparameter verwenden
Weitere Informationen zur gleichzeitigen Bereitstellung für mehrere Ziele
Weitere Informationen zu Cloud Deploy
Grundlagen der Bereitstellung von Anwendungen kennenlernen
Schritt-für-Schritt-Anleitung zu Cloud Deploy ausprobieren
Erfahren Sie, wie Sie Manifeste verwalten.
Informationen zum Kombinieren von Google Cloud-CI/CD-Tools, um Software effektiv für GKE zu entwickeln und bereitzustellen