Carregando
0x70Lição 8 de 14

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.

30 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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 com run e 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).
.github/workflows/tests.yml
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@version roda uma action que alguém publicou (há milhares no GitHub Marketplace). actions/checkout está 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 como github (o evento, o repositório, a ref, o ator...), env, secrets, matrix e runner guardam os valores.

Escolhendo os gatilhos

EventoDispara quandoUso típico
pushcommits recebem push (filtre com branches, tags, paths)CI na main, deploys
pull_requestum PR é aberto, atualizado ou reabertoCI nas mudanças propostas
schedulenum cronograma cron (em UTC)builds noturnos, limpeza de issues paradas
workflow_dispatchalguém clica em Run workflow (com entradas opcionais)deploys e ferramentas manuais
releaseuma release é publicadagerar e enviar pacotes
issues, issue_commentatividade em issuesbots 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.

filtered triggers
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 XP

O workflow vai rodar?

Usando os gatilhos filtrados acima, decida se cada evento inicia o workflow.

0 de 7 classificadosPontuação 0/0
  • “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 on disparam jobs, que rodam steps em runners.

  • run executa comandos de shell; uses roda uma action publicada, configurada com with.

  • 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.

Exercício 1

Vai disparar?

+25 XP

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ó
main.py
Carregando editor…

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.

Exercício 2

Faça o lint de um workflow

+25 XP

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 chave on
  • 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 run ou JOB step N: needs uses or run
  • Vários problemas
  • Limpo
main.py
Carregando editor…

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…