검색
← 릴리스 노트

셀프 호스티드 러너 버전 강제 적용 일정

깃허브 · 동작변경 · 2026.06.12

셀프 호스티드 러너의 최소 버전 강제가 재개되며, 등록과 작업 실행 기준 및 적용 일정이 안내됐다.

교안에 영향

예전에는 2.329.0 등록 기준만 안내한 글이 이제는 30일 내 업데이트와 brownout, full enforcement 일정까지 반영해야 한다.

요약

- 셀프 호스티드 러너는 새 플랫폼과의 호환을 위해 등록 시 2.329.0 이상이 필요하다. - workflow job 실행은 각 릴리스 공개 후 30일 이내에 새 runner release를 적용해야 유지된다. - GitHub Enterprise Cloud with Data Residency와 GitHub Enterprise Cloud에 대해 brownout과 full enforcement 일정이 공개됐다. - REST API와 audit log에서 runner version을 확인할 수 있도록 지원이 추가됐다. - 오래된 self-hosted runners는 등록, 재등록, 작업 실행에 실패할 수 있어 업그레이드가 필요하다.

바뀐 것

개선 14

  • self-hosted runners에 대한 version requirement 강제를 다시 적용한다.
  • runner를 configure하거나 (re)register하려면 version 2.329.0 이상이어야 한다.
  • workflow jobs를 계속 실행하려면 각 new runner release를 공개 후 30일 이내에 설치해야 한다.
  • auto-update가 켜진 runner는 update service에 접근할 수 있으면 30일 요구사항을 자동으로 충족한다.
  • auto-update가 꺼진 runner는 정기적으로 수동 업그레이드해야 하며, 2.329.0에 고정된 runner는 job을 받지 못한다.
  • major, minor, patch를 포함한 모든 software release를 update 대상으로 본다.
  • critical security update가 나오면 적용될 때까지 job queuing을 잠시 중단한다.
  • brownout 동안 unsupported runner version의 registration과 job execution을 단계적으로 차단한다.
  • GitHub Enterprise Cloud with Data Residency의 full enforcement는 2026-07-31에 시작된다.
  • GitHub Enterprise Cloud의 full enforcement는 2026-09-25에 시작된다.
  • brownout은 지정된 날짜의 11:00 AM부터 3:00 PM ET까지 진행된다.
  • Runtime job annotations를 제공해 오래된 runner에서 실행된 작업을 식별할 수 있게 한다.
  • REST API에 runner version을 추가해 unsupported runner version 식별을 돕는다.
  • audit log의 org.register_self_hosted_runner, repo.register_self_hosted_runner, enterprise.register_self_hosted_runner 이벤트로 runner version을 확인할 수 있다.

기타 1

  • GitHub Enterprise Server는 이번 변경의 영향을 받지 않는다.

원문 제목 · GitHub Actions: Minimum version enforcement timeline for self-hosted runners