Adicionando etiquetas a problemas

Introdução

Este tutorial demonstra como usar a ação andymckay/labeler em um fluxo de trabalho para etiquetar problemas recém-abertos ou reabertos. Por exemplo, você pode adicionar a etiqueta triagem toda vez que um problema for aberto ou reaberto. Em seguida, você poderá ver todos os problemas que devem ser triados, filtrando por problemas com a etiqueta triagem.

No tutorial, primeiro você criará um arquivo de fluxo de trabalho que usa a ação andymckay/labeler. Então, você personalizará o fluxo de trabalho para atender às suas necessidades.

Criar o fluxo de trabalho

1. 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, consulte "Criar um repositório".

2. No repositório, crie um arquivo denominado .github/workflows/YOUR_WORKFLOW.yml, substituindo YOUR_WORKFLOW por um nome da sua escolha. Este é um arquivo do fluxo de trabaho. Para obter mais informações sobre como criar novos arquivos no GitHub, consulte "Criar novos arquivos".

3. Copie o seguinte conteúdo YAML para o arquivo do fluxo de trabalho.

   YAML

   # This workflow uses actions that are not certified by GitHub.
   # São fornecidas por terceiros e regidas por
   # termos de serviço, política de privacidade e suporte separados
   # documentação.
   
   name: Label issues
   on:
     issues:
       types:
         - reopened
         - opened
   jobs:
     label_issues:
       runs-on: ubuntu-latest
       steps:
         - name: Label issues
           uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414
           with:
             add-labels: "triage"
             repo-token: ${{ secrets.GITHUB_TOKEN }}

4. Personalize os parâmetros no seu arquivo do fluxo de trabalho:

   • Altere o valor de add-labels para a lista de etiquetas que você deseja adicionar ao problema. Separe etiquetas múltiplas com vírgulas. Por exemplo, "help wanted, good first issue". Para obter mais informações sobre etiquetas, consulte "Gerenciar etiquetas".

5. Faça o commit do arquivo de fluxo de trabalho para o branch padrão do seu repositório. Para obter mais informações, consulte "Criar arquivos".

Testar o fluxo de trabalho

Toda vez que um problema no seu repositório for aberto ou reaberto, esse fluxo de trabalho adicionará as etiquetas que você especificou ao problema.

Teste o seu fluxo de trabalho criando um problema no seu repositório.

1. Crie um problema no seu repositório. Para obter mais informações, consulte "Criar um problema".
2. Para ver a execução do fluxo de trabalho que foi acionada criando o problema, veja o histórico de execuções do seu fluxo de trabalho. Para obter mais informações, consulte "Visualizar histórico de execução de fluxo de trabalho".
3. Quando o fluxo de trabalho é concluído, o problema que você criou deve ter as etiquetas especificadas adicionadas.

Próximas etapas

• Para saber mais sobre coisas adicionais você pode fazer com a ação andymckay/labeler, como remover etiquetas ou ignorar esta ação se o problema for atribuído ou tiver uma etiqueta específica, veja a documentação da ação andymckay/labeler.
• Para saber mais sobre diferentes eventos que podem acionar o seu fluxo de trabalho, consulte "Eventos que desencadeiam fluxos de trabalho". A ação andymckay/labeler só funciona em eventos issues, pull_request ou project_card.
• Pesquise no GitHub exemplos de fluxos de trabalho que usam esta ação.