Skip to main content

Démarrage rapide pour GitHub Actions

Essayez les fonctionnalités de GitHub Actions en 5 minutes ou moins.

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à. Le répertoire doit avoir ce nom exact afin que GitHub puisse découvrir tous les flux de travail GitHub Actions qu’il contient.

  2. Dans le répertoire .github/workflows, créez un fichier avec l’extension .yml ou .yaml. Ce tutoriel utilisera github-actions-demo.yml comme nom de fichier. Pour plus d’informations, consultez « Création de fichiers ».

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

    YAML
    name: GitHub Actions Demo
    run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
    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@v4
          - 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.

    Capture d’écran de la zone « Valider le nouveau fichier » de la page.

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 GitHub.com, accédez à la page principale du dépôt.

  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. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher, dans cet exemple « GitHub Actions Demo ».

    Capture d’écran de la page « Actions ». Le nom de l’exemple de workflow, « GitHub Actions Demo », est mis en évidence avec un encadré orange foncé.

  4. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution que vous souhaitez voir, dans cet exemple « USERNAME is testing out GitHub Actions ».

  5. Dans la barre latérale gauche de la page d’exécution du workflow, sous Travaux, cliquez sur le travail Explore-GitHub-Actions.

    Capture d’écran de la page « Exécution du workflow ». Dans la barre latérale gauche, le travail « Explore-GitHub-Actions » est mis en évidence avec un encadré orange foncé.

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

    Capture d’écran des étapes exécutées par le workflow.

    Par exemple, vous pouvez voir la liste des fichiers dans votre dépôt : Capture d’écran de l’étape « Lister les fichiers dans le dépôt » développée pour montrer la sortie du journal. La sortie de l’étape est mise en évidence avec un encadré orange foncé.

L’exemple de workflow que vous venez d’ajouter est déclenché chaque fois que du code est poussé vers la branche, et montre comment GitHub Actions peut fonctionner avec le contenu de votre dépôt. Pour suivre un tutoriel détaillé, consultez « Comprendre GitHub Actions ».

Plus de workflows de démarrage

GitHub fournit des workflows 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 des workflows de démarrage CI qui pourraient être utiles 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 des workflows de démarrage comme point de départ pour créer votre workflow personnalisé, ou les utiliser en l’état.

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

Étapes suivantes

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 :

  • Pour obtenir un moyen rapide de créer un flux de travail GitHub Actions, consultez « Utilisation de workflows de démarrage ».
  • Pour obtenir des workflows d’intégration continue (CI) permettant de générer et tester votre code, consultez « Automatisation des builds et des tests ».
  • Pour générer et publier des packages, consultez « Publication de packages ».
  • Pour le déploiement de projets, consultez « Déploiement ».
  • Pour automatiser les tâches et les processus sur GitHub, consultez « Gestion des problèmes et demandes de tirage ».
  • Pour obtenir des exemples illustrant les fonctionnalités plus complexes de GitHub Actions, dont beaucoup des cas d’usage ci-dessus, consultez « Exemples ». Des exemples détaillés expliquent comment tester votre code sur un exécuteur et accéder à la CLI GitHub. Ils montrent également comment utiliser des fonctions avancées telles que la concurrence et les matrices de test.
  • Si vous souhaitez certifier vos compétences en matière d'automatisation des flux de travail et d'accélération du développement avec GitHub Actions, vous pouvez obtenir un certificat GitHub Actions avec GitHub Certifications. Pour plus d’informations, consultez « À propos de GitHub Certifications ».