Générations matricielles pour plusieurs environnements

Découvrez une fonctionnalité puissante de GitHub Actions : les exécutions en matrice ! Imaginez que vous deviez tester votre code dans de nombreux environnements différents, comme plusieurs systèmes d’exploitation ou versions de langages de programmation.

Au lieu de créer un flux de travail distinct pour chaque combinaison, les exécutions en matrice vous permettent de définir un ensemble de variables. GitHub Actions exécute alors automatiquement vos tâches pour chaque combinaison possible de ces variables.

Les exécutions en matrice sont particulièrement utiles pour :

• Tests multiplateformes : vérifier que votre application fonctionne sous Windows, macOS et Linux.
• Compatibilité multiversion : effectuer des tests avec différentes versions de Node.js, de Python ou de votre base de données.
• Exécution en parallèle : exécuter tous ces tests simultanément afin de gagner beaucoup de temps.

Elles vous aident à obtenir efficacement une couverture de test plus étendue.

Vous définissez une matrice dans la section strategy d’une tâche. Dans strategy.matrix, vous répertoriez une ou plusieurs variables, chacune contenant un tableau de valeurs.

GitHub Actions crée ensuite une tâche pour chaque combinaison. Voyons à quoi cela ressemble :

Dans l’extrait précédent, nous avons défini une variable node-version avec trois valeurs : 14, 16 et 18.

Cette définition d’une seule tâche déclenchera trois tâches distinctes, chacune s’exécutant sur ubuntu-latest, mais utilisant une version différente de Node.js. Cela garantit que votre projet fonctionne avec chacune de ces versions.

Vous n’êtes pas limité à une seule variable ! Vous pouvez combiner plusieurs variables dans votre matrice. Par exemple, vous pouvez vouloir tester différents systèmes d’exploitation avec différentes versions de Node.js.

Il suffit d’ajouter d’autres paires clé-valeur sous strategy.matrix. Le nombre total de tâches correspond au produit du nombre de valeurs de chaque variable.

Voici comment configurer une matrice pour effectuer des tests à la fois sur Ubuntu et Windows, avec les versions 16 et 18 de Node.js.

Cette configuration créera 2 (OS) * 2 (versions de Node.js) = 4 tâches distinctes.

Vous aurez parfois besoin de combinaisons spécifiques qui ne sont pas couvertes par le produit cartésien par défaut, ou vous voudrez ajouter des variables supplémentaires à certaines compilations. Utilisez include pour ajouter de nouvelles entrées à la matrice.

Par exemple, vous pouvez vouloir exécuter un test supplémentaire uniquement sur Ubuntu avec Node.js 14, ou transmettre une variable d’environnement spécifique à une combinaison donnée de système d’exploitation et de version.

Que faire si une combinaison est connue pour échouer ou n’est pas pertinente pour votre projet ? Le mot-clé exclude vous permet de supprimer des configurations spécifiques de votre matrice.

Cela vous aide à éviter les exécutions de tâches inutiles et à vous concentrer sur les cas de test pertinents.

Dans les étapes de votre tâche, vous pouvez accéder aux valeurs actuelles des variables de la matrice à l’aide de la syntaxe ${{ matrix.variable_name }}. Cette possibilité est essentielle pour configurer des outils ou exécuter des commandes propres à chaque combinaison de la matrice.

Par exemple, ${{ matrix.os }} définit dynamiquement le système d’exploitation de l’exécuteur, tandis que ${{ matrix.node-version }} configure l’action de configuration de Node.js.

Les exécutions en matrice sont particulièrement utiles pour :

• Développement de bibliothèques : effectuer des tests avec plusieurs versions d’une dépendance.
• Projets multilingues : compiler et tester des composants écrits dans différents langages ou utilisant différents compilateurs.
• Compatibilité des navigateurs : si vous utilisez un outil qui le permet, tester des applications web sur différents navigateurs.

Elles transforment des scénarios de test complexes en flux de travail concis et faciles à maintenir.

Considérez un flux de travail GitHub Actions qui utilise une stratégie matricielle. La matrice est définie comme suit :

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest]
    python-version: [3.8, 3.9]
    exclude:
      - os: macos-latest
        python-version: 3.8

Combien de tâches cette configuration matricielle créera-t-elle ?

Excellent travail ! Vous avez découvert les exécutions en matrice de GitHub Actions.

• Elles vous permettent d’exécuter des tâches pour plusieurs combinaisons de variables (OS, versions de langages, etc.).
• Elles sont définies à l’aide de strategy.matrix dans une tâche.
• include ajoute des combinaisons spécifiques, tandis que exclude les supprime.
• Les variables sont accessibles via ${{ matrix.variable_name }}.

Les exécutions en matrice sont essentielles pour effectuer efficacement des tests complets dans des environnements variés. Continuez à vous exercer pour les maîtriser !