GitHub Actions 러너 이미지 종류 및 사용 가이드
actions/runner-images
GitHub이 저장소는 GitHub Actions 및 Azure Pipelines에서 사용되는 호스팅 러너의 가상 머신(VM) 이미지 생성 소스를 제공하는 핵심 자료입니다.
- Ubuntu, macOS, Windows 등 주요 운영체제와 x64/Arm64 아키텍처를 지원하며 폭넓은 최신 이미지를 제공합니다.
- 안정적인 사용을 위해 GA(General Availability) 버전을 권장하며, 자동 업데이트되는 `-latest` 태그는 워크플로우 변경을 유발할 수 있습니다.
- 이미지는 주간 단위로 업데이트되므로, 워크플로우 작성 시에는 특정 OS 버전(예: `ubuntu-24.04`)을 명시하는 것이 가장 안전합니다.
이 저장소는 GitHub Actions와 Azure Pipelines에서 사용되는 호스팅 러너의 가상 머신(VM) 이미지를 생성하는 소스 코드를 담고 있습니다. 이 리포지토리를 통해 VM 환경을 구축할 수 있으며, 다양한 운영체제 및 아키텍처를 지원합니다.
주요 제공 이미지로는 Ubuntu (26.04, 24.04 등), macOS (15, 26 등), Windows Server(2025, 2022 등)가 있으며, 각각 x64 및 arm64 아키텍처를 지원합니다. 예를 들어, Ubuntu는 `ubuntu-26.04`와 `ubuntu-26.04-arm`과 같이 특정 버전별로 레이블이 지정되어 있습니다.
이미지 사용 시에는 `-latest` 레이블을 사용할 경우 최신 OS 버전으로 자동 마이그레이션될 수 있어 워크플로우에 예기치 않은 변경이 발생할 위험이 있습니다. 따라서 안정적인 작업을 위해서는 `macos-14`, `windows-2022`, `ubuntu-22.04`와 같이 특정 OS 버전을 명시하는 것이 권장됩니다.
이미지는 일반적으로 주간 단위로 업데이트되며, 베타 이미지를 거쳐 일반 사용 가능(GA: General Availability) 상태가 됩니다. GA 이미지로 지정되려면 베타 기간을 거치고 주요 소프트웨어의 호환성 및 보고된 버그 해결 등의 기준을 충족해야 합니다.