Ir para o conteúdo
Promovaweb

GitHub Actions: o que os workflows automatizam

O GitHub Actions é a plataforma de integração e entrega contínuas do GitHub, que executa workflows escritos em YAML dentro da pasta .github/workflows do repositório. O push, o pull request ou a tag declarados na chave on disparam os jobs do workflow numa máquina virtual nova, por isso o teste roda num ambiente limpo e o resultado aparece no próprio pull request.

Ficha e sumário da página

Referência técnica
GitHub CLI v2.104.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Workflows guardados no repositório
  2. As peças de um workflow
  3. Runners que começam limpos
  4. Credenciais dentro do workflow
  5. Acompanhar pelo terminal

Workflows guardados no repositório

O GitHub Actions é a plataforma de integração e entrega contínuas do GitHub. Ela automatiza o caminho do código até o build testado e o deploy. O mesmo mecanismo serve para tarefas do repositório que não envolvem código, como aplicar um rótulo quando uma issue é criada. Cada automação é descrita num workflow, o arquivo YAML que lista os jobs a executar, guardado na pasta .github/workflows/ do repositório.

Como o workflow é um arquivo do repositório, ele passa pelo mesmo histórico e pela mesma revisão do código. Uma mudança no processo de build chega por pull request. No histórico, o commit que alterou o workflow mostra qual passo entrou ou saiu. Uma release antiga continua apontando para o commit com o workflow que a construiu.

As peças de um workflow

Um workflow junta quatro conceitos. O evento é a atividade do repositório que dispara a execução, como um push ou a abertura de um pull request. O job é um conjunto de passos executados no mesmo runner. O step é cada passo do job, que roda um script ou chama uma action. A action é um conjunto reutilizável de código que faz uma tarefa comum, como baixar o repositório ou configurar o Node.js. O arquivo abaixo mostra as chaves que declaram cada peça:

.github/workflows/ci.yml

Gatilho e identificação

name:
O nome do workflow, exibido na aba Actions e nas checagens do pull request.
on:
Os eventos que disparam o workflow, como push, pull_request ou uma tag nova.
jobs:
Os jobs do workflow, que rodam em paralelo por padrão.
permissions:
O que o GITHUB_TOKEN do job pode fazer no repositório.

Execução de cada job

runs-on:
O runner do job, como ubuntu-latest, windows-latest ou macos-latest.
needs:
Os jobs que precisam terminar para este começar.
steps:
Os passos do job, executados em ordem no mesmo runner.
uses / run:
Cada passo chama uma action com uses ou roda um comando com run.
As chaves de um workflow do GitHub Actions, agrupadas pelo que cada uma declara: o gatilho e o nome no topo do arquivo, a execução dentro de cada job. Nenhum segredo aparece no arquivo: ele fica em secrets e o workflow só referencia o nome.

Os jobs de um workflow rodam em paralelo por padrão. Quando um job declara needs, ele espera o job de que depende terminar. É assim que um workflow de release monta a ordem: os testes rodam primeiro e o job que publica a versão só começa com os testes aprovados. Dentro de um job, os steps seguem em ordem e compartilham a mesma máquina, então um passo pode usar o arquivo que o passo anterior gerou.

Runners que começam limpos

O runner é a máquina que executa os jobs do workflow quando ele é disparado. O GitHub oferece runners hospedados com Ubuntu Linux, Windows e macOS. Segundo a documentação, cada execução de workflow nesses runners roda numa máquina virtual nova, provisionada só para ela. Você também pode registrar runners próprios, numa máquina sua, quando o build precisa de um hardware ou de uma rede que a máquina hospedada não tem.

A máquina limpa é o que torna o teste confiável. Um teste que passa no seu notebook pode se apoiar numa biblioteca instalada há meses ou num arquivo esquecido fora do Git. No runner hospedado, o job começa sem nada disso: ele baixa o repositório, instala as dependências declaradas e roda o teste. Se o teste passa ali, o projeto sobe a partir do que está versionado. O GitHub CLI já vem instalado nos runners hospedados, o que deixa um job chamar o gh sem passo de instalação.

Credenciais dentro do workflow

No início de cada job, o GitHub cria um GITHUB_TOKEN exclusivo para ele. O token só tem permissão no repositório que contém o workflow e expira quando o job termina, ou depois de seis horas nos runners hospedados. É com ele que um job cria uma release, comenta num pull request ou envia uma tag, sem guardar nenhuma senha no arquivo.

Os projetos da Promovaweb usam essa separação de um jeito específico. Os workflows podem validar, compilar, criar a tag e a GitHub Release e anexar os artefatos. A publicação no npm fica fora deles: desde 13 de novembro de 2026, os pacotes da Promovaweb saem para o npm só pela máquina local. Nenhum workflow guarda o NPM_TOKEN.

Acompanhar pelo terminal

O resultado de cada execução aparece na aba Actions e nas checagens do pull request. O GitHub CLI traz a mesma informação para o terminal. O gh run list lista as execuções recentes, o gh run watch acompanha a execução em andamento até o fim e o gh run view --log-failed mostra só os passos que falharam. O gh workflow run dispara um workflow configurado para execução manual.

Esses comandos encurtam a volta entre o push e a correção. Você envia o commit, acompanha a execução no mesmo terminal e lê o erro do passo que falhou sem trocar de janela. O próximo assunto é o que o workflow de release produz: a tag que marca a versão e a release que publica as notas e os arquivos, na página Releases e tags.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.