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 ブート、Trusted Launch、より大きな VM サイズなどの機能に必要です）。
トラブル対応How to fix Maven build or Maven Central deployment failures after Ubuntu runners upgraded from Maven 3.9.16 to 3.10.0?
Maven 3.10.0 introduces stricter POM validation, so builds that worked with Maven 3.9.16 can fail or produce deployment errors such as "Bundle has content that does NOT have a .pom file." As a workaround, pin Maven 3.9.16 in CI instead of using the Maven version preinstalled on ubuntu-24.04. For Azure DevOps, add this before the Maven build:
- 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"
Verify with mvn -version, then run the deployment. On GitHub Actions, replace the Azure DevOps prepend command with:
echo "$HOME/tools/apache-maven-3.9.16/bin" >> "$GITHUB_PATH"
The permanent fix is to update the POM so it is compatible with Maven 3.10.0 validation, or keep Maven pinned to 3.9.16 until that is done.
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
リポジトリの README にある Available Images テーブルを開き、OS と CPU アーキテクチャごとに対象のイメージを探す
workflow の runs-on フィールドに対応する YAML ラベルを入力する。例: ubuntu-latest または windows-2022
テーブル内の Included Software リンクをクリックし、イメージ内に必要な言語とツールのバージョンがすでに含まれているかどうかを確認する
- リポジトリの README にある Available Images テーブルを開き、OS と 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