Utilisation de modèles de workflow

GitHub fournit des modèles de workflow pour une variété de langages et d’outils.

Dans cet article

À propos des modèles de workflow

Les modèles de workflow sont des modèles qui vous aident à créer vos propres workflows GitHub Actions pour un référentiel. Ils offrent une alternative au démarrage à partir d’un fichier de flux de travail vide et sont utiles, car certains travaux ont déjà été effectués pour vous.

GitHub propose des modèles de workflow pour une variété de langages et d’outils. Lorsque vous configurez des workflows dans votre dépôt, GitHub analyse le code de votre dépôt et recommande des workflows basés sur le langage et le framework de votre dépôt. Par exemple, si vous utilisez Node.js, GitHub suggérera un fichier modèle de workflow qui installe vos packages Node.js et exécute vos tests. Vous pouvez effectuer des recherches et des filtres pour trouver des modèles de workflow pertinents.

GitHub fournit des modèles de workflows prêts à l’emploi pour les catégories de haut niveau suivantes :

  • Intégration continue (CI) . Pour plus d’informations, consultez « À propos de l’intégration continue avec GitHub Actions ».
  • Automatisation. Les modèles de workflows d’automatisation offrent des solutions pour automatiser les workflows, comme le triage des demandes de tirage (pull requests) et l’application d’une étiquette en fonction des chemins d’accès qui sont modifiés dans la demande de tirage ou l’accueil des utilisateurs qui sont contributeurs au référentiel pour la première fois.

Utilisez ces workflows comme point de départ pour générer votre propre workflow ou utilisez-les tels quels. Vous pouvez parcourir la liste complète des modèles de flux de travail dans le référentiel actions/starter-workflows. Pour plus d’informations, consultez « Utilisation de modèles de workflow ».

Vous pouvez également créer votre propre modèle de workflow et le partager avec votre organisation. Ces modèles de workflow s’affichent à côté des modèles de workflow fournis par GitHub. Tout utilisateur disposant d’un accès en écriture au référentiel github de l’organisation peut configurer un modèle de workflow. Pour plus d’informations, consultez « Création de modèles de workflow pour votre organisation ».

Sélection et utilisation d’un modèle de workflow

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre dépôt, cliquez sur Actions.

    Capture d’écran des onglets du référentiel « github/docs ». L’onglet « Actions » est mis en surbrillance avec un encadré orange.

  3. Si vous disposez déjà d’un workflow dans votre dépôt, cliquez sur Nouveau workflow.

  4. La page « Choisir un workflow » présente une sélection de modèles de workflow recommandés. Recherchez le modèle de workflow que vous souhaitez utiliser, puis cliquez sur Configurer. Pour vous aider à trouver le modèle de workflow souhaité, vous pouvez effectuer une recherche par mots-clés ou filtrer par catégorie.

  5. Si le modèle de workflow contient des commentaires détaillant des étapes de configuration supplémentaires, suivez ces étapes.

    Des guides accompagnent de nombreux modèles de workflow pour générer et tester des projets. Pour plus d’informations, consultez « Création et test ».

  6. Certains modèles de workflow utilisent des secrets. Par exemple, ${{ secrets.npm_token }}. Si le modèle de workflow utilise un secret, stockez la valeur décrite dans le nom du secret en tant que secret dans votre référentiel. Pour plus d’informations, consultez « Utilisation de secrets dans GitHub Actions ».

  7. Si vous le souhaitez, apportez des modifications supplémentaires. Par exemple, vous pouvez modifier la valeur de on pour changer le moment d’exécution du workflow.

  8. Cliquez sur Commencer le commit.

  9. Écrivez un message de commit et décidez s’il faut effectuer le commit directement dans la branche par défaut ou ouvrir une demande de tirage (pull request).

Pour aller plus loin