Suspendre un pipeline de livraison

Cette page explique comment suspendre un pipeline de déploiement Cloud Deploy.

Vous pouvez suspendre un pipeline de livraison. Suspendre un pipeline signifie qu'il ne peut plus être utilisé pour les opérations suivantes :

  • Créer une version

  • Promouvoir une version

  • Effectuer un rollback d'une version

  • Redéployer une version

  • Approuver ou refuser un déploiement

Voici quelques raisons possibles pour suspendre 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 identifié.

  • Votre organisation observe un gel des congés, par exemple pendant la période des fêtes.

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é se trouve au niveau supérieur, comme indiqué 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 diffusion :

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

    Où :

    • PIPELINE_CONFIG

      Nom du fichier de configuration du pipeline de déploiement, généralement clouddeploy.yaml. Ce champ est obligatoire.

    • REGION

      Nom de la région dans laquelle le pipeline de diffusion a été créé, par exemple us-central1. Ce champ est obligatoire.

    • PROJECT_ID

      ID du projet dans lequel le pipeline de déploiement a été créé. Ce champ est obligatoire.

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

Comme le pipeline est suspendu, les actions telles que la promotion sont empêchées.

Déploiements à partir de pipelines de livraison suspendus

Si des déploiements sont en cours ou en file d'attente lorsque vous suspendez un pipeline de livraison, ils se poursuivent jusqu'à la fin. Ils ne sont pas annulés. Toutefois, comme vous ne pouvez pas créer ni promouvoir de version, aucun nouveau déploiement ne peut être créé à l'aide de ce pipeline tant qu'il n'est pas repris.

Autorisations IAM requises pour suspendre un pipeline

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

  • roles/clouddeploy.admin

  • roles/clouddeploy.operator

  • roles/clouddeploy.developer

Réactiver un pipeline de livraison suspendu

Pour réactiver un pipeline de diffusion 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

Les pipelines de livraison verrouillés sont indiqué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