Suspendre un pipeline de diffusion

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

Vous pouvez suspendre un pipeline de livraison. Suspendre un pipeline signifie qu'il ne peut plus être utilisé pour les éléments suivants:

  • 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 de suspendre un pipeline de diffusion:

  • 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 résolu.

  • Votre organisation applique un gel des embauches pendant la période des fêtes, par exemple pendant la période de pointe des achats de fin d'année.

Pour suspendre un pipeline de diffusion:

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

    suspended: true

    Cette propriété se trouve au niveau supérieur, 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 diffusion:

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

    Où :

    • PIPELINE_CONFIG

      Nom du fichier de configuration du pipeline de diffusion, 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 diffusion a été créé. Ce champ est obligatoire.

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

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

Déploiements à partir de pipelines de diffusion suspendus

Si des déploiements sont en cours ou en file d'attente lorsque vous suspendez un pipeline de diffusion, ils se poursuivent jusqu'à leur achèvement. Ils ne sont pas annulés. Toutefois, comme vous ne pouvez pas créer ni promouvoir de version, vous ne pouvez pas créer de nouveaux déploiements à l'aide de ce pipeline tant qu'il n'est pas réactivé.

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 diffusion suspendu

Pour réactiver un pipeline de diffusion suspendu:

  1. Dans le fichier de configuration du pipeline de diffusion, 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 diffusion verrouillés sont associés à une icône en forme de cadenas à côté de leur nom dans la vue Pipelines de diffusion de la console Google Cloud:

Icône en forme de cadenas, indiquant que le pipeline de diffusion est suspendu.

Étape suivante