Déplacement des problèmes affectés sur projets (classique)

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

Dans cet article

Note

  • Projects, la toute nouvelle expérience de projet, est maintenant disponible. Pour plus d’informations sur Projects, consultez « À propos des Projects ».
  • Vous pouvez uniquement créer un projet (classique) pour une organisation, un référentiel, ou un utilisateur qui a déjà au moins un projet (classique). Si vous ne parvenez pas à créer un projet (classique), créez à la place un projet.

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 projet (classique) 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 projet (classique).

Dans le 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 référentiel, choisissez un projet (classique). Vous pouvez utiliser un projet existant ou créer un nouveau projet. Pour plus d'informations sur la création d'un projet, consultez « Création d’un project (classic). »

  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@7ffb872c64bd809d23563a130a0a97d01dfa8f43
        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 projet (classique). Si vous avez plusieurs projets (classique) 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 (classic) avec l’étendue repo. Pour plus d’informations, consultez « Gestion de vos jetons d'accès personnels ».
      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 « Utilisation de secrets dans GitHub Actions ».
      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 projet (classique) spécifiée. Si le problème n’est pas déjà dans le projet (classique), il est ajouté au projet (classique).

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 projet (classique) spécifiée.

Étapes suivantes