Digite para filtrar os verbetes do Glossário.

    Git e qualidade · Vibe Coding: Do Zero ao MVP

    O que é runner?

    Um runner fornece a máquina e o software que executam jobs de automação. No GitHub Actions, o workflow seleciona o ambiente e define as etapas do trabalho.

    Também chamado de: runner de CI, runner hospedado, GitHub Actions runner

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano