Remover uma etiqueta quando um cartão é adicionado à coluna de um quadro de projeto

Você pode usar GitHub Actions para remover automaticamente uma etiqueta quando um problema ou pull request for adicionado a uma coluna específica no quadro de um projeto.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub AE. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório.

Observação: GitHub Actions está atualmente na versão beta para GitHub AE.

Aviso: Os executores auto-hospedados estão desabilitados para GitHub AE. Isso porque GitHub AE oferece garantias para as fronteiras de segurança que são incompatíveis com a forma como os executores hospedados funcionam. No entanto, se você precisar usar executores auto-hospedados com GitHub AE e entender as implicações de segurança, você poderá entrar em contato com o suporte de GitHub para uma exceção de segurança que irá habilitar executores auto-hospedados.

Se você não precisar de executores auto-hospedados, você poderá usar AE hosted runners para executar seus fluxos de trabalho. Para obter mais informações, consulte "Sobre AE hosted runners".

Introdução

Este tutorial demonstra como usar a ação andymckay/labeler junto com uma condicional para remover uma etiqueta dos problemas e pull requests que são adicionados a uma coluna específica em um quadro de um projeto. Por exemplo, você pode remover a etiqueta precisa de revisão quando os cartões do projeto forem transferidos para a coluna Concluído.

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. Escolha um projeto que pertence ao repositório. Este fluxo de trabalho não pode ser usado com projetos que pertencem a usuários ou organizações. Você pode usar um projeto existente ou criar um novo projeto. Para obter mais informações sobre como criar um projeto, consulte "Criar um quadro de projeto".

  3. 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".

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

    YAML
    name: Remove labels
    on:
      project_card:
        types:
          - moved
    jobs:
      remove_labels:
        if: github.event.project_card.column_id == '12345678'
        runs-on: ubuntu-latest
        steps:
          - name: remove labels
            uses: andymckay/labeler@master
            with:
              remove-labels: "needs review"
              repo-token: ${{ secrets.GITHUB_TOKEN }}
  5. Personalize os parâmetros no seu arquivo do fluxo de trabalho:

    • Em github.event.project_card. olumn_id == '12345678', substitua 12345678 pelo ID da coluna em que você deseja desetiquetar os problemas e os pull requests que são transferidos para lá.

      Para encontrar o ID da coluna, acesse o seu quadro de projetos. Ao lado do título da coluna, clique em e, em seguida, clique em Copiar link da coluna. O ID da coluna é o número no final do link copiado. Por exemplo, 24687531 é o ID da coluna para https://github.com/octocat/octo-repo/projects/1#column-24687531.

      Se você desejar atuar em mais de uma coluna, separe as condições com ||. Por exemplo, if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321' irá agir sempre que um cartão de projeto for adicionado à coluna 12345678 ou à coluna 87654321. As colunas podem estar em diferentes quadros de projetos.

    • Altere o valor para remove-labels para a lista de etiquetas que deseja remover dos problemas ou pull requests que são transferidos para a(s) coluna(s) especificada(s). Separe etiquetas múltiplas com vírgulas. Por exemplo, "help wanted, good first issue". Para obter mais informações sobre etiquetas, consulte "Gerenciar etiquetas".

  6. 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

Cada vez que um cartão de projeto em um projeto no seu repositório for transferido, este fluxo de trabalho será executado. Se o cartão for um problema ou uma pull request e for movido para a coluna especificada, o fluxo de trabalho removerá os rótulos especificados do problema ou de um pull request. Os cartões que são observações que não serão afetadas.

Teste o seu fluxo de trabalho transferindo um problema no seu projeto para a coluna de destino.

  1. Abra um problema no seu repositório. Para obter mais informações, consulte "Criar um problema".
  2. Etiquete o problema com as etiquetas que deseja que o fluxo de trabalho remova. Para obter mais informações, consulte "Gerenciar etiquetas".
  3. Adicione um problema na coluna do projeto que você especificou no arquivo do fluxo de trabalho. Para obter mais informações, consulte "Adicionar problemas e pull requests a um quadro de projeto".
  4. Para ver a execução do fluxo de trabalho que foi acionada adicionando o problema ao projeto, visualize o histórico da execução do seu fluxo de trabalho. Para obter mais informações, consulte "Visualizar histórico de execução de fluxo de trabalho".
  5. Quando o fluxo de trabalho é concluído, o problema que você adicionou na coluna do projeto deve ter as etiquetas especificadas removidos.

Próximas etapas

  • Para saber mais sobre coisas adicionais que você pode fazer com a ação andymckay/labeler, como adicionar etiquetas ou ignorar esta ação se o problema for atribuído ou tiver uma etiqueta específica, acesse o a documentação da ação andymckay/labeler.
  • Pesquise no GitHub exemplos de fluxos de trabalho que usam esta ação.

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.