GitHub Actions Ubuntu 26.04移行：同一コミットでのランナー差異の確認から始める
ソースコードを変更していないにもかかわらず、CIの結果が変わってしまうことがあります。実行環境をubuntu-latestに委ねているワークフローであれば、OSイメージの移行もチームが管理すべき変更点に含める必要があります。
GitHubは2026年9月17日、Ubuntu 26.04ランナーの正式サポートおよびubuntu-latest移行計画を発表しました。この記事は、新しいイメージが無条件に高速であると紹介するものではなく、同一コミットを用いて環境の差異を切り離して検証する実務的な提案です。
公式発表で確認された範囲
発表によると、Ubuntu 26.04イメージはx64およびarm64で正式サポートされ、明示的なラベルはubuntu-26.04およびubuntu-26.04-armとなります。ubuntu-latestは、2026年10月19日から11月19日にかけて段階的にUbuntu 24.04から26.04へと移行する予定です。
新しいイメージには更新または削除されたツールが存在するため、プリインストールされたパッケージに依存しているビルドは影響を受ける可能性があります。準備が完了していない場合、ubuntu-24.04と明示的に指定する方法をGitHubが案内しています。なお、このスケジュールがすべてのリポジトリにおける実際の移行日を意味するわけではありません。
リポジトリが想定している環境を書き出す
まずはワークフローおよび再利用可能ワークフローにおけるruns-onを確認してください。コンテナを使用しているからといってホストの影響が完全に消えるとは想定せず、コンテナ外で実行されるインストール・圧縮・アップロードの各ステップまで確認することをお勧めします。
チェックリストにはコンパイラ、ランタイム、パッケージマネージャー、システムライブラリを分けて記載してみてください。ツール名だけをメモするのではなく、どこからインストールされ、どのステップがそれを呼び出しているのかを結びつけておくことで、失敗ログの原因を絞り込みやすくなります。
同一コミット、2つの環境、独立した成果物
移行の予行演習は、デプロイ権限を持たないテスト用パスから始める方が明確です。同一のコミットとロックファイルを既存イメージと新イメージの両方で実行し、ログ、テスト結果、成果物名を個別に保存してください。これは本記事で提案する検証手法です。
初期の比較では、古いキャッシュの影響を判別できるよう、キャッシュ条件を記録しておきましょう。ビルドの成否に加えて、インストールされたツールのバージョン、失敗したステップ、成果物の実行結果を残しておくことで、キャッシュヒットによって偶発的にパスした結果と区別できます。
緑色のチェックの後に残る検証
Webプロジェクトであれば生成されたファイルを実際に配信できるか、ネイティブ依存関係がある場合は目的の環境でロードできるかを確認できます。すべての成果物のバイト列が完全に一致しなければならないというルールにとらわれず、タイムスタンプなどの非決定的な差異と機能的な差異を分けて判定してください。
レビュアーは、新イメージの実行リンク、ツールバージョンの差異、代表的な機能の検査結果、差し戻し対象の変更点を1か所で確認できる状態にしておくべきです。ランナー移行にアプリケーションのリファクタリングまで混ぜてしまうと、失敗の原因やロールバックの範囲が不必要に広がってしまいます。
イメージ固定のメリットと残る制約
明示的なOSラベルの指定は大規模な移行をコントロールするのに役立ちますが、完全にイミュータブル（不変）なビルド環境を意味するわけではありません。実行に必要なツールを明示的にインストールし、実際のバージョンをログに残す習慣を併せて維持してください。
小規模なリポジトリであれば、大掛かりな検証体制を新たに構築する必要はありません。代表的なビルド1つと最も影響を受けやすい依存関係から比較を始め、一時的な固定を行った場合は解除の担当者と再検討する日付を併記しておく程度から着手できます。
公開ディスカッションとチームの意思決定を切り離す
runner-imagesの公開Issueは、イメージの変更点や問題の報告状況を確認するための窓口です。特定のコメントや他プロジェクトでの失敗が、直ちに自チームのリポジトリで再現することを意味するわけではなく、本記事もコミュニティの合意事項や障害の発生頻度を数値として主張するものではありません。
今すぐ取り組むべきことは、latestラベルが使われている箇所を特定し、同一コミットを新イメージでテストしてみることです。合格条件と保留条件をあらかじめ文書化しておけば、実際の移行期間中にビルド結果が変化しても、担当者は同一の根拠に基づいて判断を下すことができます。