Utilisation de modèles de workflow

À 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 offre des modèles de flux de travail pour une variété de langues et d'outils. Lorsque vous configurez des flux de travail dans votre référentiel, GitHub analyse le code dans votre référentiel et recommande des flux de travail basés sur le langage et le framework de votre référentiel. Par exemple, si vous utilisez Node.js, GitHub suggérera un fichier modèle de flux de travail qui installe vos paquets 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 :

• Déploiement (CD) . Pour plus d’informations, consultez « Continuous deployment ».

• Intégration continue (CI) . Pour plus d’informations, consultez « Continuous integration ».

• 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.

Vous pouvez également créer votre propre modèle de workflow et le partager avec votre organisation. Ces modèles de flux de travail apparaîtront à côté des modèles de flux de travail 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.

   

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 « Building and testing ».

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 « Using secrets in 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

• Continuous integration
• Gestion des exécutions et des déploiements de workflow
• Tutoriels pour GitHub Actions