Anwendung für mehrere Ziele gleichzeitig bereitstellen

Anwendung für mehrere Ziele gleichzeitig bereitstellen

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Deploy eine Beispielanwendung bereitstellen auf zwei Ziele gleichzeitig festzulegen: einen einer parallelen Bereitstellung.

Dieser Schnellstart erläutert folgende Schritte:

1. Zwei GKE-Cluster oder zwei Cloud Run-Cluster erstellen Dienstleistungen.

   Sie können auch parallel zu GKE Enterprise-Clustern bereitstellen. In diesem Schnellstart werden jedoch nur GKE und Cloud Run verwendet.

2. Erstellen Sie eine Skaffold-Konfiguration und entweder ein Kubernetes- Manifest oder eine Cloud Run-Dienstdefinition.

3. Cloud Deploy-Bereitstellungspipeline und -Deployment definieren Ziele.

   Diese Pipeline hat nur ein Ziel, das jedoch ein Mehrere Ziele: Ein Ziel, das mehr als ein Bereitstellungsziel darstellt. Dieses Multi-Ziel besteht aus zwei tatsächlichen Zielen, die beiden Cluster oder Dienste.

4. Instanziieren Sie Ihre Bereitstellungspipeline, indem Sie einen Release erstellen, der automatisch die Bereitstellungen gleichzeitig auf den beiden Zielen erfolgen.

5. Rufen Sie das „Controller-Roll-out“ und die untergeordneten Roll-outs in der Google Cloud Console auf.

Hinweise

1. 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.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

Wenn Sie die Befehlszeile bereits installiert haben, achten Sie darauf, dass Sie die neueste Version:

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 den Standarddienst deaktiviert sind Konten.

    1. 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)")[e-mail] \
           --role="roles/clouddeploy.jobRunner"
       

    2. 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)")[e-mail] \
          --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)")[e-mail] \
          --role="roles/run.developer"
      

    3. 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)")[e-mail] \
           --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
           --format="value(projectNumber)")[e-mail] \
           --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: quickstart-cluster-qsprod1 und quickstart-cluster-qsprod2 mit den Standardeinstellungen. Die Cluster Kubernetes API-Endpunkte müssen öffentlich erreichbar sein Internet. GKE-Cluster sind extern zugänglich für Standardeinstellung.

gcloud container clusters create-auto quickstart-cluster-qsprod1 \
                 --project=PROJECT_ID \
                 --region=us-central1 \
                 && gcloud container clusters create-auto quickstart-cluster-qsprod2 \
                 --project=PROJECT_ID \
                 --region=us-west1

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 die Anwendungsmanifest, das zum Bereitstellen der Beispiel-App verwendet wird.

1. Öffnen Sie ein Terminalfenster.

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

   GKE

   mkdir deploy-gke-parallel-quickstart
   cd deploy-gke-parallel-quickstart
   

   Cloud Run

   mkdir deploy-run-parallel-quickstart
   cd deploy-run-parallel-quickstart
   

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

   GKE

   apiVersion: skaffold/v4beta1
   kind: Config
   manifests:
     rawYaml:
     - k8s-deployment.yaml
   deploy:
     kubectl: {}
   

   Cloud Run

   apiVersion: skaffold/v4beta1
   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.

4. 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 k8s-deployment.yaml und folgendem Inhalt:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
     namespace: default
   spec:
     replicas: 1 # from-param: ${replicaCount}
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: nginx
           image: my-app-image
   

   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:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 1 # from-param: ${minInstances}
       spec:
         containers:
         - image: my-app-image
   

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

