Vous pouvez faire en sorte que la sortie d'une tâche de votre pipeline détermine si le pipeline s'exécute ou s'arrête en fonction d'une condition que vous indiquez. Pour conditionner la réussite ou l'échec du pipeline en fonction du résultat de la tâche, vous utilisez la tâche Condition.

Vous utilisez la tâche Condition comme point de décision dans votre pipeline. En utilisant la tâche Condition avec une expression de condition que vous indiquez, vous pouvez évaluer toutes les propriétés de votre pipeline, de vos étapes et de vos tâches.

Le résultat de la tâche Condition détermine si la tâche suivante du pipeline s'exécute.

  • Une condition true permet au pipeline de continuer à s'exécuter.
  • Une condition false arrête le pipeline.

Pour obtenir des exemples d'utilisation de la valeur de sortie d'une tâche comme entrée de la tâche suivante en liant les tâches avec une tâche Condition, reportez-vous à la section Utilisation des liaisons de variables dans les pipelines Code Stream.

Tableau 1. Association de la tâche Condition et de son expression de condition au pipeline
Tâche Condition Domaine d'influence Fonctionnement

Tâche Condition

Pipeline

La tâche Condition détermine si le pipeline s'exécute ou s'arrête à ce stade, selon que la sortie de la tâche est true ou false.

Expression de condition

Sortie de la tâche Condition

Lorsque le pipeline s'exécute, l'expression de condition que vous incluez dans la tâche Condition génère un état de sortie true ou false. Par exemple, une expression de condition peut nécessiter que l'état de sortie de la tâche Condition soit Terminé ou utiliser un numéro de build 74.

L'expression de condition s'affiche dans l'onglet Tâche, dans la tâche Condition.

Les constructions prises en charge pour l'expression conditionnelle s'affichent et fournissent des exemples de variables de pipeline, de variables de sortie de tâche, de valeurs et d'opérateurs.

La tâche Condition diffère en termes de fonction et de comportement du paramètre Sur condition dans d'autres types de tâche.

La condition Sur condition est disponible dans d'autres types de tâches.

Dans d'autres types de tâches, Sur condition détermine si la tâche actuelle s'exécute, plutôt que les tâches successives, en fonction de l'évaluation de son expression de condition préalable true ou false. L'expression de condition du paramètre Sur condition génère un état de sortie true ou false pour la tâche actuelle lorsque le pipeline s'exécute. Le paramètre Sur condition s'affiche dans l'onglet Tâche avec sa propre expression de condition.

Cet exemple utilise la tâche Condition.

Conditions préalables

  • Vérifiez qu'un pipeline existe, et qu'il inclut des étapes et des tâches.

Procédure

  1. Dans votre pipeline, déterminez le point de décision au niveau duquel la tâche Condition doit s'afficher.
  2. Ajoutez la tâche Condition avant la tâche qui dépend de son état de réussite ou d'échec.
  3. Ajoutez une expression de condition à la tâche Condition.
    Par exemple : "${Stage1.task1.output.status}" == "COMPLETED" || ${input.buildNumber} == 74
    Ajoutez une tâche Condition avec une expression de condition évaluée à true ou false lors de l'exécution du pipeline.
  4. Validez la tâche.
  5. Enregistrez le pipeline, puis activez-le et exécutez-le.

Résultats

Observez les exécutions de pipeline et notez si le pipeline continue à s'exécuter ou s'arrête au niveau de la tâche Condition.

Que faire ensuite

Si vous restaurez un déploiement de pipeline, vous pouvez également utiliser la tâche Condition. Par exemple, dans un pipeline de restauration, la tâche Condition permet à Code Stream de marquer l'échec d'un pipeline en fonction de l'expression de condition et peut déclencher un flux de restauration unique pour différents types d'échec.

Pour restaurer un déploiement, reportez-vous à la section Restauration d'un déploiement dans Code Stream.