Sospendere una pipeline di distribuzione

Questa pagina descrive come sospendere una pipeline di distribuzione di Cloud Deploy.

Puoi sospendere una pipeline di distribuzione. La sospensione di una pipeline ne impedisce l'utilizzo per quanto segue:

  • Crea una release

  • Promuovere una release

  • Esegui il rollback di una release

  • Esegui nuovamente il deployment di una release

  • Approvare o rifiutare un'implementazione

Ecco alcuni possibili motivi per la sospensione di una pipeline di distribuzione:

  • Si è verificato un problema con una release e vuoi impedire ulteriori azioni su quella pipeline finché il problema non viene trovato.

  • La tua organizzazione applica un blocco delle pubblicazioni durante le festività, ad esempio durante il picco della stagione di shopping delle festività.

Per sospendere una pipeline di distribuzione:

  1. Nel file di configurazione della pipeline di distribuzione, includi la seguente proprietà:

    suspended: true
    

    Questa proprietà si trova al livello superiore, come mostrato di seguito:

    apiVersion: deploy.cloud.google.com/v1
    kind: DeliveryPipeline
    metadata:
     Name: my-app
    description: main application pipeline
    suspended: true
    serialPipeline:
     stages:
       - targetId: dev
         profiles: []
       - targetId: staging
         profiles: []
       - targetId: prod
         profiles: []
    
  2. Registra la pipeline di distribuzione:

    gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
    

    Dove:

    • PIPELINE_CONFIG

      È il nome del file di configurazione della pipeline di distribuzione, in genere clouddeploy.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.

Poiché la pipeline è sospesa, le azioni, come la promozione, sono impedite.

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 questa pipeline finché non viene ripristinata.

Autorizzazioni IAM richieste per sospendere 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:

  1. Nel file di configurazione della pipeline di distribuzione, rimuovi la proprietà suspended: true o impostala su false.

  2. Applica la configurazione:

    gcloud deploy apply --file=PIPELINE_CONFIG --region=REGION --project=PROJECT_ID
    

Scopri quali pipeline sono sospese

Le pipeline di distribuzione bloccate sono contrassegnate da un'icona lucchetto accanto al nome nella visualizzazione Pipeline di distribuzione della console Google Cloud:

Icona a forma di lucchetto che indica che la pipeline di importazione è sospesa.

Passaggi successivi