Auf dieser Seite wird beschrieben, wie Sie die Lieferpipeline und die Ziele erstellen, die beschreiben, wo und wie Cloud Deploy Ihre Anwendung bereitstellt. Eine Beschreibung der YAML-Dateistruktur für Lieferpipelines und Ziele finden Sie unter Konfigurationsdateischema.
Lieferpipeline und Ziele
Ihre Lieferpipeline beschreibt einen 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 für jede dieser Dateien gcloud deploy apply aus, um sie als Cloud Deploy-Ressourcen zu registrieren.
Lieferpipeline und Ziele definieren
Die Struktur der Konfigurationsdateien für Lieferpipeline und Ziel wird beschrieben hier.
Sie können diese Datei jederzeit aufrufen. Konventionsgemäß wird eine Konfiguration der Zieldefinitionen mit enthaltenen Zieldefinitionen
einschließlich Zieldefinitionen genannt
clouddeploy.yaml, und eine Konfiguration, die stattdessen auf Ziele verweist, die in
einer oder mehreren separaten Dateien definiert sind, wird benannt delivery-pipeline.yaml.
Das Ziel kann auf GKE, angehängte GKE-Cluster, Cloud Run oder benutzerdefinierte Ziele verweisen. Innerhalb einer Lieferpipeline müssen alle Ziele auf denselben Laufzeittyp verweisen (z. B. alle GKE oder alle Cloud Run).
Lieferpipeline und Ziele mit der Google Cloud Konsole erstellen
Sie können die Google Cloud Konsole verwenden, um eine neue Lieferpipeline und ein oder mehrere Ziele zu erstellen. Dies ist nützlich, um Cloud Deploy auszuprobieren, aber nicht für Produktionsarbeitslasten geeignet. Sie können auch die Google Cloud Konsole verwenden, um einen Release zu erstellen.
So erstellen Sie die Lieferpipeline:
Klicken Sie auf der Seite Lieferpipelines auf Erstellen.
Geben Sie einen Namen ein (oder behalten Sie den Standardnamen bei) und optional eine Beschreibung.
Wählen Sie Ihre Region aus.
Wählen Sie Ihre Laufzeitumgebung aus.
Wählen Sie für GKE Google Kubernetes Engine oder Cloud Run aus, wenn dies die Laufzeit ist, für die Sie die Bereitstellung durchführen.
Geben Sie unter Neues Ziel einen Namen ein (oder behalten Sie den Standardnamen bei).
Wenn Sie für dieses Ziel eine Genehmigung anfordern möchten, klicken Sie das Kästchen Genehmigung für Roll-outs anfordern an.
Wenn Sie für dieses Ziel eine Canary-Bereitstellungsstrategie verwenden möchten, klicken Sie das Kästchen Canary aktivieren an.
Klicken Sie auf Fertig.
Klicken Sie auf Ziel hinzufügen und führen Sie diese Schritte für jedes weitere Ziel aus, das Sie erstellen möchten.
Wenn Sie alle Ziele haben, klicken Sie auf Erstellen , um die Lieferpipeline und die Zielressourcen zu erstellen.
Lieferpipeline und Ziele registrieren
Wenn Sie Ihre Pipeline und Ziele mit der Google Cloud Konsole erstellt haben, müssen Sie nichts weiter tun.
Zum Registrieren Ihrer Lieferpipeline bei Cloud Deploy führen Sie für jede separate Definitionsdatei einmal gcloud deploy apply 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. Daher führen Sie 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, sofern Sie keine Standardeinstellung (mit gcloud
config set deploy/region [REGION]) festgelegt haben. Die Region muss für die Liefer
pipeline und alle Ziele, auf die die Pipeline verweist, identisch sein.
Lieferpipeline und Ziele mit Terraform erstellen
Sie können auch den Google Cloud Terraform-Provider verwenden, um Lieferpipeline- und Zielressourcen zu erstellen.
Der Google Cloud Beta-Terraform-Provider unterstützt möglicherweise Cloud Deploy-Features in der Vorschau.
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: die Zieldefinition:
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 Cloud Deploy den rollout, aber in einem Status mit ausstehendem Release, bis die Genehmigung erteilt wird.
Nächste Schritte
Unter Anwendung bereitstellen erfahren Sie, wie Sie Ihre Lieferpipeline aufrufen und einen Release erstellen.