actions/actions-runner-controller

어떤 프로젝트인가요?

핵심 기능

• 01대기 중이거나 실행 중인 workflow 작업 수에 따라 runner scale set을 자동 확장합니다.
• 02Kubernetes에서 임시 컨테이너 기반 runner를 실행합니다.
• 03Helm chart로 설치합니다.
• 04저장소, 조직 또는 엔터프라이즈 수준에 등록된 runner를 지원합니다.

활용 사례

• GitHub 호스팅 runner 대신 자체 클러스터에서 CI 작업을 실행합니다.
• 사용량이 많은 시간에는 빌드 용량을 늘리고, 유휴 상태일 때는 줄입니다.
• 각 작업을 새 컨테이너에서 격리해 더 깔끔하게 빌드합니다.

빠른 시작

1. 1

   README에 링크된 Quickstart 가이드에 따라 Kubernetes 클러스터를 설정하고 Helm으로 ARC를 설치합니다

2. 2

   배포 문서의 설명에 따라 runner scale set을 만들고 이를 사용하는 workflow를 실행합니다

사용 전 알아둘 점

• !Kubernetes 클러스터가 필요하므로 Kubernetes를 사용하지 않는 환경에는 적합하지 않습니다.
• !레거시 자동 확장 모드는 GitHub가 아닌 커뮤니티에서만 유지 관리합니다.

포함된 컬렉션

토픽

자주 묻는 질문

actions-runner-controller은(는) 무엇인가요?

임시 컨테이너로 자체 호스팅 GitHub Actions runner를 실행하고 자동 확장하는 Kubernetes operator입니다. Actions Runner Controller(ARC)는 GitHub Actions용 자체 호스팅 runner를 실행하는 Kubernetes operator입니다. 저장소, 조직 또는 엔터프라이즈에서 실행 중인 workflow 수에 따라 runner scale set의 규모를 늘리거나 줄입니다.

actions-runner-controller은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

actions-runner-controller은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

actions-runner-controller은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. actions-runner-controller의 마지막 커밋은 2026년 11월 2일입니다.

actions-runner-controller은(는) 어디에 사용할 수 있나요?

GitHub 호스팅 runner 대신 자체 클러스터에서 CI 작업을 실행합니다. 사용량이 많은 시간에는 빌드 용량을 늘리고, 유휴 상태일 때는 줄입니다. 각 작업을 새 컨테이너에서 격리해 더 깔끔하게 빌드합니다.

actions-runner-controller는 어떻게 설치하나요?

README에 링크된 Quickstart 가이드에 따라 Kubernetes 클러스터를 설정하고 Helm으로 ARC를 설치합니다 배포 문서의 설명에 따라 runner scale set을 만들고 이를 사용하는 workflow를 실행합니다

actions-runner-controller은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/actions/actions-runner-controller