Ejecuta GitHub Actions en tus propias máquinas Linux, Mac y Windows, con un contenedor, una VM o una cuenta nuevos para cada job.
actions/actions-runner-controller
Operador de Kubernetes que ejecuta y escala automáticamente runners autohospedados de GitHub Actions en contenedores efímeros.
- Estrellas
- 6,632
- Forks
- 1,504
- Issues abiertos
- 393
- Último commit
- hace 3 días
¿Qué es?
Actions Runner Controller (ARC) es un operador de Kubernetes para ejecutar runners autohospedados de GitHub Actions. Crea conjuntos de escalado de runners que crecen o se reducen según la cantidad de workflows que se ejecutan en un repositorio, una organización o una empresa.
Los runners suelen ser efímeros y estar basados en contenedores, por lo que se pueden iniciar y eliminar instancias rápidamente sin dejar datos entre jobs. ARC se instala con Helm y se configura a través del clúster de Kubernetes que alojará los runners.
El proyecto se desarrolla en colaboración con el equipo de GitHub Actions. GitHub ofrece soporte para los conjuntos de escalado de runners con el nuevo modo de escalado automático, mientras que la comunidad mantiene los modos anteriores.
Funciones clave
- 01Escala automáticamente los conjuntos de runners según los jobs de workflow en cola y en ejecución.
- 02Ejecuta runners efímeros basados en contenedores en Kubernetes.
- 03Se instala mediante un chart de Helm.
- 04Admite runners registrados en el nivel de repositorio, organización o empresa.
Casos de uso
- Ejecutar jobs de CI en tu propio clúster en lugar de usar runners alojados en GitHub.
- Aumentar la capacidad de compilación durante las horas de mayor demanda y reducirla cuando no se necesita.
- Aislar cada job en un contenedor nuevo para obtener compilaciones más limpias.
Inicio rápido
- 1
Configura un clúster de Kubernetes e instala ARC con Helm siguiendo la guía Quickstart enlazada en el README
- 2
Crea un runner scale set y ejecuta un workflow que lo utilice, como se describe en la documentación de despliegue
Antes de usarlo
- Requiere un clúster de Kubernetes, por lo que no es adecuado para configuraciones que no lo tengan.
- Los modos de autoescalado heredados reciben mantenimiento únicamente de la comunidad, no de GitHub.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es actions-runner-controller?
- Operador de Kubernetes que ejecuta y escala automáticamente runners autohospedados de GitHub Actions en contenedores efímeros. Actions Runner Controller (ARC) es un operador de Kubernetes para ejecutar runners autohospedados de GitHub Actions. Crea conjuntos de escalado de runners que crecen o se reducen según la cantidad de workflows que se ejecutan en un repositorio, una organización o una empresa.
- ¿actions-runner-controller es gratuito? ¿Qué licencia tiene?
- actions-runner-controller es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿actions-runner-controller sigue mantenido?
- Mantenimiento activo. El último commit de actions-runner-controller fue el 2 nov 2026.
- ¿Para qué puedo usar actions-runner-controller?
- Ejecutar jobs de CI en tu propio clúster en lugar de usar runners alojados en GitHub. Aumentar la capacidad de compilación durante las horas de mayor demanda y reducirla cuando no se necesita. Aislar cada job en un contenedor nuevo para obtener compilaciones más limpias.
- ¿Cómo se instala actions-runner-controller?
- Configura un clúster de Kubernetes e instala ARC con Helm siguiendo la guía Quickstart enlazada en el README Crea un runner scale set y ejecuta un workflow que lo utilice, como se describe en la documentación de despliegue
- ¿Dónde consigo actions-runner-controller?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/actions/actions-runner-controller
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Suite de operadores de Kubernetes que automatiza el despliegue de servicios de inferencia de LLM, ajuste fino y RAG en nodos con GPU.
Componentes de Kubernetes que escalan automáticamente los nodos del clúster y ajustan las solicitudes de CPU y memoria de los pods.
Herramienta declarativa de entrega continua GitOps que sincroniza aplicaciones de Kubernetes con el estado definido en repositorios Git.
Un SDK de Go para crear Kubernetes Operators, con APIs de alto nivel, scaffolding y generación de código sobre controller-runtime.
Conjunto de bibliotecas Go para crear controladores y operadores de Kubernetes, usado como base de Kubebuilder y Operator SDK.