Démarrage rapide pour GitHub Actions

Introduction

Vous n’avez besoin que d’un dépôt GitHub pour créer et exécuter un workflow GitHub Actions. Dans ce guide, vous allez ajouter un workflow qui illustre certaines des fonctionnalités essentielles de GitHub Actions.

L’exemple suivant vous montre comment les travaux GitHub Actions peuvent être déclenchés automatiquement, où ils s’exécutent et comment ils peuvent interagir avec le code dans votre dépôt.

Création de votre premier workflow

1. Créez un répertoire .github/workflows dans votre dépôt sur GitHub si ce répertoire n’existe pas déjà.

2. Dans le répertoire .github/workflows, créez un fichier nommé github-actions-demo.yml. Pour plus d’informations, consultez « Création de nouveaux fichiers ».

3. Copiez le contenu YAML suivant dans le fichier github-actions-demo.yml :

   YAML

   name: GitHub Actions Demo
   on: [push]
   jobs:
     Explore-GitHub-Actions:
       runs-on: ubuntu-latest
       steps:
         - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
         - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
         - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
         - name: Check out repository code
           uses: actions/checkout@v3
         - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
         - run: echo "🖥️ The workflow is now ready to test your code on the runner."
         - name: List files in the repository
           run: |
             ls ${{ github.workspace }}
         - run: echo "🍏 This job's status is ${{ job.status }}."
   

4. Faites défiler la page jusqu’en bas et sélectionnez Créer une branche pour ce commit, puis lancer une demande de tirage. Ensuite, pour créer une demande de tirage (pull request), cliquez sur Proposer un nouveau fichier.

Le commit du fichier de workflow dans une branche de votre dépôt déclenche l’événement push et exécute votre workflow.

Affichage des résultats de votre workflow

1. Dans , accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions.

2. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.

   

3. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution que vous souhaitez voir.

   

4. Sous Jobs, cliquez sur le travail Explore-GitHub-Actions.

   

5. Le journal vous montre comment chacune des étapes a été traitée. Développez l’une des étapes pour afficher ses détails.

   

   Par exemple, vous pouvez voir la liste des fichiers dans votre dépôt :

Plus de workflows de démarrage

GitHub fournit un workflow de démarrage préconfiguré que vous pouvez personnaliser pour créer votre propre workflow d’intégration continue. GitHub analyse votre code et affiche un workflow de démarrage CI qui pourrait être utile pour votre référentiel. Par exemple, si votre référentiel contient du code Node.js, vous verrez des suggestions de projets Node.js. Vous pouvez utiliser le workflow de démarrage comme point de départ pour créer votre workflow personnalisé ou l’utiliser tel quel.

Vous pouvez parcourir la liste complète des workflows de démarrage dans le référentiel actions/starter-workflows.

Exemples plus complexes

Pour obtenir des exemples illustrant des fonctionnalités plus complexes de GitHub Actions, consultez « Exemples ». Vous pouvez voir des exemples détaillés qui expliquent comment tester votre code sur un exécuteur, accéder à l’interface CLI GitHub et utiliser des fonctionnalités avancées telles que les matrices de test et de concurrence.

Étapes suivantes

L’exemple de workflow que vous venez d’ajouter s’exécute chaque fois que du code est envoyé (push) vers la branche et vous montre comment GitHub Actions peut fonctionner avec le contenu de votre dépôt. Mais ce n’est que le début de ce que vous pouvez faire avec GitHub Actions :

• Votre dépôt peut contenir plusieurs workflows qui déclenchent des travaux différents en fonction d’événements différents.
• Vous pouvez utiliser un workflow pour installer des applications de test de logiciels et faire en sorte qu’elles testent automatiquement votre code sur les exécuteurs de GitHub.

GitHub Actions peut vous aider à automatiser presque tous les aspects de vos processus de développement d’applications. Vous êtes prêt à commencer ? Voici quelques ressources utiles pour effectuer vos étapes suivantes avec GitHub Actions :

• « Découvrir GitHub Actions » pour obtenir un tutoriel approfondi.