Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Déplacement des problèmes attribués sur les tableaux de projet

Vous pouvez utiliser GitHub Actions pour déplacer automatiquement un problème vers une colonne spécifique d’un tableau de projet quand le problème est affecté.

Remarque : Les exécuteurs hébergés sur GitHub ne sont pas pris en charge sur GitHub Enterprise Server. Vous pouvez voir plus d’informations sur le support futur planifié dans la GitHub public roadmap.

Introduction

Ce tutoriel montre comment utiliser l’action alex-page/github-project-automation-plus pour déplacer automatiquement un problème vers une colonne spécifique d’un tableau de projet lorsque le problème est affecté. Par exemple, quand un problème est affecté, vous pouvez le placer dans la colonne In Progress de votre tableau de projet.

Dans ce tutoriel, vous allez d’abord créer un fichier de workflow qui utilise l’action alex-page/github-project-automation-plus. Ensuite, vous personnaliserez le workflow en fonction de vos besoins.

Création du workflow

  1. Choisissez un dépôt où vous souhaitez appliquer ce workflow de gestion de projet. Vous pouvez utiliser un dépôt existant auquel vous avez accès en écriture ou en créer un nouveau. Pour plus d’informations sur la création d’un dépôt, consultez « Création d’un dépôt ».

  2. Dans votre dépôt, choisissez un tableau de projet. Vous pouvez utiliser un projet existant ou en créer un nouveau. Pour plus d’informations sur la création d’un projet, consultez « Création d’un project board ».

  3. Dans votre dépôt, créez un fichier nommé .github/workflows/YOUR_WORKFLOW.yml, en YOUR_WORKFLOW remplaçant par un nom de votre choix. Il s’agit d’un fichier de workflow. Pour plus d’informations sur la création de nouveaux fichiers dans GitHub, consultez « Création de fichiers ».

  4. Copiez le contenu YAML suivant dans votre fichier de workflow.

    YAML
    # Ce workflow utilise des actions qui ne sont pas certifiées par GitHub.
    # Elles sont fournies par un tiers et régies par
    # des conditions d’utilisation du service, une politique de confidentialité et un support distincts.
    # documentation en ligne.
    
    # GitHub recommande d’épingler les actions à un SHA de commit.
    # Pour obtenir une version plus récente, vous devez mettre à jour le SHA.
    # Vous pouvez également référencer une balise ou une branche, mais l’action peut changer sans avertissement.
    
    name: Move assigned card
    on:
      issues:
        types:
          - assigned
    jobs:
      move-assigned-card:
        runs-on: ubuntu-latest
        steps:
          - uses: alex-page/github-project-automation-plus@5bcba1c1c091a222584d10913e5c060d32c44044
            with:
              project: Docs Work
              column: In Progress
              repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
  5. Personnalisez les paramètres dans votre fichier de workflow :

    • Remplacez la valeur de project par le nom de votre tableau de projet. Si vous avez plusieurs tableaux de projet portant le même nom, l’action alex-page/github-project-automation-plus agit sur tous les projets portant le nom spécifié.
    • Remplacez la valeur de column par le nom de la colonne dans laquelle vous souhaitez que les problèmes soient placés quand ils sont affectés.
    • Remplacez la valeur de repo-token :
      1. Créez un personal access token avec l’étendue repo. Pour plus d’informations, consultez « Création d’un jeton d’accès personnel ».
      2. Enregistrez ce personal access token en tant que secret dans votre référentiel. Pour plus d’informations sur le stockage de secrets, consultez « Secrets chiffrés ».
      3. Dans votre fichier de workflow, remplacez PERSONAL_ACCESS_TOKEN par le nom de votre secret.
  6. Commitez votre fichier de workflow dans la branche par défaut de votre dépôt. Pour plus d’informations, consultez « Création de fichiers ».

Test du workflow

Chaque fois qu’un problème dans votre dépôt est affecté, le problème est placé dans la colonne de tableau de projet spécifiée. Si le problème ne figure pas encore dans le tableau de projet, il est ajouté au tableau de projet.

Si votre dépôt appartient à l’utilisateur, l’action alex-page/github-project-automation-plus agit sur tous les projets de votre dépôt ou compte personnel qui ont le nom et la colonne de projet spécifiés. De même, si votre dépôt appartient à l’organisation, l’action agit sur tous les projets de votre dépôt ou organisation qui ont le nom et la colonne de projet spécifiés.

Testez votre workflow en affectant un problème dans votre dépôt.

  1. Ouvrez un problème dans votre dépôt. Pour plus d’informations, consultez « Création d’un problème ».
  2. Affectez le problème. Pour plus d’informations, consultez « Affectation de problèmes et demandes de tirage à d’autres utilisateurs GitHub ».
  3. Pour voir l’exécution de workflow déclenchée par l’affectation du problème, affichez l’historique de vos exécutions de workflow. Pour plus d’informations, consultez « Affichage de l’historique des exécutions de workflows ».
  4. Une fois le workflow terminé, le problème que vous avez affecté doit être ajouté à la colonne de tableau de projet spécifiée.

Étapes suivantes