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:
Skaffold-Konfiguration erstellen
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.
Cloud Deploy-Bereitstellungspipeline und -Deployment definieren targets angeben, die auf die beiden Dienste oder die beiden Jobs.
Instanziieren Sie Ihre Lieferpipeline. Dazu erstellen Sie einen Release, der automatisch für das erste Ziel bereitgestellt wird.
Stufen Sie den Release zum zweiten Ziel hoch.
Sehen Sie sich beide Roll-outs in der Google Cloud Console an.
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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage 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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- 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.
- 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"
- 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
- 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.
Wenn Sie die Befehlszeile bereits installiert haben, achten Sie darauf, dass Sie die neueste Version:
gcloud components update
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.
Öffnen Sie ein Terminalfenster.
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
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
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 Ihrdev
-Dienst ist. dem ersten Ziel in der Bereitstellungspipeline entspricht.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 Ihrprod
-Dienst. Er entspricht dem zweiten Ziel in der Fortschrittspipeline Ihrer Bereitstellung.
Jobs
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 Ihrdev
-Job ist und entspricht das erste Ziel in der Bereitstellungspipeline.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 Ihrprod
-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.
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
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.
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
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.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.
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
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
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.
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:
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
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
Löschen Sie die Bereitstellungspipeline, Ziele, 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!
Nächste Schritte
Erfahren Sie, wie Sie Manifeste verwalten.