O Que É um Self-Hosted Runner no GitHub Actions?

Um self-hosted runner é sua própria máquina, registrada no GitHub, que executa jobs do Actions em vez de uma VM hospedada pelo GitHub.

Runners hospedados pelo GitHub são convenientes, mas limitados em hardware, software e acesso de rede. Self-hosted runners permitem trazer sua própria infraestrutura para ganhar controle, hardware especial ou acesso a rede privada.

O que é

Uma máquina, física ou virtual, executando o agente runner do GitHub Actions e registrada em um repositório, organização ou enterprise. Jobs a direcionam via a label self-hosted.

jobs:
  build:
    runs-on: [self-hosted, linux, x64]
    steps:
      - uses: actions/checkout@v4
      - run: make

Como funciona

Você instala e configura o agente runner com um token de registro. Ele consulta o GitHub por jobs correspondentes, executa-os e reporta de volta, em hardware e um SO que você controla.

Trade-offs

• Prós: hardware customizado, GPUs, rede privada, sem taxa por minuto.
• Contras: você mantém, escala, protege e faz patch das máquinas.
• Segurança: evite self-hosted runners em PRs de repositórios públicos.

Por que importa

Self-hosting pode cortar custos e desbloquear capacidades, mas o fardo operacional é real. Runners gerenciados como a Latchkey dão a você controle e economia no estilo self-hosted enquanto cuidam do provisionamento, escalonamento e autocorreção para você.

Conceitos relacionados

Self-hosted runners usam labels e runner groups para controlar o direcionamento e podem ser autoescalados com o Actions Runner Controller.

Principais conclusões

• Um self-hosted runner é sua própria máquina registrada.
• Direcione para ele com a label self-hosted.
• Você ganha controle, mas assume manutenção e segurança.

Guias relacionados