Visão geral de exemplo
Este artigo usa um fluxo de trabalho de exemplo para demonstrar alguns dos principais recursos de CI do GitHub Actions. Quando esse fluxo de trabalho é disparado, ele executa automaticamente um script que verifica se o site Docs do GitHub tem links desfeitos.
O diagrama a seguir mostra uma visão de alto nível das etapas do fluxo de trabalho e como elas são executadas no trabalho:
Recursos usados neste exemplo
O fluxo de trabalho de exemplo demonstra os seguintes recursos do GitHub Actions:
Recurso | Implementação |
---|---|
Como disparar um fluxo de trabalho a ser executado automaticamente: | push |
Fluxo de trabalho de exemplo
O fluxo de trabalho a seguir foi criado pela equipe de engenharia de Docs do GitHub. Para revisar a versão mais recente deste arquivo no repositório github/docs
, confira check-broken-links-github-github.yml
.
Observação: cada linha desse fluxo de trabalho é explicada na próxima seção em "Noções básicas sobre o exemplo".
|
Compreendendo o exemplo
A tabela a seguir explica como cada um desses recursos é usado ao criar um fluxo de trabalho GitHub Actions.
Código | Explicação |
---|---|
|
O nome do fluxo de trabalho, como aparece na guia "Ações" do repositório do GitHub. |
|
A palavra-chave |
|
Adicione o evento |
|
Adicione o evento |
|
Adicione o evento |
|
Modifica as permissões padrão concedidas a |
|
Cria um grupo de simultaneidade para eventos específicos e usa o operador |
|
Cancela todos os trabalhos ou fluxos de trabalho em execução no mesmo grupo de simultaneidade. |
|
Agrupa todos os trabalhos executados no arquivo de fluxo de trabalho. |
|
Define um trabalho com a ID |
|
Configura o trabalho a ser executado em um executor hospedado no GitHub ou um executor auto-hospedado, dependendo do repositório que executa o fluxo de trabalho. Neste exemplo, o trabalho será executado em um executor auto-hospedado se o repositório for chamado |
|
Agrupa todas as etapas que serão executadas durante o trabalho |
|
A palavra-chave |
|
Esta etapa usa a ação |
|
A palavra-chave |
|
Usa a ação |
|
Lista o conteúdo de |
|
Esta etapa usa o comando |
|
Esta etapa usa o comando |
Próximas etapas
- Para aprender os conceitos do GitHub Actions, confira "Noções básicas sobre o GitHub Actions".
- Para obter um guia passo a passo de criação de um fluxo de trabalho básico, confira "Guia de início rápido do GitHub Actions".
- Se você já entende os conceitos básicos do GitHub Actions, saiba mais sobre os fluxos de trabalho e seus recursos em "Sobre fluxos de trabalho".