Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie eine Cloud Deploy-Bereitstellungspipeline pausieren.
Sie können eine Bereitstellungspipeline aussetzen. Wenn Sie eine Pipeline pausieren, kann sie nicht mehr für Folgendes verwendet werden:
Release erstellen
Release hochstufen
Release rückgängig machen
Release noch einmal bereitstellen
Einführung genehmigen oder ablehnen
Hier sind einige mögliche Gründe für das Aussetzen einer Bereitstellungspipeline:
Es gibt ein Problem mit einem Release und Sie möchten verhindern, dass weitere Aktionen für diese Pipeline ausgeführt werden, bis das Problem gefunden wurde.
In Ihrer Organisation gilt eine Festtagsruhe, z. B. während der Festtagssaison.
So setzen Sie eine Bereitstellungspipeline aus:
Fügen Sie in der Konfigurationsdatei der Lieferpipeline die folgende Eigenschaft ein:
suspended:true
Dieses Attribut wird auf der obersten Ebene platziert, wie hier dargestellt:
Ist der Name der Konfigurationsdatei der Bereitstellungspipeline, in der Regel clouddeploy.yaml. Das ist ein Pflichtfeld.
REGION
Der Name der Region, in der die Bereitstellungspipeline erstellt wurde, z. B. us-central1. Das ist ein Pflichtfeld.
PROJECT_ID
Die Projekt-ID des Projekts, in dem die Lieferpipeline erstellt wurde. Das ist ein Pflichtfeld.
Die Bereitstellungspipeline ist jetzt ausgesetzt. Das Erstellen, Hochstufen, Rollback und erneute Bereitstellen von Releases sowie die Genehmigung des Roll-outs sind nicht mehr möglich.
Roll-outs aus ausgesetzten Bereitstellungspipelines
Wenn Sie eine Auslieferungspipeline pausieren, werden laufende oder in der Warteschlange befindliche Roll-outs fortgesetzt und nicht abgebrochen. Da Sie jedoch keinen Release erstellen oder hochstufen können, können mit dieser Pipeline keine neuen Roll-outs erstellt werden, bis sie fortgesetzt wird.
Erforderliche IAM-Berechtigungen zum Pausieren einer Pipeline
Die IAM-Berechtigungen, die zum Pausieren einer Übermittlungspipeline erforderlich sind, sind in den folgenden Rollen enthalten:
roles/clouddeploy.admin
roles/clouddeploy.operator
roles/clouddeploy.developer
Angehaltene Bereitstellungspipeline fortsetzen
So aktivieren Sie eine ausgesetzte Lieferpipeline wieder:
Entfernen Sie in der Konfigurationsdatei der Bereitstellungspipeline das Attribut suspended: true oder legen Sie es auf false fest.
Gesperrte Bereitstellungspipelines werden in der Ansicht Google Cloud Console Bereitstellungspipelines neben dem Namen mit einem Schlosssymbol angezeigt:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[[["\u003cp\u003eSuspending a Cloud Deploy delivery pipeline prevents actions such as creating, promoting, rolling back, or redeploying releases, as well as approving or rejecting rollouts.\u003c/p\u003e\n"],["\u003cp\u003eA delivery pipeline can be suspended by including the \u003ccode\u003esuspended: true\u003c/code\u003e property in the pipeline's configuration file, typically \u003ccode\u003eclouddeploy.yaml\u003c/code\u003e, at the top level.\u003c/p\u003e\n"],["\u003cp\u003eRollouts already in progress will complete even after the pipeline is suspended, but no new rollouts can be created.\u003c/p\u003e\n"],["\u003cp\u003eTo resume a suspended delivery pipeline, remove the \u003ccode\u003esuspended: true\u003c/code\u003e property or set it to \u003ccode\u003efalse\u003c/code\u003e in the configuration file and then apply the configuration.\u003c/p\u003e\n"],["\u003cp\u003eSuspended pipelines are identified by a lock icon in the Google Cloud console's Delivery pipelines view.\u003c/p\u003e\n"]]],[],null,["# Suspend a delivery pipeline\n\nThis page describes how to suspend a Cloud Deploy delivery pipeline.\n\nYou can *suspend* a delivery pipeline. Suspending a pipeline means that it can\nno longer be used for the following:\n\n- Create a release\n\n- Promote a release\n\n- Roll back a release\n\n- Redeploy a release\n\n- Approve or reject a rollout\n\nHere are some possible reasons for suspending a delivery pipeline:\n\n- There's a problem with a release and you want to prevent further action on\n that pipeline until the problem is found.\n\n- Your organization observes a holiday freeze, for example during peak holiday\n shopping season.\n\nTo suspend a delivery pipeline:\n\n1. In the delivery pipeline configuration file, include the following property:\n\n suspended: true\n\n This property goes at the top level, as shown: \n\n apiVersion: deploy.cloud.google.com/v1\n kind: DeliveryPipeline\n metadata:\n Name: my-app\n description: main application pipeline\n suspended: true\n serialPipeline:\n stages:\n - targetId: dev\n profiles: []\n - targetId: staging\n profiles: []\n - targetId: prod\n profiles: []\n\n2. Register the delivery pipeline:\n\n gcloud deploy apply --file=\u003cvar label=\"pipeline\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePIPELINE_CONFIG\u003c/span\u003e\u003c/var\u003e --region=\u003cvar label=\"region\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eREGION\u003c/span\u003e\u003c/var\u003e --project=\u003cvar label=\"project id\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePROJECT_ID\u003c/span\u003e\u003c/var\u003e\n\n Where:\n - \u003cvar translate=\"no\"\u003ePIPELINE_CONFIG\u003c/var\u003e\n\n Is the name of the delivery pipeline configuration file, typically\n `clouddeploy.yaml`. This is required.\n - \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\n\n Is the name of the region in which the delivery pipeline was created, for\n example `us-central1`. This is required.\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n Is the project ID of the project in which the delivery pipeline was\n created. This is required.\n\nThe delivery pipeline is now in a suspended state, which prevents release\ncreation, promotion, rollback and redeploy, and rollout approval.\n\nRollouts from suspended delivery pipelines\n------------------------------------------\n\nIf there are any rollouts in progress or queued when you suspend a delivery\npipeline, those rollouts continue to completion---they are not\ncanceled. However, because you can't create or promote a release, no new\nrollouts can be created using that pipeline until it's [resumed](#resume_a_suspended_delivery_pipeline).\n\nIAM permissions required for suspending a pipeline\n--------------------------------------------------\n\nThe IAM permissions required for suspending a delivery pipeline\nare included in the following roles:\n\n- roles/clouddeploy.admin\n\n- roles/clouddeploy.operator\n\n- roles/clouddeploy.developer\n\nResume a suspended delivery pipeline\n------------------------------------\n\nTo re-enable a suspended delivery pipeline:\n\n1. In the delivery pipeline configuration file, remove the property\n `suspended: true`, or set it to `false`.\n\n2. Apply the configuration:\n\n gcloud deploy apply --file=\u003cvar label=\"pipeline\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePIPELINE_CONFIG\u003c/span\u003e\u003c/var\u003e --region=\u003cvar label=\"region\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eREGION\u003c/span\u003e\u003c/var\u003e --project=\u003cvar label=\"project id\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePROJECT_ID\u003c/span\u003e\u003c/var\u003e\n\nFind out what pipelines are suspended\n-------------------------------------\n\nAny delivery pipelines that are locked are shown with a lock icon next to the\nname in the Google Cloud console **Delivery pipelines** view:\n\nWhat's next\n-----------\n\n- Find out how to [view a delivery pipeline](/deploy/docs/view-pipeline)\n that's already in use.\n\n- Learn how to [update a delivery pipeline](/deploy/docs/update-pipeline).\n\n- Find out how to [delete a delivery pipeline](/deploy/docs/delete-pipeline).\n\n- Learn how to [use service notifications](/deploy/docs/subscribe-deploy-notifications)"]]
