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 GitHub Docs tem links desfeitos. Quando são encontrados links desfeitos, o fluxo de trabalho usa a CLI do GitHub para criar um problema do GitHub com os detalhes.
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 |
---|---|
Executar um fluxo de trabalho em intervalos regulares: | schedule |
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-all-english-links.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. |
|
Define
|
|
Modifica as permissões padrão concedidas a |
|
Agrupa todos os trabalhos executados no arquivo de fluxo de trabalho. |
|
Define um trabalho com a ID |
|
O trabalho |
|
Configura o trabalho a ser executado em um executor do Ubuntu Linux. Isto significa que o trabalho será executado em uma nova máquina virtual hospedada pelo GitHub. Para obter exemplos de sintaxe usando outros executores, confira "Sintaxe de fluxo de trabalho para o GitHub Actions". |
|
Cria variáveis de ambiente personalizadas e redefine a variável interna |
|
Agrupa todas as etapas que serão executadas durante o trabalho |
|
A palavra-chave |
|
Essa etapa usa a ação |
|
A palavra-chave |
|
Esse comando |
|
Se o script |
|
Usa a ação |
|
Usa Depois, |
|
Se um problema de uma execução anterior estiver aberto e atribuído a alguém, use |
|
Se um problema de uma execução anterior estiver aberto e não estiver atribuído a ninguém:
|
Próximas etapas
- Para aprender sobre o GitHub Actions, confira "Entendendo o GitHub Actions".
- Para obter um guia passo a passo de criação de um fluxo de trabalho básico, confira "Início rápido para 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".