GitHub Actions ランナー イメージ

目次

• 約
• 利用可能な画像
• 画像の定義
• イメージリリース
• ソフトウェアとイメージのサポート
• レポを操作する方法
• よくある質問

約

このリポジトリには、アクションに使用されるGitHub でホストされるランナーの VM イメージの作成に使用されるソース コードと、Azure パイプラインで使用されるMicrosoft でホストされるエージェントの VM イメージを作成するために使用されるソース コードが含まれています。このリポジトリのソースから VM マシンを構築するには、手順を参照してください。

利用可能な画像

画像	YAML ラベル	付属ソフトウェア	最新のイメージ リリースのロールアウトの進行状況
Ubuntu 22.04	ubuntu-22.04	ubuntu-22.04
Ubuntu 20.04	ubuntu-latest また ubuntu-20.04	ubuntu-20.04
Ubuntu 18.04 の非推奨	ubuntu-18.04	ubuntu-18.04
macOS 12	macos-12	macOS-12
macOS 11	macos-latest また macos-11	macOS-11
macOS 10.15 の廃止	macos-10.15	macOS-10.15
Windows Server 2022	windows-latest また windows-2022	窓-2022
Windows サーバー 2019	windows-2019	窓-2019

ラベル スキーム

• 一般に、

  -latest

  ラベルは GA である最新の OS イメージ バージョンに使用されます。
• ラベルを新しい OS バージョンに移行する前に

  -latest

  、変更を発表し、ユーザーがワークフローを更新するのに十分なリード タイムを与えます。

画像の定義

ベータ

ベータ版の目的は、GA にリリースされる前にイメージに関するフィードバックを収集することです。ベータ版の目標は、そのイメージに存在する潜在的な問題を特定して修正することです。画像は毎週更新されます。ベータ イメージで実行されるワークフローは、アクションに適用される顧客のSLAには該当しません。ベータ イメージの使用を選択したお客様は、課題を作成して、runner-images リポジトリでフィードバックを提供することをお勧めします。ベータ版は、公開と非公開など、さまざまな可用性を持つ場合があります。

GA

GA (General Availability) イメージはベータ期間を経ており、一般的な使用の準備ができていると見なされます。画像は毎週更新されます。GA に移行するには、イメージが次の基準を満たしている必要があります。

1. ベータ期間を経ている (公開または非公開)
2. イメージにインストールするほとんどの主要なソフトウェアには、基盤となる OS と互換性のあるバージョンがあります。
3. ベータ期間中に報告された主要なバグはすべて対処されています。

このイメージ タイプは、アクションに関する顧客のSLAに該当します。GA イメージは、OS の最新の 2 つのバージョンのみをサポートするため、ガイドラインに従って最終的に非推奨になります。

イメージリリース

変化に追従する最善の方法

1. このリポジトリの最新リリースは、こちらで検索してください。

2. このリポジトリからリリースされるリリースを購読してください。手順はこちらです。

3. 今後の変更: イメージの展開が開始されると、プレリリースが作成されます。展開が完了するとすぐに、プレリリースはリリースに変換されます。リリースを購読している場合は、プレリリースの通知も受け取ります。

   • awaiting-deploymentラベルを使用して、今後の変更を追跡することもできます。

4. 影響の大きい変更については、事前にブログとtwitterの GitHub Changelog に投稿します。

   • 例: 互換性を破る変更、イメージの GA または非推奨

5. また、お知らせラベルを表示して、重要な今後の変更を確認することもできます。

ケイデンス

• 通常、ランナー イメージのソフトウェアに毎週更新を展開します。

ソフトウェアとイメージのサポート

サポートポリシー

• ツールとバージョンは通常、非推奨またはサポート終了から 6 か月後に削除されます

• 一度に (最大で) 2 つの GA イメージと 1 つのベータ イメージをサポートします。最新の OS イメージ ラベルが GA にリリースされたら、最も古いイメージ ラベルの廃止プロセスを開始します。

• イメージには通常、インストールされているパッケージの最新バージョンが含まれています。ただし、Canonical が提供するリポジトリにほとんど依存している Ubuntu LTS は除きます。

• 一般的なツールには、次の戦略に従って複数のバージョンを並べてインストールできます。

major.minor

major.minor

イメージの非推奨ポリシー

• 新しい GA OS バージョンがリリースされると、イメージは最も古いイメージ ラベルの非推奨プロセスを開始します。
• 非推奨プロセスは、非推奨の日付を設定するアナウンスから始まります
• 日付が近づくにつれて、GitHub はスケジュールされたイメージのブラウンアウトを開始します。
• この間、非推奨であることをユーザーに知らせるために、レポに固定されたアナウンスが表示されます。
• 最後に、GitHub はイメージを非推奨にし、使用できなくなります

インストール前のポリシー

一般に、イメージに何をプレインストールするかを決定する際に従うガイドラインは次のとおりです。

• 人気: 広く使用されているツールとエコシステムが優先されます。
• 最新のテクノロジー: 最新バージョンのツールが優先されます。
• 非推奨: サポート終了のツールとバージョンは追加されません。
• ライセンス: MIT、Apache、または GNU ライセンスが許可されます。
• 画像の時間と空間: ツールをプリインストールすることで、どれだけの時間が節約され、どれだけのスペースが使用されるかを評価します。
• サポート: ツールが複数のバージョンのサポートを必要とする場合、このメンテナンスのコストを考慮します。

デフォルトのバージョン更新ポリシー

• 通常、新しいバージョンがイメージにインストールされると、デプロイの 2 週間前にデフォルト バージョンの更新が発表されます。
• 潜在的に危険なアップデートについては、発表から展開までのタイムラインを最大 1 か月延長する場合があります。

レポを操作する方法

• 問題: バグ レポートを提出したり、ツールの追加/更新をリクエストしたりするに は、適切なテンプレートを使用して問題を開いてください。
• ディスカッション: イメージの構成、インストールされているソフトウェアについての考えを共有したり、新しいアイデアを持ち込んだりしたい場合は  、対応するカテゴリのディスカッションで新しいトピックを作成してください。新しいディスカッションを作成する前に、同様のトピックが以前に作成されていないことを確認してください。
• ランナー イメージの使用または Actions ワークフローの記述に関する一般的な質問については、GitHub Actions Community Forumでリクエストを開いてください。

よくある質問

ビルドで使用されているイメージのバージョンは?

通常、イメージのデプロイには 2 ～ 3 日かかり、

main

ブランチのドキュメントはデプロイが完了したときにのみ更新されます。特定のビルドで使用されているイメージ バージョンとソフトウェア バージョンを確認するには、

Set up job

(GitHub Actions) または

Initialize job

(Azure DevOps) ステップ ログを参照してください。