Usando modelos de fluxo de trabalho

Sobre os modelos de fluxo de trabalho

Os modelos de fluxo de trabalho são modelos que ajudam você a criar seus próprios fluxos de trabalho do GitHub Actions para um repositório. Eles oferecem uma alternativa para começar a partir de um arquivo de fluxo de trabalho em branco e são úteis porque parte do trabalho já terá sido feito para você.

O GitHub oferece modelos de fluxo de trabalho para uma série de linguagens e ferramentas. Ao configurar os fluxos de trabalho no repositório, o GitHub analisa o código no seu repositório e recomenda fluxos de trabalho baseados na linguagem e na estrutura do seu repositório. Por exemplo, se você usar o Node.js, o GitHub sugerirá um arquivo de modelo de fluxo de trabalho que instala os pacotes do Node.js e executa seus testes. É possível pesquisar e filtrar para encontrar modelos de fluxo de trabalho relevantes.

O GitHub fornece modelos de fluxo de trabalho prontos para uso para as seguintes categorias de alto nível:

• Implantação (CD) . Para saber mais, confira Continuous deployment.

• CI (integração contínua) . Para saber mais, confira Continuous integration.

• Automação. Os modelos de fluxo de trabalho de automação oferecem soluções para automatizar os fluxos de trabalho, como a triagem de solicitações de pull e a aplicação de um rótulo com base nos caminhos modificados na solicitação de pull ou a saudação de usuários que estão colaborando pela primeira vez no repositório.

Use esses fluxos de trabalho como ponto de partida para criar seu fluxo de trabalho personalizado ou usá-los no estado em que se encontram. É possível navegar pela lista completa de modelos de fluxo de trabalho no repositório actions/starter-workflows.

Você também pode criar seu próprio modelo de fluxo de trabalho para compartilhar com sua organização. Esses modelos de fluxo de trabalho aparecerão junto com os modelos de fluxo de trabalho fornecidos pelo GitHub. Qualquer pessoa com acesso para gravação ao repositório do .github da organização pode configurar um modelo de fluxo de trabalho. Para saber mais, confira Criar modelos de fluxo de trabalho para sua organização.

Escolhendo e usando um modelo de fluxo de trabalho

1. Em GitHub, acesse a página principal do repositório.

2. No nome do repositório, clique em Ações.

   

3. Se você já tiver um fluxo de trabalho no repositório, clique em Novo fluxo de trabalho.

4. A página "Escolher um fluxo de trabalho" mostra uma seleção de modelos de fluxo de trabalho recomendados. Localize o modelo de fluxo de trabalho que você deseja usar e clique em Configurar. Para ajudar a encontrar o modelo de fluxo de trabalho desejado, você pode pesquisar palavras-chave ou filtrar por categoria.

5. Se o modelo de fluxo de trabalho contiver comentários que detalham as etapas de instalação adicionais, siga-as.

   Há guias para acompanhar muitos dos modelos de fluxo de trabalho para criar e testar projetos. Para saber mais, confira Building and testing.

6. Alguns modelos de fluxo de trabalho usam segredos. Por exemplo, ${{ secrets.npm_token }}. Se o modelo de fluxo de trabalho usar um segredo, armazene o valor descrito no nome do segredo como um segredo no repositório. Para saber mais, confira Using secrets in GitHub Actions.

7. Opcionalmente, faça as alterações adicionais. Por exemplo, o ideal é alterar o valor de on para alterar o período em que o fluxo de trabalho será executado.

8. Clique em Iniciar commit.

9. Escreva uma mensagem de commit e decida se você deseja de fazer o commit diretamente para o branch padrão ou abrir um pull request.

Leitura adicional

• Continuous integration
• Gerenciando execuções e implantações de fluxo de trabalho
• Monitoramento e solução de problemas