È il nome del file di configurazione della pipeline di distribuzione, in genereclouddeploy.yaml. Campo obbligatorio.
REGION
È il nome della regione in cui è stata creata la pipeline di distribuzione, ad esempio us-central1. Campo obbligatorio.
PROJECT_ID
È l'ID del progetto in cui è stata creata la pipeline di importazione. Campo obbligatorio.
La pipeline di distribuzione è ora in stato di sospensione, il che impedisce la creazione, la promozione, il rollback e il nuovo deployment delle release, nonché l'approvazione dell'implementazione.
Implementazioni da pipeline di pubblicazione sospese
Se sono presenti implementazioni in corso o in coda quando sospendi una pipeline di importazione, queste implementazioni continuano fino al completamento e non vengono annullate. Tuttavia, poiché non puoi creare o promuovere una release, non è possibile creare nuovi rollout utilizzando la pipeline finché non viene ripristinata.
Autorizzazioni IAM richieste per la sospensione di una pipeline
Le autorizzazioni IAM necessarie per sospendere una pipeline di importazione sono incluse nei seguenti ruoli:
roles/clouddeploy.admin
roles/clouddeploy.operator
roles/clouddeploy.developer
Ripristinare una pipeline di distribuzione sospesa
Per riattivare una pipeline di distribuzione sospesa:
Nel file di configurazione della pipeline di distribuzione, rimuovi la proprietà
suspended: true o impostala su false.
Le pipeline di distribuzione bloccate sono contrassegnate da un'icona a forma di lucchetto accanto al nome nella visualizzazione Pipeline di distribuzione della Google Cloud console:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 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)"]]