Note
No momento, não há suporte para executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.
Introdução
Este tutorial demonstra como usar a GitHub CLI para adicionar um comentário a um problema quando um rótulo específico é aplicado. Por exemplo, quando o rótulo help wanted
é adicionado a um problema, você pode adicionar um comentário para incentivar os colaboradores a trabalhar no problema. Para obter mais informações sobre GitHub CLI, confira "Usar o GitHub CLI em fluxos de trabalho".
No tutorial, primeiro, você criará um arquivo de fluxo de trabalho que usa o comando gh issue comment
para comentar em um problema. Então, você personalizará o fluxo de trabalho para atender às suas necessidades.
Criar o fluxo de trabalho
-
Escolha um repositório onde você deseja aplicar este fluxo de trabalho de gerenciamento de projetos. Você pode usar um repositório existente ao qual você tem acesso de gravação ou criar um novo repositório. Para obter mais informações sobre como criar um repositório, confira "Criar um repositório".
-
No repositório, crie um arquivo chamado
.github/workflows/YOUR_WORKFLOW.yml
, substituindoYOUR_WORKFLOW
por um nome de sua escolha. Este é um arquivo do fluxo de trabaho. Para obter mais informações sobre como criar arquivos no GitHub, confira "Criar arquivos". -
Copie o seguinte conteúdo YAML para o arquivo do fluxo de trabalho.
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:
-
Personalize os parâmetros no seu arquivo do fluxo de trabalho:
- Substitua
help wanted
emif: github.event.label.name == 'help wanted'
pelo rótulo no qual deseja trabalhar. Caso deseje trabalhar em mais de um rótulo, separe as condições com||
. Por exemplo,if: github.event.label.name == 'bug' || github.event.label.name == 'fix me'
adicionará um comentário sempre que os rótulosbug
oufix me
forem adicionados a um problema. - Altere o valor de
BODY
para o comentário que deseja adicionar. Markdown em estilo GitHub é compatível. Para obter mais informações sobre markdown, confira "Sintaxe básica de gravação e formatação no GitHub".
- Substitua
-
Faça o commit do arquivo de fluxo de trabalho para o branch padrão do seu repositório. Para obter mais informações, confira "Criar arquivos".
Testar o fluxo de trabalho
Toda vez que um problema no repositório for identificado, esse fluxo de trabalho será executado. Se o rótulo adicionado for um dos rótulos especificados no arquivo de fluxo de trabalho, o comando gh issue comment
adicionará o comentário especificado ao problema.
Teste seu fluxo de trabalho aplicando a sua etiqueta especificada a um problema.
- Abra um problema no seu repositório. Para obter mais informações, confira "Criar um problema".
- Etiquete o problema com a etiqueta especificada no seu arquivo de fluxo de trabalho. Para obter mais informações, confira "Gerenciar etiquetas".
- Para ver a execução do fluxo de trabalho acionada etiquetando o problema, veja o histórico de execuções do seu fluxo de trabalho. Para obter mais informações, confira "Visualizar o histórico de execução do fluxo de trabalho".
- Quando o fluxo de trabalho é concluído, o problema que você etiquetou deve ter um comentário adicionado.
Próximas etapas
- Para saber mais sobre o que mais você pode fazer com a CLI do GitHub, como editar comentários existentes, acesse o Manual da CLI do GitHub.