Anwendung mit Cloud Deploy in Cloud Run bereitstellen
Auf dieser Seite wird beschrieben, wie Sie mit Cloud Deploy ein Beispielanwendungs-Image namens hello
an eine Abfolge von zwei Cloud Run-Diensten oder zwei Cloud Run-Jobs senden können.
Dieser Schnellstart erläutert folgende Schritte:
Skaffold-Konfiguration erstellen
Erstellen Sie Konfigurationsdateien für zwei Cloud Run-Dienste oder zwei Jobs.
Diese Dateien definieren die Dienste oder Jobs und geben die (vordefinierten) Container-Images an, die bereitgestellt werden sollen.
Definieren Sie Ihre Cloud Deploy-Bereitstellungspipeline und Bereitstellungsziele, die auf die beiden Dienste oder die beiden Jobs verweisen.
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.
Beide Roll-outs in der Google Cloud Console ansehen.
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
- 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 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"
- Gewähren Sie dem Standardausführungsdienstkonto die Berechtigung
actAs
zum Bereitstellen von Arbeitslasten in Cloud Run: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 Sie Probleme beim Hinzufügen einer dieser Rollen haben, wenden Sie sich an Ihren Projektadministrator.
Wenn Sie die Befehlszeile bereits installiert haben, prüfen Sie, ob es sich um die neueste Version handelt:
gcloud components update
Skaffold-Konfiguration vorbereiten
Cloud Deploy verwendet Skaffold, um die Details für die Bereitstellung und die ordnungsgemäße Bereitstellung für Ihre separaten Ziele bereitzustellen.
Für diese Kurzanleitung erstellen Sie eine skaffold.yaml
-Datei, die den Cloud Run-Dienst oder die Jobdefinition angibt, die zum Bereitstellen der Beispielanwendung verwendet werden soll.
Ö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/v3alpha1 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/v3alpha1 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, die Ihre Cloud Run-Dienste oder -Jobs identifiziert. Weitere Informationen zu dieser Datei finden Sie in der Referenz zu
skaffold.yaml
.
Cloud Run-Dienste oder -Jobs vorbereiten
Für diese Kurzanleitung erstellen Sie entweder zwei verschiedene Cloud Run-Dienste oder zwei Cloud Run-Jobs im selben Projekt. Cloud Deploy unterstützt auch die Bereitstellung in mehreren Projekten. Außerdem verwenden wir Skaffold-Profile, um zwei Dienste oder Jobs im selben Projekt zu ermöglichen. Wenn Sie verschiedene Projekte verwenden, benötigen Sie möglicherweise keine Skaffold-Profile.
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. Wie der Name
deploy-run-service-dev
schon sagt, ist dies Ihrdev
-Dienst, der 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
Diese Datei definiert einen weiteren Cloud Run-Dienst. Wie der Name
deploy-run-service-prod
impliziert, ist dies Ihrprod
-Dienst. Er entspricht dem zweiten Ziel im Fortschritt der Bereitstellungspipeline.
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. Wie der Name
deploy-run-job-dev
schon andeutet, ist dies Ihrdev
-Job, der dem ersten Ziel im Fortschritt der Bereitstellungspipeline entspricht.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 anderen Cloud Run-Job. Wie der Name
deploy-run-job-prod
schon sagt, ist dies Ihrprod
-Job, der dem zweiten Ziel im Fortschritt der Bereitstellungspipeline entspricht.
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 die Cloud Deploy-Seite Bereitstellungspipelines auf, um eine Liste der verfügbaren Bereitstellungspipelines aufzurufen.
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 die bereitzustellenden Änderungen darstellt. Die Bereitstellungspipeline definiert den Lebenszyklus dieses Release. Weitere Informationen zu diesem Lebenszyklus finden Sie unter Cloud Deploy-Dienstarchitektur.
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=gcr.io/cloudrun/hello@sha256:98cdb98c2d97a67d5e9183beedfec98ca9d5967acd874409b4800bf4d1a51710
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 (sofern sie nicht --disable-initial-rollout
enthalten) erstellt Cloud Deploy automatisch auch eine Rollout-Ressource. Die Anwendung wird automatisch am ersten Ziel im Fortschritt bereitgestellt.
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. Es zeigt die Details des Ziels, auf das Sie hochstufen.
Klicken Sie auf Werben.
Der Release wird jetzt zur 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 die Cloud Deploy-Seite Bereitstellungspipelines auf, um Ihre my-run-demo-app-1-Bereitstellungspipeline anzusehen.
Zur Seite der Lieferpipelines
Klicken Sie auf den Namen Ihrer Bereitstellungspipeline „my-run-demo-app-1“.
Die Pipelinevisualisierung zeigt den Fortschritt der Anwendung in der 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, um die zugehörigen Details, einschließlich des Bereitstellungslogs, anzusehen.
Auf den Cloud Run-Dienst zugreifen
Standardmäßig müssen Sie authentifiziert sein, um auf neu erstellte Cloud Run-Dienste zugreifen zu können. In der Authentifizierungsübersicht für Cloud Run erfahren Sie, wie Sie Anmeldedaten bereitstellen und welche Konfiguration von Identity and Access Management erforderlich ist, um ohne Authentifizierung auf den Dienst zuzugreifen. Dies gilt nicht für Cloud Run-Jobs.
Bereinigen
Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:
Löschen Sie den Cloud Run-Dienst oder -Job
deploy-qs-dev
: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, den Release und Roll-outs:
gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
Löschen Sie die Cloud Storage-Buckets, die von Cloud Deploy erstellt wurden.
Das eine endet mit
_clouddeploy
, das andere auf[region].deploy-artifacts.[project].appspot.com
.Die Cloud Storage-Browserseite öffnen
Das war alles. Sie haben diesen Schnellstart abgeschlossen!
Nächste Schritte
Machen Sie sich mit den Grundlagen der Anwendungsbereitstellung vertraut.
Erfahren Sie, wie Sie Manifeste verwalten.