Um runner é uma máquina preparada para receber e executar um job de automação por meio de um aplicativo instalado nela. No GitHub Actions, o job é um conjunto de etapas definido num workflow. O runner prepara a execução dessas etapas e registra a saída dos comandos para você acompanhar o resultado.
Como o job chega ao runner
O campo runs-on do workflow seleciona o tipo de runner. A configuração pode indicar uma opção hospedada pelo GitHub ou usar rótulos e grupos para selecionar um runner próprio. O job aguarda um runner compatível disponível para executar as etapas.
Os comandos e as ações do job determinam o trabalho realizado. Obter o repositório e instalar as dependências são etapas que precisam estar previstas no workflow quando forem necessárias. A seleção de uma máquina com Linux, por exemplo, não descreve por si só como preparar o projeto para seus testes.
Diferença de versão num teste automatizado
Como exemplo didático, um projeto usa o Node.js 22 no computador local, mas executa os testes num runner com outra versão disponível. Um teste que depende de um comportamento da versão 22 pode falhar numa versão anterior. Uma etapa de preparação que selecione a versão requerida permite testar o projeto sob uma condição explícita.
Você pode abrir a seção Set up job do log de um runner hospedado e consultar Runner Image. O link Included Software identifica as ferramentas incluídas na imagem usada naquela execução. O comando node --version durante o job informa a versão efetivamente usada. No exemplo, uma saída iniciada por v20. mostraria o uso do Node.js 20 e indicaria a necessidade de preparar a versão 22 para o teste.
Hospedagem e manutenção
Nos runners hospedados, o GitHub mantém a máquina e suas imagens. Nos runners próprios, você administra o sistema e o software que o projeto exige. Um runner próprio pode conservar arquivos entre execuções, portanto a limpeza do diretório de trabalho e o acesso a credenciais exigem configuração compatível com o uso.
O resultado de um job descreve os comandos executados naquele ambiente. Um teste aprovado no runner não comprova o funcionamento de uma aplicação em produção sob condições diferentes de rede ou de configuração.
Dúvidas frequentes
Perguntas frequentes sobre runner
- Qual é a diferença entre runner e job?
- O job reúne as etapas do trabalho, como preparar dependências e executar testes. O runner executa essas etapas no ambiente selecionado pelo workflow e registra sua saída.
- Todo runner hospedado começa numa máquina virtual nova?
- No GitHub Actions, os runners hospedados usam uma nova máquina virtual por job, com a exceção documentada dos runners com uma CPU. Essa modalidade executa o job num container sobre uma máquina virtual compartilhada.
- Usar um runner próprio transfere a manutenção ao GitHub?
- Num runner próprio, você administra a máquina, o sistema operacional e as ferramentas usadas pelo projeto. A atualização automática do aplicativo do runner não substitui a manutenção desse ambiente.
Para continuar
Recursos relacionados
Documentação
GitHub: runners hospedados
A documentação explica os ambientes hospedados e mostra como consultar a imagem e as ferramentas usadas por uma execução.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática para revisar um workflow e investigar diferenças entre os testes locais e os executados no runner.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Conferir o runner ajuda você a entender por que um teste automatizado usa ferramentas ou permissões diferentes das disponíveis no computador local.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.