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.

    Go to project selector

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

  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
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  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
  12. Wenn Sie die Befehlszeile bereits installiert haben, achten Sie darauf, dass Sie die neueste Version:

    gcloud components update
    

  13. 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)")-compute@developer.gserviceaccount.com \
          --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)")-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 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
    
  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.

    Bereitstellungspipeline in der Google Cloud Console

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

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

    Visualisierung der Bereitstellungspipeline in der Google Cloud Console, die den für die Produktion bereitgestellten Release zeigt

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.

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

    Roll-outs in der Google Cloud Console

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