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 im Schema der Konfigurationsdatei.

Informationen zur Bereitstellungspipeline und zu den Zielen

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 einen GKE-Cluster oder einen Anthos-Cluster 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. Sie führen also vier Befehle aus:

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, es sei denn, Sie haben mit gcloud config set deploy/region [REGION] einen Standardwert festgelegt. Die Region muss für die Bereitstellungspipeline und alle Ziele, auf die diese 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 verlangen

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.

Für das erste Ziel kann sogar eine manuelle Genehmigung erforderlich sein. 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, befindet sich jedoch im Status „Ausstehend“, bis die Genehmigung erteilt wird.

Nächste Schritte