runner-images
SHA-256GitHub 공식 호스티드 러너 이미지의 빌드 소스 코드로, Ubuntu, Windows, macOS 등의 환경을 포함하며 패치와 툴체인이 매주 업데이트됩니다.
GitHub 공식 CI 가상 머신 이미지의 레시피 저장소.
주요 기능
- Ubuntu, Windows Server, Windows 11 Arm64, macOS 및 Xcode 미리보기 이미지를 지원
- x64 및 arm64 두 가지 아키텍처 버전을 동시에 제공
- 수십 가지 언어 런타임, SDK, CLI 도구가 사전 설치되어 있어 즉시 사용 가능
- 보안 패치 및 소프트웨어 버전을 매주 업데이트하므로 직접 유지 관리할 필요 없음
- GA/Beta 승격 규칙을 공개하고 업그레이드 전에 사전 공지
할 수 없는 것
- •이미지에 사전 설치된 소프트웨어는 공식 측에서 일괄적으로 결정하므로 임의로 추가하거나 삭제할 수 없습니다. 임시로 설치한 도구는 다음 작업에서 유지되지 않습니다. Beta 이미지는 Actions의 SLA 보장 범위에 포함되지 않으므로 정식 프로덕션 워크플로에 사용하지 않는 것이 좋습니다. macOS의 -large 및 -xlarge 접미사는 GitHub Actions 전용이며 유료 larger runner가 필요합니다. -latest가 새 시스템 버전을 가리키게 되면 기존에 이전 시스템에 의존하던 스크립트에서 오류가 발생할 수 있으므로, -latest에 장기적으로 의존하지 말고 미리 구체적인 버전 번호를 고정하세요. 또한 이 저장소는 일반 사용자에게 로컬 설치 패키지를 제공하지 않으며, 빌드 레시피일 뿐입니다.
사용 사례
- GitHub Actions 워크플로에 적합한 러너 이미지 태그 선택하기
- Azure Pipelines의 Microsoft 호스팅 에이전트용 빌드 환경 준비하기
- 로컬 또는 프라이빗 클라우드에서 공식 레시피에 따라 동일한 CI 가상 머신 복제하기
- CI 빌드 실패를 해결할 때 이미지에 사전 설치된 소프트웨어 버전 확인하기
상세 설명
runner-images는 GitHub이 공식적으로 오픈소스로 운영하는 가상 머신 이미지 빌드 저장소로, GitHub Actions 호스티드 러너와 Azure Pipelines의 Microsoft 호스티드 에이전트에 기반 시스템 환경을 제공합니다. Ubuntu 22.04/24.04/26.04(x64 및 arm64), Ubuntu Slim, Windows Server 2022/2025, Windows 11 Arm64, macOS 14/15/26 및 Xcode 프리뷰 이미지를 지원하며, 수십 가지 언어 런타임, SDK, 명령줄 도구가 사전 설치되어 있고 보안 패치와 소프트웨어 버전이 매주 업데이트됩니다. CI 베이스 이미지를 직접 유지 관리하거나 커뮤니티 Docker 이미지를 사용하는 것과 비교하면, 이 프로젝트는 공식적으로 지속적으로 유지 관리되며 SLA가 보장되고, `-latest` 태그의 의미가 명확하며, 업그레이드 전에 사전 공지가 이루어지므로 팀이 패치 관리를 직접 담당할 필요가 없습니다. 저장소는 GA/Beta 이미지의 승격 기준도 공개하고 있으며, 사용자는 Issue를 통해 새로운 소프트웨어 추가를 요청하거나 문제를 보고할 수 있습니다.
문제 해결 & FAQ (2)
방법Windows Server 2025 및 Ubuntu 24.04용 Generation 2 VM의 올바른 Azure Marketplace SKU는 무엇인가요?
Azure에서 Generation 2 VM 이미지를 사용하려면 배포 또는 이미지 빌드 구성에서 SKU 참조를 업데이트하세요:
Windows Server 2025: SKU를 2025-Datacenter에서 2025-Datacenter-g2로 변경하세요. -g2 접미사는 Generation 2 이미지를 명시적으로 선택합니다.
Ubuntu 24.04 LTS: SKU를 server-gen1에서 server로 변경하세요. 기본 server SKU는 Ubuntu 24.04의 표준 기본값이며 이미 Generation 2입니다. -gen1 변형은 반드시 제거해야 합니다.
업데이트 후에는 이미지를 다시 배포하거나 다시 빌드하여 Gen2 지원을 적용하세요(UEFI boot, Trusted Launch, 더 큰 VM 크기와 같은 기능에 필요합니다).
문제 해결Ubuntu 러너가 Maven 3.9.16에서 3.10.0으로 업그레이드된 후 Maven 빌드 또는 Maven Central 배포 실패를 해결하는 방법?
Maven 3.10.0은 더 엄격한 POM 유효성 검사를 도입하므로, Maven 3.9.16에서 작동하던 빌드가 실패하거나 "Bundle has content that does NOT have a .pom file."와 같은 배포 오류를 발생시킬 수 있습니다. 임시 해결 방법으로 ubuntu-24.04에 사전 설치된 Maven 버전을 사용하는 대신 CI에서 Maven 3.9.16을 고정하세요. Azure DevOps에서는 Maven 빌드 전에 다음을 추가하세요:
- bash: |
set -euo pipefail
curl -fsSL https://archive.apache.org/dist/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz -o /tmp/maven.tar.gz
mkdir -p "$HOME/tools"
tar -xzf /tmp/maven.tar.gz -C "$HOME/tools"
echo "##vso[task.prependpath]$HOME/tools/apache-maven-3.9.16/bin"
mvn -version으로 확인한 다음, 배포를 실행하세요. GitHub Actions에서는 Azure DevOps prepend 명령을 다음으로 바꾸세요:
echo "$HOME/tools/apache-maven-3.9.16/bin" >> "$GITHUB_PATH"
영구적인 해결 방법은 POM이 Maven 3.10.0 유효성 검사와 호환되도록 POM을 업데이트하거나, 그 작업이 완료될 때까지 Maven을 3.9.16으로 고정해 두는 것입니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
저장소 README의 Available Images 표를 열고 운영 체제와 CPU 아키텍처에 따라 대상 이미지를 찾습니다
workflow의 runs-on 필드에 해당하는 YAML 레이블을 입력합니다(예: ubuntu-latest 또는 windows-2022)
표의 Included Software 링크를 클릭하여 이미지에 필요한 언어 및 도구 버전이 포함되어 있는지 확인합니다
- 저장소 README의 Available Images 표를 열고 운영 체제와 CPU 아키텍처에 따라 대상 이미지를 찾습니다
- workflow의 runs-on 필드에 해당하는 YAML 레이블을 입력합니다(예: ubuntu-latest 또는 windows-2022)
- 표의 Included Software 링크를 클릭하여 이미지에 필요한 언어 및 도구 버전이 포함되어 있는지 확인합니다
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
cb1cbd1ef895aacf72d92269c48b5df5445aab63444b56a95966b499df2f0cd4이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
이 리포지토리 자체는 이미지 레시피 소스 코드일 뿐이므로 로컬 머신에 설치할 필요가 없습니다. 특정 이미지 태그를 더 이상 사용하지 않는 경우 workflow 파일에서 runs-on을 다른 태그 또는 직접 구축한 self-hosted runner로 변경하기만 하면 됩니다. 레시피에 따라 직접 구축한 Azure 리소스를 삭제해야 하는 경우 지속적인 과금을 방지하기 위해 Azure 포털에서 해당 리소스 그룹과 가상 머신을 삭제하세요.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs
유사한 프로젝트
Visual Studio Code (Code - OSS)
Microsoft가 만든 무료 오픈 소스 코드 편집기로, 지능형 자동 완성, 디버깅, Git 및 확장 기능을 지원하는 전 세계에서 가장 인기 있는 편집기입니다.
opencode
오픈소스 AI 코딩 에이전트로, 코드 작성, 리팩토링 및 분석을 지원하며, '빌드(Build)'와 '플랜(Plan)' 이중 에이전트 모드가 내장되어 있습니다.
scrcpy
USB 또는 무선 TCP/IP를 통해 컴퓨터에서 Android 기기로 화면 미러링 및 제어를 지원하며, 루팅 불필요, 고성능 저지연, 오디오 전달 지원.