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 GitHub CLI pour commenter un problème lors de l’application d’une étiquette spécifique. Par exemple, quand l’étiquette help wanted
est ajoutée à un problème, vous pouvez ajouter un commentaire pour encourager les contributeurs à travailler sur le problème. Pour plus d’informations sur GitHub CLI, consultez « Utilisation de l’interface CLI de GitHub dans des workflows ».
Dans le tutoriel, vous allez d’abord créer un fichier de workflow qui utilise la commande gh issue comment
pour commenter un problème. Ensuite, vous personnaliserez le workflow en fonction de vos besoins.
Création du workflow
-
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 ».
-
Dans votre dépôt, créez un fichier nommé
.github/workflows/YOUR_WORKFLOW.yml
, enYOUR_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 ». -
Copiez le contenu YAML suivant dans votre fichier de workflow.
YAML name: Add comment on: issues: types: - labeled jobs: add-comment: if: github.event.label.name == 'help wanted' runs-on: ubuntu-latest permissions: issues: write steps: - name: Add comment run: gh issue comment "$NUMBER" --body "$BODY" env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} GH_REPO: ${{ github.repository }} NUMBER: ${{ github.event.issue.number }} BODY: > This issue is available for anyone to work on. **Make sure to reference this issue in your pull request.** :sparkles: Thank you for your contribution! :sparkles:
name: Add comment on: issues: types: - labeled jobs: add-comment: if: github.event.label.name == 'help wanted' runs-on: ubuntu-latest permissions: issues: write steps: - name: Add comment run: gh issue comment "$NUMBER" --body "$BODY" env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} GH_REPO: ${{ github.repository }} NUMBER: ${{ github.event.issue.number }} BODY: > This issue is available for anyone to work on. **Make sure to reference this issue in your pull request.** :sparkles: Thank you for your contribution! :sparkles:
-
Personnalisez les paramètres dans votre fichier de workflow :
- Remplacez
help wanted
dansif: github.event.label.name == 'help wanted'
par l’étiquette sur laquelle vous souhaitez agir. Si vous souhaitez agir sur plusieurs étiquettes, séparez les conditions avec||
. Par exemple,if: github.event.label.name == 'bug' || github.event.label.name == 'fix me'
commentera chaque fois que les étiquettesbug
oufix me
seront ajoutées à un problème. - Modifiez la valeur de
BODY
pour le commentaire que vous souhaitez ajouter. Le markdown adapté à GitHub est pris en charge. Pour plus d’informations sur le markdown, consultez « Syntaxe de base pour l'écriture et la mise en forme ».
- Remplacez
-
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 étiqueté, ce workflow s’exécute. Si l’étiquette ajoutée est l’une de celles que vous avez spécifiées dans votre fichier de workflow, la commande gh issue comment
ajoute le commentaire que vous avez spécifié au problème.
Testez votre workflow en appliquant votre étiquette spécifiée à un problème.
- Ouvrez un problème dans votre dépôt. Pour plus d’informations, consultez « Creating an issue ».
- Étiquetez le problème avec l’étiquette spécifiée dans votre fichier de workflow. Pour plus d’informations, consultez « Gestion des étiquettes ».
- Pour voir l’exécution du workflow déclenchée par l’étiquetage du problème, affichez l’historique des exécutions de votre workflow. Pour plus d’informations, consultez « Affichage de l’historique des exécutions de workflows ».
- Une fois le workflow terminé, le problème que vous avez étiqueté doit avoir un commentaire ajouté.
Étapes suivantes
- Pour en savoir plus sur les autres actions que vous pouvez faire avec l’interface CLI GitHub, comme la modification de commentaires existants, consultez le Manuel de l’interface CLI GitHub.