actions/actions-runner-controller
Actions Runner Controller
Kubernetes controller for GitHub Actions self-hosted runners
Features
- GitHub Actions Scale Set Managers - Deploys and manages groups of ephemeral container-based GitHub Actions runners that scale up or down quickly.
- Kubernetes Controllers - Manages runner lifecycle by watching custom resources and reconciling desired state through a control loop.
- Runner Scale Sets - Deploys groups of ephemeral runner pods that scale horizontally using Kubernetes ReplicaSets.
- Ephemeral Job Runners - Each runner runs as a short-lived Kubernetes pod that registers, executes one job, then terminates.
- Self-Hosted Runner Operators - Coordinates self-hosted runners inside a Kubernetes cluster using a custom operator to manage their lifecycle.
- Job-Queue-Based Autoscalers - Adjusts runner instance counts based on the volume of queued GitHub Actions workflow jobs.
- Job-Queue-Based Scaling - Automatically adjusts runner instance counts based on the volume of queued workflow jobs.
- Kubernetes-Based Operators - Orchestrates ephemeral runner pods and handles registration, scaling, and cleanup via a Kubernetes operator.
- Runner Lifecycle Orchestration - Manages GitHub Actions self-hosted runners inside a Kubernetes cluster with automatic scaling and lifecycle orchestration.
- GitHub API-Driven Scaling - Scales runner capacity by polling GitHub workflow job queues and creating or deleting runner pods via API calls.
- Container Deployment - Deploys and manages ephemeral runner scale sets using container instances for fast scaling.
- Docker-in-Docker Runtimes - Runs a Docker daemon sidecar container alongside the runner to support container-based workflow steps.
- Queue-Based Autoscalers - Adjusts the number of runner instances up or down based on the volume of queued workflow jobs.
- Kubernetes Operators - Builds a custom Kubernetes operator to coordinate and manage the lifecycle of GitHub Actions runners.
- Runner - Creates and manages groups of ephemeral runners that scale up or down quickly using container-based instances.
- Runner Controllers - Manages self-hosted GitHub Actions runners as Kubernetes pods with automatic scaling and lifecycle management.
- Runner-Specific Configurations - Configures Docker MTU and storage volumes for runners using Docker-in-Docker sidecar containers.
- Finalizer-Based Resource Cleanup - Attaches Kubernetes finalizers to runner resources to ensure proper teardown and prevent orphaned pods.
- Admission Webhooks - Uses mutating and validating webhooks to inject runtime settings into runner pods.
