Anwendung mit Cloud Deploy in Cloud Run bereitstellen

Anwendung mit Cloud Deploy in Cloud Run bereitstellen

Auf dieser Seite erfahren Sie, wie Sie mit Cloud Deploy eine Stichprobe bereitstellen Anwendungs-Image mit dem Namen hello in eine Sequenz aus zwei Cloud Run-Schritten oder zwei Cloud Run-Jobs.

Dieser Schnellstart erläutert folgende Schritte:

1. Skaffold-Konfiguration erstellen

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

   In diesen Dateien werden die Dienste oder Jobs und die (vordefinierten) Container-Images für die Bereitstellung angegeben.

3. Cloud Deploy-Bereitstellungspipeline und -Deployment definieren targets angeben, die auf die beiden Dienste oder die beiden Jobs.

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. 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, 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, 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. Achten Sie darauf, dass das Compute Engine-Standarddienstkonto ausreichend Berechtigungen hat.

    Das Dienstkonto hat möglicherweise bereits die erforderlichen Berechtigungen. Diese Schritte sind für Projekte enthalten, bei denen automatische Rollenzuweisungen standardmäßig deaktiviert sind. Dienstkonten.

1. Die clouddeploy.jobRunner-Rolle hinzufügen:

   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. Standarddienstkonto actAs für die Ausführung gewähren Berechtigung zum Bereitstellen von Arbeitslasten in Cloud Run importieren:

   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
   

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

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

Skaffold-Konfiguration vorbereiten

Cloud Deploy verwendet Skaffold, um die Details für was Sie bereitstellen sollten und wie Sie es für Ihre separate Ziele.

Für diese Kurzanleitung erstellen Sie eine skaffold.yaml-Datei, die den Cloud Run-Dienst oder -Jobdefinition zum Bereitstellen der Beispiel-App.

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, in der Ihre Cloud Run-Dienste oder ‑Jobs angegeben sind. Weitere Informationen finden Sie in der Referenz zu skaffold.yaml für erhalten Sie weitere Informationen zu dieser Datei.

Cloud Run-Dienste oder ‑Jobs vorbereiten

In dieser Kurzanleitung erstellen Sie entweder zwei verschiedene Cloud Run-Dienste oder zwei Cloud Run-Jobs im selben Projekt. Cloud Deploy unterstützt die Bereitstellung auch in für mehrere Projekte. Außerdem verwenden wir Skaffold-Profile, um zwei Dienste oder Jobs im selben Projekt zu ermöglichen. Wenn Sie unterschiedlichen Projekten haben, 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. Als Name deploy-run-service-dev impliziert, dass dies Ihr dev-Dienst ist. dem ersten Ziel in der Bereitstellungspipeline entspricht.

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
   

   In dieser Datei wird ein weiterer Cloud Run-Dienst definiert. Wie der Name deploy-run-service-prod schon sagt, ist dies Ihr prod-Dienst. Er entspricht dem zweiten Ziel in der Fortschrittspipeline Ihrer Bereitstellung.

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. Als Name deploy-run-job-dev impliziert, dass dies Ihr dev-Job ist und entspricht das erste Ziel in 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. Als Name deploy-run-job-prod impliziert, dass dies Ihr prod-Job ist und entspricht bis zum zweiten Ziel in der Bereitstellungspipeline.

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
   

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

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 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 Cloud Deploy auf. Seite Bereitstellungspipelines zur Liste der verfügbaren Bereitstellungspipelines Pipelines.

   Zur Seite der Lieferpipelines

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

   

Release erstellen

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

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:4a856b6f1c3ce723a456ddc2adfbb794cbfba93f727e2d96fcf6540bd0d6fff4

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 (außer sie enthalten --disable-initial-rollout): Cloud Deploy erstellt automatisch eine rollout-Ressource hinzu. Die Anwendung ist automatisch für das erste Ziel in der Abfolge bereitgestellt wird.

Release hochstufen

Hinweis: Nachdem Sie den Release erstellt haben, müssen Sie möglicherweise einige Minuten warten, bevor Sie fahren Sie mit diesem Schritt fort.

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.

   

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

   Das Dialogfeld Release hochstufen wird angezeigt. Sie enthält die Details zum Ziel auf die Sie bewerben.

3. Klicken Sie auf Hochstufen.

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

   

Ergebnisse in der Google Cloud Console ansehen

1. Rufen Sie in der Google Cloud Console Cloud Deploy auf. Seite Bereitstellungspipelines, 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 Pipeline-Visualisierung zeigt den Fortschritt der Anwendung durch die Pipeline.

   

   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.

   

Auf den Cloud Run-Dienst zugreifen

Sie müssen standardmäßig authentifiziert sein, um auf neu erstellte Cloud Run-Dienste. Cloud Run ansehen Übersicht über die Authentifizierung, um zu erfahren, wie Sie Anmeldedaten bereitstellen und herausfinden, wie Identity and Access Management konfiguriert ist erforderlich, um ohne Authentifizierung auf den Dienst zugreifen zu können. Nicht zutreffend auf Cloud Run-Jobs.

Bereinigen

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

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

   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, Releases und Roll-outs:

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

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

• Weitere Informationen zu Cloud Deploy

• Grundlagen der Bereitstellung von Anwendungen kennenlernen

• Anleitung zum Bereitstellen in Cloud Run

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