Skip to content
Latchkey

O Que É um Runner Group? Organizando e Protegendo Runners

Um runner group é um balde nomeado de runners com políticas de acesso que controlam quais repositórios e workflows têm permissão para usá-los.

Quando uma organização tem muitos runners, você precisa controlar quem pode usar o quê. Runner groups são a camada de controle de acesso: eles permitem reservar um conjunto de runners para repos específicos e manter runners sensíveis fora do alcance dos demais.

O que um group faz

Um runner group agrupa um conjunto de self-hosted runners e anexa uma política: quais repositórios (e opcionalmente quais workflows) na organização têm permissão para enviar jobs a esses runners. Runners que não estão em nenhum group customizado ficam no group padrão.

Por que groups importam

  • Isolamento: mantenha runners de rede de produção longe de repos não confiáveis.
  • Controle de custo: reserve runners caros de GPU ou grandes para os times que precisam deles.
  • Compliance: restrinja cargas reguladas a hardware aprovado.

Groups vs labels

Labels decidem qual runner um job combina; groups decidem quais runners um repo tem permissão de alcançar em primeiro lugar. Eles trabalham juntos - um repo precisa ter acesso a um group e o job precisa combinar com uma label dentro dele.

Armadilha comum

Um repo que não tem acesso ao group que detém seus runners-alvo verá jobs travados na fila, mesmo que runners compatíveis existam. A política de acesso, não apenas as labels, pode ser a causa de um job travado.

Groups em frotas gerenciadas

Com uma plataforma gerenciada, o provedor cuida da capacidade subjacente enquanto você ainda controla quais repos podem usá-la. Você tem fronteiras de acesso no estilo de group sem operar os runners que ficam dentro delas.

Principais conclusões

  • Um runner group é um conjunto nomeado de runners com políticas de acesso por repo.
  • Ele controla quais repositórios podem usar quais runners.
  • Groups tratam acesso; labels tratam correspondência - eles se combinam.
  • Falta de acesso ao group pode enfileirar jobs mesmo quando runners compatíveis existem.

Guias relacionados