Skip to main content

Usando modelos de fluxo de trabalho

O GitHub fornece modelos de fluxo de trabalho iniciais para uma série de linguagens e ferramentas.

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, 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:

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. Para obter mais informações, confira "Usando modelos de fluxo de trabalho".

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 obter mais informações, 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.

    Captura de tela das guias do repositório "github/docs". A guia "Ações" está realçada com um contorno laranja.

  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 obter mais informações, confira "Como criar e testar".

  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 obter mais informações, confira "Usar segredos em ações do GitHub".

  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