actionsactions-runner-controller

0

6,320 stars1,430 forksGoApache-2.00 views

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.

Actions Runner Controller

Features

Star history