Hinweis: Wenn Sie für jedes Ziel unterschiedliche Manifeste verwenden möchten, lesen Sie diesen Artikel. zur Verwaltung von Manifesten, Weitere Informationen zur Verwendung von Skaffold-Profilen.

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 die Lieferpipeline und die Zieldefinition:

   GKE

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           replicaCount: "1"
         matchTargetLabels:
           label1: label1
       - values:
           replicaCount: "2"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production clusters
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production cluster 2
   gke:
     cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production cluster 3
   gke:
     cluster: projects/PROJECT_ID/locations/us-west1/clusters/quickstart-cluster-qsprod2
   

   Hinweis: In dieser Datei sind Ziele in der Lieferpipeline enthalten. Sie können Ziele auch in einer separaten Datei oder mehreren separaten Dateien definieren.

   Cloud Run

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

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: my-parallel-demo-app-1
   description: main application pipeline
   serialPipeline:
     stages:
     - targetId: qsprod-multi
       profiles: []
       deployParameters:
       - values:
           minInstances: "2"
         matchTargetLabels:
           label1: label1
       - values:
           minInstances: "3"
         matchTargetLabels:
           label2: label2
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-multi
   description: production
   multiTarget:
     targetIds: [qsprod-a, qsprod-b]
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-a
     labels:
       label1: label1
   description: production us-central1
   run:
     location: projects/PROJECT_ID/locations/us-central1
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: qsprod-b
     labels:
       label2: label2
   description: production us-west1
   run:
     location: projects/PROJECT_ID/locations/us-west1
   

   Hinweis: In dieser Datei sind in der Bereitstellungspipeline Ziele enthalten. Sie können jedoch Ziele in einer separaten Datei oder in mehreren separaten Dateien definieren.

   Beachten Sie, dass diese Datei drei Ziele enthält: ein Mehrfachziel und zwei untergeordneten Zielen. Sie können Ziele auch in einer separaten Datei konfigurieren, anstatt mit Ihrer Bereitstellungspipeline.

   Beachten Sie auch, dass die Bereitstellungspipeline deployParameters enthält, wobei Labels und die untergeordneten Ziele enthalten Labels, die diesen Parametern entsprechen. So können Sie bei Bedarf separate Werte an separate untergeordnete Ziele übergeben. Weitere Informationen

2. 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.

3. Bestätigen Sie Pipeline und Ziele:

   Rufen Sie in der Google Cloud Console Cloud Deploy auf. Seite Bereitstellungspipelines zur Liste der verfügbaren Bereitstellungspipelines Pipelines.

   Zur Seite der Lieferpipelines

   Die Bereitstellungspipeline, die Sie gerade erstellt haben, wird angezeigt. In der Spalte Ziel ist ein Ziel aufgeführt, obwohl Sie in Ihrer clouddeploy.yaml-Datei drei Ziele (ein Multi-Ziel und zwei untergeordnete Ziele) konfiguriert haben.

   

   Beachten Sie, dass als einziges Ziel qsprod-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 Veröffentlichung. 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-parallel-demo-app-1 \
   --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa \
   --to-target=qsprod-multi

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-parallel-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4 \
   --to-target=qsprod-multi

Wie immer wird beim Erstellen eines Release automatisch ein Roll-out für die erstes Ziel in Ihrer Pipeline (oder, wie in diesem Fall, ein bestimmtes Ziel, mit --to-target=). In dieser Kurzanleitung handelt es sich um ein Ziel mit mehreren Zielen. rollout ist ein „Controller-Roll-out“ für zwei untergeordnete Ziele sind und es in der Bereitstellungspipeline keine nachfolgenden Ziele gibt. 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.

1. 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

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

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

   

   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, Details, einschließlich des Bereitstellungsprotokolls.

   

Bereinigen

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

1. GKE-Cluster oder Cloud Run löschen Dienste:

   GKE

   gcloud container clusters delete quickstart-cluster-qsprod1 --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-qsprod2 --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
   

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

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

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

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

   Die Cloud Storage-Browserseite öffnen

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte

• Weitere Informationen zur Bereitstellung auf mehreren Zielen gleichzeitig

• Weitere Informationen zu Cloud Deploy

• Grundlagen der Bereitstellung von Anwendungen kennenlernen

• Probieren Sie die Schritt-für-Schritt-Anleitung für Cloud Deploy aus.

• Erfahren Sie, wie Sie Manifeste verwalten.

• Hier erfahren Sie, wie Sie CI/CD-Tools von Google Cloud für die Entwicklung und Bereitstellung effektiv zu GKE migrieren.