Lieferpipeline und Ziele erstellen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite wird beschrieben, wie Sie die Bereitstellungspipeline und Ziele erstellen, die beschreiben, wo und wie Google Cloud Deploy Ihre Anwendung bereitstellt. Eine Beschreibung der YAML-Dateistruktur für Bereitstellungspipelines und Ziele finden Sie unter Konfigurationsdateischema.

Informationen zur Bereitstellungspipeline und -ziele

Ihre Lieferpipeline beschreibt den Fortschritt in der Bereitstellungssequenz. Sie können diese Ziele in derselben Datei wie die Lieferpipeline oder in einer oder mehreren separaten Dateien definieren.

Nachdem Sie die Lieferpipeline und die Zieldefinitionsdatei bzw. -dateien erstellt haben, führen Sie gcloud deploy apply für jede dieser Dateien aus, um sie als Google Cloud Deploy-Ressourcen zu registrieren.

Bereitstellungspipeline und -ziele definieren

Die Struktur der Bereitstellungspipeline und der Zielkonfigurationsdateien wird hier beschrieben.

Sie können diese Datei jederzeit aufrufen. Konventionsgemäß wird eine Konfiguration der Zieldefinitionen mit enthaltenen Zieldefinitionen clouddeploy.yaml genannt, und eine Konfiguration, die stattdessen auf Ziele verweist, die in einer oder mehreren separaten Dateien definiert sind, delivery-pipeline.yaml.

Das Ziel kann auf GKE, Anthos oder Cloud Run verweisen.

Bereitstellungspipeline und -ziele registrieren

Zum Registrieren Ihrer Lieferpipeline bei Google Cloud Deploy führen Sie gcloud deploy apply für jede separate Definitionsdatei einmal aus. Das heißt, wenn Sie drei Ziele in drei Dateien definieren, würden Sie den Befehl viermal ausführen – einmal für die Lieferpipeline und einmal für jedes Ziel.

Mit folgendem Befehl wird eine Lieferpipeline mit ihren in derselben Datei definierten Zielen registriert.

gcloud deploy apply --file=PIPELINE_CONFIG \
                    --region=LOCATION \
                    --project=PROJECT

Sie haben jetzt eine Lieferpipeline, die die Bereitstellung Ihrer Releases verwalten kann, und Zielressourcen, die von jeder Lieferpipeline im selben Projekt und in derselben Region verwendet werden können.

Beispiel: nur eine Datei

Der Befehl in diesem Beispiel registriert eine Lieferpipeline und Ziele, wobei alles in derselben Datei definiert ist:

gcloud deploy apply --file=clouddeploy.yaml --region=us-central1

Beispiel: separate Dateien

In diesem Beispiel sind drei Ziele in drei separaten Dateien definiert, sodass Sie vier Befehle ausführen:

gcloud deploy apply --file=delivery-pipeline.yaml --region=us-central1 && \
gcloud deploy apply --file=target_dev.yaml --region=us-central1 && \
gcloud deploy apply --file=target_staging.yaml --region=us-central1 && \
gcloud deploy apply --file=target_prod.yaml --region=us-central1

Das Flag --region ist erforderlich, sofern Sie keine Standardeinstellung festgelegt haben (mit gcloud config set deploy/region [REGION]). Die Region muss für die Bereitstellungspipeline und alle Ziele, auf die die Pipeline verweist, identisch sein.

Bereitstellungspipeline und -ziele mit Terraform erstellen

Sie können auch den Google Cloud Terraform-Anbieter verwenden, um Bereitstellungspipelines und Zielressourcen zu erstellen.

Vorhandene Pipelines und Ziele bearbeiten

Sie können die Lieferpipeline oder die Zielkonfiguration später bearbeiten und gcloud deploy apply ausführen, um Pipeline oder Zielressource zu aktualisieren. Diese Änderungen wirken sich nicht auf vorhandene Releases aus, da diese von der ursprünglichen Lieferpipeline verwaltet werden.

Manuelle Genehmigung für eine Bereitstellung anfordern

Wenn Sie eine manuelle Genehmigung für ein bestimmtes Ziel anfordern möchten, fügen Sie folgendes Attribut in die Zieldefinition ein:

requireApproval: true

Der Standardwert ist false. Wenn Sie dieses Attribut in der Konfiguration der Lieferpipeline weglassen oder keinen Wert dafür angeben, ist für die Bereitstellung auf diesem Ziel keine Genehmigung erforderlich. Der Aufrufer, der zum Ziel hochstufen möchte, benötigt jedoch weiterhin die clouddeploy.rollouts.create- IAM-Berechtigung.

Sie können sogar eine manuelle Genehmigung für das erste Ziel anfordern. Wenn ein Release über die Befehlszeile für das erste Ziel erstellt wird, wird der rollout automatisch erstellt. Wenn eine Genehmigung erforderlich ist, erstellt Google Cloud Deploy die rollout, hat aber den Status „Ausstehend“, bis die Genehmigung erteilt wurde.

Nächste Schritte