Mover problemas atribuídos em projetos (clássicos)

Introdução

Este tutorial demonstra como usar a ação alex-page/github-project-automation-plus para mover automaticamente um problema para uma coluna específica em um projeto (clássico) quando o problema é atribuído. Por exemplo, quando um problema é atribuído, você pode movê-lo para a coluna In Progress do projeto (clássico).

No tutorial, primeiro, você criará um arquivo de fluxo de trabalho que usa a ação alex-page/github-project-automation-plus. 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, confira "Criar um repositório".

2. Em seu repositório, escolha um projeto (clássico). Você pode usar um projeto existente ou pode criar um novo projeto. Para saber mais sobre como criar um projeto, consulte "Criar um project (classic)".

3. No repositório, crie um arquivo chamado .github/workflows/YOUR_WORKFLOW.yml, substituindo YOUR_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".

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

   YAML

   # Esse fluxo de trabalho usa ações que não são certificadas pelo GitHub.
   # São fornecidas por terceiros e regidas por
   # termos de serviço, política de privacidade e suporte separados
   # online.
   
   # O GitHub recomenda fixar ações em um SHA de commit.
   # Para obter uma versão mais recente, você precisará atualizar o SHA.
   # Você também pode fazer referência a uma marca ou branch, mas a ação pode ser alterada sem aviso.
   
   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. Personalize os parâmetros no seu arquivo do fluxo de trabalho:

   • Altere o valor de project para o nome do seu projeto (clássico). Se você tiver vários projetos (clássicos) com o mesmo nome, a ação alex-page/github-project-automation-plus funcionará em todos os projetos com o nome especificado.
   • Altere o valor de column para o nome da coluna para a qual deseja mover os problemas quando eles forem atribuídos.
   • Altere o valor de repo-token:
     1. Crie um personal access token (classic) com o escopo repo. Para obter mais informações, confira "Gerenciar seus tokens de acesso pessoal".
     2. Armazene esse personal access token como um segredo no repositório. Para saber mais sobre como armazenar segredos, confira "Usar segredos em ações do GitHub".
     3. No arquivo de fluxo de trabalho, substitua PERSONAL_ACCESS_TOKEN pelo nome do segredo.

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, confira "Criar arquivos".

Testar o fluxo de trabalho

Sempre que um problema no seu repositório for atribuído, o problema será transferido para a coluna do projeto (clássico) especificado. Se o problema ainda não estiver no projeto (clássico), ele será adicionado ao projeto (clássico).

Se o repositório pertencer ao usuário, a ação alex-page/github-project-automation-plus funcionará em todos os projetos do seu repositório ou da conta pessoal que têm o nome e a coluna do projeto especificados. Da mesma forma, se o repositório pertencer a uma organização, a ação atuará sobre todos os projetos do seu repositório ou organização que têm o nome e a coluna especificados.

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

1. Abra um problema no seu repositório. Para obter mais informações, confira "Criar um problema".
2. Atribuir o problema. Para obter mais informações, confira "Atribuir problemas e pull requests a outros usuários do GitHub".
3. Para ver a execução do fluxo de trabalho que atribui o problema acionado, visualize o histórico da execução do fluxo de trabalho. Para obter mais informações, confira "Visualizar o histórico de execução do fluxo de trabalho".
4. Quando o fluxo de trabalho é concluído, o problema que você atribuiu deverá ser adicionado à coluna do projeto (clássico) especificado.

Próximas etapas

• Para descobrir outras coisas que você pode fazer com a ação alex-page/github-project-automation-plus, como excluir ou arquivar cartões de projeto, acesse a documentação da ação alex-page/github-project-automation-plus.