Skip to content
Latchkey

O Que É um Runner do GitHub Actions?

Um runner é o servidor que de fato roda os steps do seu job. A aplicação runner consulta o GitHub por trabalho e o executa.

Workflows descrevem o trabalho, mas algo precisa realizá-lo. Esse algo é um runner: uma máquina virtual ou container com o agente runner do GitHub Actions instalado, pronto para pegar jobs.

O que é

Um runner é uma máquina rodando o software runner do Actions. Quando um job é enfileirado, um runner disponível que corresponde às labels do job o pega, roda cada step e transmite os logs de volta ao GitHub.

Selecting a runner
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Running on ${{ runner.os }}"

Como funciona

O campo runs-on: seleciona qual tipo de runner executa o job. Runners hospedados pelo GitHub são criados novos a cada job; runners self-hosted são máquinas que você mantém e registra no seu repositório ou organização.

Três tipos

  • Hospedado pelo GitHub: VMs gerenciadas cobradas por minuto.
  • Self-hosted: seu próprio hardware ou instâncias em nuvem.
  • Gerenciado: um terceiro opera a frota para você.

Por que isso importa

A escolha do runner determina custo, velocidade e controle. A Latchkey oferece runners gerenciados que executam exatamente os mesmos workflows que os runners hospedados pelo GitHub, mas mais baratos e com autocorreção, de modo que uma instância que falha é substituída automaticamente.

Conceitos relacionados

Runners são escolhidos com runs-on: e labels, e frotas self-hosted podem ser organizadas em runner groups.

Principais conclusões

  • Um runner é a máquina que executa um job.
  • runs-on: seleciona o runner por label.
  • As opções são hospedado pelo GitHub, self-hosted ou gerenciado.

Guias relacionados