https://github.com/actions/actions-runner-controller

https://www.youtube.com/watch?v=_F5ocPrv6io

https://marshallku.com/dev/setup-github-actions-custom-runner-with-kubernetes

개념

actions-runner-controller (ARC) 란?

Github Actions를 위한 Self-hosted runner들을 확장하고 오케스트레이션 할 수 있는 k8s operator이다.

Legacy ACR vs 최신 ARC 비교

요약

• actions-runner-controller: Legacy chart. 2020년경, 커뮤니티 중심 개발된 Runner, RunnerDeployment, HorizontalRunnerAutoscaler 등의 CRD를 활용한 Runner 관리 방식, HorizontalRunnerAutoscaler를 통해 수동 설정 필요, GitHub App 또는 PAT 기반 인증
• gha-runner-scale-set-controller: 2023년, GitHub 공식 지원. gha-runner-scale-set 및 gha-runner-scale-set-controller 중심의 단순화된 CRD 사용. 대기 중인 작업 수에 따라 자동 스케일링 지원, GitHub App 기반 인증 권장, 보안 강화

1. 아키텍처 및 구성 요소

• ARC: 여러 개의 CRD(Runner, RunnerDeployment, HorizontalRunnerAutoscaler)를 사용하여 러너를 관리합니다. 이로 인해 유연한 설정이 가능하지만, 복잡도가 증가할 수 있습니다.Stack Overflow+1Stack Overflow+1
• GHA Runner Scale Set: gha-runner-scale-set과 gha-runner-scale-set-controller라는 두 가지 주요 구성 요소로 단순화되어 있습니다. Helm 차트를 통해 쉽게 배포할 수 있으며, 설정도 간단합니다.Reddit+5Chainguard Containers+5Medium+5

2. 오토스케일링 기능

• ARC: HorizontalRunnerAutoscaler를 사용하여 수동으로 최소 및 최대 러너 수를 설정해야 합니다.Stack Overflow
• GHA Runner Scale Set: 대기 중인 작업 수를 기반으로 자동으로 러너 수를 조절합니다. minRunners와 maxRunners를 설정하지 않으면, 작업이 없을 때는 0으로 줄이고, 작업이 있을 때는 자동으로 확장합니다.GitHub Docs

3. 보안 및 인증 방식

• ARC: GitHub App 또는 Personal Access Token(PAT)을 사용하여 인증합니다.Chainguard Containers+2GitHub Docs+2GitHub Docs+2
• GHA Runner Scale Set: GitHub App 기반 인증을 권장하며, Kubernetes Secret을 통해 민감한 정보를 안전하게 관리합니다.GitHub Docs+1Medium+1

4. 설치 및 배포 방법