GitHub Actions, 자체 호스팅 러너 버전 강제 적용 재개

by DD
7시간 전
조회수 0

GitHub Actions 백엔드 재아키텍처링으로 안정성 및 가용성 향상을 추진하며 러너 버전 강제 적용 재개

최소 등록 버전 2.329.0 이상 요구 및 신규 릴리스 30일 내 업데이트 필수 조건 적용

GHEC 및 GHEC with Data Residency 대상, 각각 2026년 7월 31일 및 9월 25일부터 미준수 러너 작업 실행 중단

GitHub Actions 백엔드 재아키텍처링의 목표

이번 변경은 GitHub Actions 백엔드 서비스의 핵심 재아키텍처링(Core Rearchitecting)을 통해 신뢰성(Reliability), 가용성(Availability), 성능(Performance)을 근본적으로 개선하기 위함이다.

신규 아키텍처는 기존 대비 3배 이상의 일일 작업 처리량(Daily Job Volume)을 소화하며, 기업 고객의 분당 작업 시작률(Job Start Rate)을 7배 향상시킴

데이터 격리 아키텍처(Data Isolation Architecture)를 기반으로 구축되어, 대규모 워크로드에서도 안정적인 서비스 제공을 목표로 함

결과적으로, 안정적인 CI/CD 파이프라인 운영을 위한 기반을 강화하고 향후 기능 확장의 유연성을 확보함.

러너 버전 호환성 요구사항 분석

새로운 플랫폼과의 호환성을 위해 두 가지 주요 요구사항이 존재한다.

러너 등록 최소 버전 2.329.0 이상: 신규 아키텍처가 러너를 인식하고 연결을 허용하기 위한 필수 조건임.

신규 릴리스 30일 내 업데이트: 기존 요구사항이나 일부 경우에 일관되게 적용되지 않았으나, 이제는 지속적인 최신 상태 유지를 강제함.

주의: 등록 최소 버전은 단순히 연결을 위한 것이며, 실제 작업 실행을 위해서는 지속적인 업데이트가 필수적임. 2.329.0 버전에 고정될 경우 작업 실행이 중단될 수 있음.

자동 업데이트 활성화 시 별도 조치 없이 요구사항 충족 가능하나, 업데이트 서비스 도달이 전제됨.

단계적 강제 적용 및 브라운아웃(Brownout) 전략

버전 강제 적용은 점진적으로 진행되며, 이를 위해 단계적 브라운아웃(Phased Brownout)이 시행된다.

초기 단계: 지원되지 않는 러너 버전의 등록을 간헐적으로 차단하여 잠재적 문제 식별 유도.

확대 단계: 등록 차단과 더불어, 지원되지 않는 러너에서의 작업 실행도 간헐적으로 차단하여 실제 영향 파악.

목표: 사용자가 업데이트 필요성을 인지하고 사전에 조치를 취하도록 유도하여, 최종 강제 적용 시점의 서비스 중단(Service Disruption) 최소화.

GitHub Enterprise Cloud (GHEC): 2026년 9월 25일 완전 적용 예정.

업데이트 미준수 시 예상되는 영향

지정된 마감일까지 러너를 업데이트하지 않을 경우, 다음과 같은 영향이 발생한다.

신규 러너 등록 실패: 최소 등록 버전 미만 러너는 새로운 등록 시도 자체가 불가함.

기존 러너 작업 실행 중단: 등록은 되어 있더라도, 작업 실행 최소 버전을 충족하지 못하면 워크플로우 큐(Workflow Queue)에서 제외됨.

보안 업데이트 미적용 시 즉각 중단: 치명적인 보안 취약점 발견 시, 해당 업데이트가 적용될 때까지 즉시 작업 큐가 중단될 수 있음.

결론: CI/CD 워크플로우의 지속적인 운영을 위해 선제적인 러너 업데이트가 필수적임.

러너 버전 감사 및 관리 방안

조직 소유자는 감사 로그(Audit Log)를 통해 사용 중인 러너 버전 현황을 파악할 수 있다.

주요 감사 이벤트: `org.register_self_hosted_runner`, `repo.register_self_hosted_runner`, `enterprise.register_self_hosted_runner` 이벤트 조회 시 러너 버전 정보 포함.

주의사항: 감사 로그는 러너 등록 시점에 기록되므로, 현재 연결된 모든 러너의 완전한 목록을 제공하지는 않음.

대규모 환경: 대규모 러너 플릿(Fleet) 관리 시, UI보다는 감사 로그 REST API 활용이 효율적임.

권장 조치: 설치 스크립트, VM 이미지, 컨테이너 이미지 등 배포 자동화 스크립트 업데이트 및 캐시된 이미지 기반 러너 재생성이 필요함.

GitHub Actions: Minimum version enforcement timeline for self-hosted runners