Fundamentos do GitHub Actions
Automatize qualquer coisa com workflows: eventos disparam jobs em runners, e os jobs rodam steps que chamam comandos e actions reutilizáveis.
- Ler e escrever um arquivo de workflow: eventos, jobs, runners e steps
- Escolher gatilhos - push, pull_request, schedule, workflow_dispatch - e filtrar por branch e caminho
- Usar actions do marketplace com
uses, rodar comandos comrune ler expressões e logs
O Dungeon Dash tem um problema: as pessoas esquecem de rodar os testes, e código quebrado continua chegando na main. O GitHub Actions resolve isso rodando automações por você sempre que algo acontece no repositório.
Um workflow é um arquivo YAML em .github/workflows/. Ele tem:
on- os eventos que o disparam: um push, um pull request, um agendamento, um botão manual...jobs- um ou mais jobs. Cada um roda numa máquina virtual nova, um runner (ubuntu-latest,windows-latest,macos-latest).steps- os steps de cada job rodam em ordem: ou um comando de shell (run) ou uma action reutilizável (uses).
1name: Tests
2
3on:
4 push:
5 branches: [main]
6 pull_request:
7
8jobs:
9 test:
10 runs-on: ubuntu-latest
11 steps:
12 - uses: actions/checkout@v4 # get the repository's code
13 - uses: actions/setup-python@v5 # install Python
14 with:
15 python-version: "3.12"
16 - run: pip install -r requirements.txt
17 - run: pytest
18 - name: Say hello
19 run: echo "Tested ${{ github.repository }} at ${{ github.sha }}"Leia de cima para baixo: a cada push na main e a cada pull request, inicie uma máquina Ubuntu, faça checkout do código, configure o Python, instale as dependências e rode os testes. Se qualquer step terminar com erro, o job falha - e o pull request mostra um ✗ vermelho.
uses: owner/repo@versionroda uma action que alguém publicou (há milhares no GitHub Marketplace).actions/checkoutestá em quase todo workflow, porque o runner começa vazio.with:passa entradas para uma action.${{ ... }}é uma expressão, preenchida pelo GitHub antes de o step rodar. Contextos comogithub(o evento, o repositório, a ref, o ator...),env,secrets,matrixerunnerguardam os valores.
Escolhendo os gatilhos
| Evento | Dispara quando | Uso típico |
|---|---|---|
push | commits recebem push (filtre com branches, tags, paths) | CI na main, deploys |
pull_request | um PR é aberto, atualizado ou reaberto | CI nas mudanças propostas |
schedule | num cronograma cron (em UTC) | builds noturnos, limpeza de issues paradas |
workflow_dispatch | alguém clica em Run workflow (com entradas opcionais) | deploys e ferramentas manuais |
release | uma release é publicada | gerar e enviar pacotes |
issues, issue_comment | atividade em issues | bots de triagem |
Os filtros de branch e de caminho usam globs: * casa com qualquer coisa exceto /, e ** casa com qualquer coisa, incluindo / - então **/*.md casa com arquivos Markdown em qualquer pasta, incluindo o nível mais alto. Com paths-ignore, um push que só mexe em caminhos ignorados (como a documentação) pula o workflow.
1on:
2 push:
3 branches: [main, "release/**"]
4 paths-ignore: ["docs/**", "**/*.md"]
5 schedule:
6 - cron: "0 3 * * 1" # 03:00 UTC every Monday
7 workflow_dispatch:
8 inputs:
9 level:
10 description: "Which level to benchmark"
11 default: "1"Experimente
Até 15 XPO workflow vai rodar?
Usando os gatilhos filtrados acima, decida se cada evento inicia o workflow.
“Push na main mudando src/hero.py”
“Push em feature/co-op mudando src/net.py”
“Push em release/1.5 mudando src/save.py”
“Push na main mudando só docs/guide.md e README.md”
“Push na main mudando README.md e src/menu.py”
“Segunda-feira, 03:00 UTC”
“Alguém clica em Run workflow na aba Actions”
Toda execução aparece na aba Actions com um log para cada step - o primeiro lugar para olhar quando algo falha. Você pode rodar de novo os jobs que falharam e baixar logs e artefatos.
Os minutos do Actions são gratuitos para repositórios públicos; repositórios privados recebem uma cota mensal. Projetos que precisam de hardware especial podem registrar os seus próprios runners self-hosted.
Principais conclusões
Os workflows ficam em .github/workflows/*.yml: os eventos de
ondisparamjobs, que rodamstepsem runners.runexecuta comandos de shell;usesroda uma action publicada, configurada comwith.As expressões
${{ }}leem contextos como github, secrets e matrix.Filtre os gatilhos por branch e caminho com globs; os logs de cada step ficam na aba Actions.
Quiz da aula
7 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: automatize tarefas do GitHub com Python
O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.
Vai disparar?
Implemente uma verificação de gatilho simplificada. A entrada tem os filtros do workflow, --- e depois os eventos. As linhas de filtro têm a cara push: main release/** (um evento e os globs de branch dele) e paths-ignore: docs/** **/*.md. Cada linha de evento é EVENT BRANCH FILE....
Imprima push main: runs ou push main: skipped (reason), com o motivo event, branch ou paths: o evento precisa estar listado, a branch precisa casar com um dos globs dele (* casa com qualquer coisa exceto /, ** com qualquer coisa incluindo /, e **/ com zero ou mais pastas), e pelo menos um arquivo alterado não pode casar com um glob de paths-ignore.
- Gatilhos do Dungeon Dash
- Um asterisco só
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Faça o lint de um workflow
A entrada é um workflow em JSON (a mesma estrutura do YAML). Verifique-o e imprima cada problema numa linha própria, nesta ordem, ou no problems:
workflow: missing "on"se não houver chaveon- para cada job, em ordem:
JOB: missing runs-on;JOB: needs unknown job X; e, para cada step (numerado a partir de 1),JOB step N: has both uses and runouJOB step N: needs uses or run
- Vários problemas
- Limpo
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…