Suspendre un pipeline de livraison

Cette page explique comment suspendre un pipeline de livraison Cloud Deploy.

Vous pouvez suspend un pipeline de livraison. Lorsqu'un pipeline est suspendu, il ne peut plus être utilisé pour les opérations suivantes:

  • Créer une version

  • Promouvoir une version

  • Effectuer le rollback d'une version

  • Redéployer une version

  • Approuver ou refuser un déploiement

Voici quelques raisons pouvant expliquer la suspension d'un pipeline de livraison:

  • Un problème est survenu avec une version et vous souhaitez empêcher toute autre action sur ce pipeline jusqu'à ce que le problème soit détecté.

  • Votre organisation observe un gel lié aux fêtes, par exemple pendant la haute saison des achats.

Pour suspendre un pipeline de livraison:

  1. Dans le fichier de configuration du pipeline de livraison, incluez la propriété suivante:

    suspended: true

    Cette propriété est placée au premier niveau, comme illustré ci-dessous:

    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. Enregistrez le pipeline de livraison:

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

    Où :

    • PIPELINE_CONFIG

      est le nom du fichier de configuration du pipeline de livraison, généralement clouddeploy.yaml. Ce champ est obligatoire.

    • REGION

      correspond au nom de la région dans laquelle le pipeline de livraison a été créé, par exemple us-central1. Ce champ est obligatoire.

    • PROJECT_ID

      est l'ID du projet dans lequel le pipeline de livraison a été créé. Ce champ est obligatoire.

Le pipeline de livraison est désormais suspendu, ce qui empêche la création de versions, la promotion, le rollback, le redéploiement et l'approbation du déploiement.

Comme le pipeline est suspendu, les actions, telles que la promotion, ne sont pas autorisées.

Déploiements à partir de pipelines de livraison suspendus

Si des déploiements sont en cours ou mis en file d'attente lorsque vous suspendez un pipeline de livraison, ils se poursuivent jusqu'à son terme. Ils ne sont pas annulés. Toutefois, comme vous ne pouvez pas créer ni promouvoir une version, aucun autre déploiement ne peut être créé à l'aide de ce pipeline tant qu'il n'a pas été réactivé.

Autorisations IAM requises pour suspendre un pipeline

Les autorisations IAM requises pour suspendre un pipeline de livraison sont incluses dans les rôles suivants:

  • roles/clouddeploy.admin

  • rôles/clouddeploy.operator

  • roles/clouddeploy.developer.

Réactiver un pipeline de livraison suspendu

Pour réactiver un pipeline de livraison suspendu:

  1. Dans le fichier de configuration du pipeline de livraison, supprimez la propriété suspended: true ou définissez-la sur false.

  2. Appliquez la configuration :

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

Identifier les pipelines suspendus

Tous les pipelines de livraison verrouillés sont représentés par une icône en forme de cadenas à côté de leur nom dans la vue Pipelines de livraison de la console Google Cloud:

Icône en forme de cadenas indiquant que le pipeline de livraison est suspendu

Étapes suivantes