Exécution conditionnelle et dépendances entre tâches

Toutes les étapes ne doivent pas être exécutées à chaque fois. Vous pouvez vouloir qu’une étape de déploiement s’exécute uniquement sur la branche main, ou qu’une étape de notification s’exécute uniquement lorsqu’un problème est survenu.

GitHub Actions vous permet d’associer une condition if à n’importe quelle étape ou tâche afin de contrôler son exécution.

Ajoutez une clé if: à une étape. L’étape ne s’exécute que lorsque l’expression est évaluée comme vraie.

Les expressions placées dans if n’ont pas besoin de l’enveloppe ${{ }}, même si celle-ci est autorisée.

Les conditions sont lues à partir d’objets de contexte qui décrivent l’exécution :

• github — événement, référence, acteur, sha
• env — variables d’environnement
• job et steps — état des travaux précédents
• runner — OS et architecture

Par exemple, github.event_name vous indique si un push ou une pull_request a déclenché l’exécution.

Par défaut, une étape est ignorée si une étape précédente a échoué. Pour remplacer ce comportement, utilisez les fonctions d’état :

• success() — vrai si aucune étape précédente n’a échoué (valeur par défaut)
• failure() — vrai si une étape précédente a échoué
• always() — s’exécute quoi qu’il arrive
• cancelled() — vrai si l’exécution a été annulée

Un schéma courant consiste à ajouter une étape de nettoyage qui doit s’exécuter même si des étapes précédentes ont échoué. Utilisez if: always().

Cela garantit que les ressources temporaires, les conteneurs ou les rapports de test sont traités quel que soit le résultat.

Le mot-clé needs oblige une tâche à attendre les autres. Sans lui, les tâches s’exécutent en parallèle.

Une tâche indiquée dans needs doit se terminer correctement avant le démarrage de la tâche dépendante.

Une tâche peut dépendre de plusieurs autres tâches en transmettant une liste à needs. Elle attend qu’elles soient toutes terminées.

C’est ainsi que vous construisez des schémas de convergence, dans lesquels une tâche finale ne s’exécute qu’après la réussite de toutes les tâches parallèles.

La clé if fonctionne également avec les tâches, et pas seulement avec les étapes. Une condition au niveau de la tâche détermine si la tâche entière s’exécute.

Ici, la tâche de déploiement ne s’exécute que pour les push vers main, tout en dépendant des tests.

Les tâches peuvent transmettre des données aux tâches en aval via outputs. Une tâche dépendante les lit dans le contexte needs.

Une condition peut ainsi dépendre d’une valeur calculée précédemment, par exemple pour déterminer si une version a changé.

Vous pouvez combiner des expressions avec && (et), || (ou) et ! (non).

Cet exemple ne s’exécute qu’à la suite d’un push réussi vers main qui ne provient pas d’un dépôt dérivé.

Attention : une tâche utilisant needs est ignorée si une dépendance échoue. Pour exécuter une tâche finale de génération de rapports dans tous les cas, combinez needs avec if: always().

À l’intérieur, vous pouvez examiner needs.<job>.result pour déterminer ce qu’il faut signaler.

Vérifiez votre compréhension de l’exécution conditionnelle.

Vous avez appris à contrôler le flux d’exécution avec les conditions et les dépendances.

• if conditionne les étapes et les tâches à partir d’expressions
• Les fonctions d’état comme failure() et always() permettent de remplacer l’omission en cas d’échec
• needs crée des ordres d’exécution et des schémas de convergence
• Les outputs des tâches fournissent des valeurs aux conditions suivantes

Ces mécanismes vous permettent de construire des chaînes d’exécution précises et efficaces.