# actions/actions-runner-controller

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/actions-actions-runner-controller).**

6,320 stars · 1,430 forks · Go · Apache-2.0

## Links

- GitHub: https://github.com/actions/actions-runner-controller
- awesome-repositories: https://awesome-repositories.com/repository/actions-actions-runner-controller.md

## Topics

`github-actions` `kubernetes` `operator`

## Description

Kubernetes controller for GitHub Actions self-hosted runners

## Tags

### Development Tools & Productivity

- [GitHub Actions Scale Set Managers](https://awesome-repositories.com/f/development-tools-productivity/package-installers/runner-managers/github-actions-scale-set-managers.md) — Deploys and manages groups of ephemeral container-based GitHub Actions runners that scale up or down quickly.
- [Ephemeral Job Runners](https://awesome-repositories.com/f/development-tools-productivity/job-scheduling-resources/containerized-batch-job-schedulers/ephemeral-job-runners.md) — Each runner runs as a short-lived Kubernetes pod that registers, executes one job, then terminates.

### DevOps & Infrastructure

- [Kubernetes Controllers](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-controllers.md) — Manages runner lifecycle by watching custom resources and reconciling desired state through a control loop.
- [Self-Hosted Runner Operators](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-automation-servers/self-hosted-runner-operators.md) — Coordinates self-hosted runners inside a Kubernetes cluster using a custom operator to manage their lifecycle. ([source](https://cdn.jsdelivr.net/gh/actions/actions-runner-controller@master/README.md))
- [Job-Queue-Based Autoscalers](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-automation-servers/self-hosted-runner-operators/job-queue-based-autoscalers.md) — Adjusts runner instance counts based on the volume of queued GitHub Actions workflow jobs.
- [Job-Queue-Based Scaling](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-automation-servers/self-hosted-runner-operators/job-queue-based-scaling.md) — Automatically adjusts runner instance counts based on the volume of queued workflow jobs.
- [Kubernetes-Based Operators](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-automation-servers/self-hosted-runner-operators/kubernetes-based-operators.md) — Orchestrates ephemeral runner pods and handles registration, scaling, and cleanup via a Kubernetes operator.
- [Runner Lifecycle Orchestration](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-pipelines/ephemeral-ci-environments/kubernetes-ci-cd-environments/runner-lifecycle-orchestration.md) — Manages GitHub Actions self-hosted runners inside a Kubernetes cluster with automatic scaling and lifecycle orchestration.
- [GitHub API-Driven Scaling](https://awesome-repositories.com/f/devops-infrastructure/cluster-node-management/capacity-scaling/api-driven-fleet-scaling/github-api-driven-scaling.md) — Scales runner capacity by polling GitHub workflow job queues and creating or deleting runner pods via API calls.
- [Container Deployment](https://awesome-repositories.com/f/devops-infrastructure/container-deployment.md) — Deploys and manages ephemeral runner scale sets using container instances for fast scaling.
- [Docker-in-Docker Runtimes](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-in-docker-runtimes.md) — Runs a Docker daemon sidecar container alongside the runner to support container-based workflow steps.
- [Queue-Based Autoscalers](https://awesome-repositories.com/f/devops-infrastructure/continuous-integration-systems/runner-image-managers/runner-provisioning/queue-based-autoscalers.md) — Adjusts the number of runner instances up or down based on the volume of queued workflow jobs. ([source](https://cdn.jsdelivr.net/gh/actions/actions-runner-controller@master/README.md))
- [Kubernetes Operators](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-operators.md) — Builds a custom Kubernetes operator to coordinate and manage the lifecycle of GitHub Actions runners.
- [Runner-Specific Configurations](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-in-docker-runtimes/runner-specific-configurations.md) — Configures Docker MTU and storage volumes for runners using Docker-in-Docker sidecar containers.
- [Finalizer-Based Resource Cleanup](https://awesome-repositories.com/f/devops-infrastructure/finalizer-based-resource-cleanup.md) — Attaches Kubernetes finalizers to runner resources to ensure proper teardown and prevent orphaned pods.

### Data & Databases

- [Runner Scale Sets](https://awesome-repositories.com/f/data-databases/horizontal-scaling/replica-scaling/container-instance-scaling/runner-scale-sets.md) — Deploys groups of ephemeral runner pods that scale horizontally using Kubernetes ReplicaSets.

### Operating Systems & Systems Programming

- [Runner](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/virtualization-platforms/virtualization-technologies/virtual-machines/scale-set-deployments/runner.md) — Creates and manages groups of ephemeral runners that scale up or down quickly using container-based instances. ([source](https://cdn.jsdelivr.net/gh/actions/actions-runner-controller@master/README.md))

### Software Engineering & Architecture

- [Runner Controllers](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/workflow-automation-integrations/ci-cd-integrations/github-actions/runner-controllers.md) — Manages self-hosted GitHub Actions runners as Kubernetes pods with automatic scaling and lifecycle management.

### Networking & Communication

- [Admission Webhooks](https://awesome-repositories.com/f/networking-communication/proxy-servers/proxy-enforcement/injection-enforcement/admission-webhooks.md) — Uses mutating and validating webhooks to inject runtime settings into runner pods.
