Repolode
Enviar
actions

actions/actions-runner-controller

Operador Kubernetes que executa e escala automaticamente runners self-hosted do GitHub Actions em contêineres efêmeros.

Ver no GitHub
Estrelas
6,632
Forks
1,506
Issues abertas
393
Último commit
há 4 dias

O que é?

Actions Runner Controller (ARC) é um operador Kubernetes para executar runners self-hosted do GitHub Actions. Ele cria runner scale sets que aumentam ou diminuem de tamanho conforme o número de workflows em execução em um repositório, organização ou empresa.

Os runners costumam ser efêmeros e baseados em contêineres, permitindo iniciar e remover novas instâncias rapidamente, sem deixar estado entre os jobs. O ARC é instalado com Helm e configurado no cluster Kubernetes que hospedará os runners.

O projeto é desenvolvido em colaboração com a equipe do GitHub Actions. Os runner scale sets mais recentes com escalabilidade automática têm suporte do GitHub, enquanto os modos de escalabilidade automática mais antigos são mantidos pela comunidade.

Recursos principais

  • 01Escala automaticamente os runner scale sets com base nos jobs de workflow na fila e em execução.
  • 02Executa runners efêmeros e baseados em contêineres no Kubernetes.
  • 03Instala por meio de um chart do Helm.
  • 04Oferece suporte a runners registrados no nível de repositório, organização ou empresa.

Casos de uso

  • Executar jobs de CI no seu próprio cluster, em vez de usar runners hospedados pelo GitHub.
  • Aumentar a capacidade de build nos horários de pico e reduzi-la quando estiver ociosa.
  • Isolar cada job em um contêiner novo para obter builds mais limpos.

Início rápido

  1. 1

    Configure um cluster Kubernetes e instale o ARC com Helm seguindo o guia Quickstart vinculado no README

  2. 2

    Crie um runner scale set e execute um workflow que o utilize, conforme descrito na documentação de implantação

Antes de usar

  • É necessário ter um cluster Kubernetes, portanto, não é adequado para configurações sem Kubernetes.
  • Os modos legados de escalabilidade automática são mantidos apenas pela comunidade, não pelo GitHub.

Em coleções

Frameworks de teste e ferramentas de automação de testes

Tópicos

#github-actions#kubernetes#ci-cd#self-hosted-runner#autoscaling#helm#operator

Perguntas frequentes

O que é actions-runner-controller?
Operador Kubernetes que executa e escala automaticamente runners self-hosted do GitHub Actions em contêineres efêmeros. Actions Runner Controller (ARC) é um operador Kubernetes para executar runners self-hosted do GitHub Actions. Ele cria runner scale sets que aumentam ou diminuem de tamanho conforme o número de workflows em execução em um repositório, organização ou empresa.
actions-runner-controller é gratuito? Qual é a licença?
actions-runner-controller é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
actions-runner-controller ainda é mantido?
Manutenção ativa. O último commit de actions-runner-controller foi em 2 de nov. de 2026.
Para que posso usar actions-runner-controller?
Executar jobs de CI no seu próprio cluster, em vez de usar runners hospedados pelo GitHub. Aumentar a capacidade de build nos horários de pico e reduzi-la quando estiver ociosa. Isolar cada job em um contêiner novo para obter builds mais limpos.
Como instalar actions-runner-controller?
Configure um cluster Kubernetes e instale o ARC com Helm seguindo o guia Quickstart vinculado no README Crie um runner scale set e execute um workflow que o utilize, conforme descrito na documentação de implantação
Onde consigo actions-runner-controller?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/actions/actions-runner-controller

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados