Web・開発

GitHub Actions が Node.js 20 をサポートしなくなりました:ワークフローを監査して修正する方法

GitHub Actions Dropped Node.js 20: How to Audit and Fix Your Workflows

GitHub Actions は JavaScript アクション用に Node.js 20 ランタイムを提供しなくなりました。アプリケーションが Node.js を使用していなくても、古い checkout、setup、またはサードパーティアクションが CI の問題になる可能性があります。以下では、ワークフローを監査し、カスタムアクションを更新し、セルフホストランナーの互換性を安全に確認する方法を紹介します。

GitHub Actions Node.js 20 の削除: ワークフローの監査と修正方法

GitHub Actions のワークフローは、構築するプロジェクトに JavaScript が含まれていない場合でも Node.js に依存する可能性があります。

この詳細は重要になってきました。

2026年9月23日、GitHub は Node.js 20 を GitHub Actions ランナーから削除しました。JavaScript アクションは現在 Node.js 24 で実行され、以前ユーザーが Node 20 の古いランタイムを維持できるようにしていた一時的な互換性スイッチは使用できなくなりました。

多くのリポジトリでは変更が必要ありません。GitHub の公式ファーストパーティアクションの最新バージョンはすでに Node 24 に移行しています。

ただし、古いワークフロー、独自の JavaScript アクション、および一部の自前ホスティングランナーは監査が必要です。

重要な違いは、GitHub が指す Node.js ランタイムが何か を理解することです。

アプリケーションランタイムとアクションランタイムは別々のものです

PHP プロジェクトで次のワークフローを考えてみましょう:

steps:
  - uses: actions/checkout@v4

  - name: Install dependencies
    run: composer install

  - name: Run tests
    run: vendor/bin/phpunit

アプリケーションは PHP ですが、actions/checkout 自体が JavaScript アクションです。GitHub は Actions ランナーにバンドルされた Node.js ランタイムを使用してその JavaScript を実行します。

このランタイムは、ワークフローでインストールした Node.js とは独立しています。同様に、actions/setup-node は後続のワークフロー命令で Node 22 をインストールできますが、アクション自体はメタデータに記載されたランタイムで実行されます。

この違いが、Node 20 の削除が PHP、Python、Go、Java などの Node 以外のプロジェクトにも影響を及ぼす理由を説明しています。

何が変わったのか?

GitHub は Node.js 20 の非推奨化を 2026 年 4 月の EOL を前に十分に事前に発表しました。2026 年 6 月から GitHub はデフォルトで Actions を Node 24 に切り替え始めました。移行期間中は、ユーザーは ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION を使用して古いランタイムに戻すことができました。これはあくまで移行時の一時的な逃げ道でした。

2026年9月23日、GitHub は Node 20 を GitHub Actions ランナーから削除し、その回避策も削除しました。保守しているアクションがまだ Node 20 を宣言している場合、GitHub の推奨は Node 24 に更新し、新しいリリースを公開することです。

初回監査: 各 uses: 行を確認

最もシンプルなワークフロー監査は .github/workflows から始まります。uses: を検索し、ファーストパーティとサードパーティのアクションを一覧化します。ワークフローがまだ実行できているからといって、それが最新版であると断定しないでください。

各アクションについて、ワークフローで参照されているバージョンが Node 24 をサポートする最新リリースかどうかを判断します。サードパーティ製アクションは特に注意が必要です。 major version を無謀に変更する前に、リリース履歴を確認してください。入力、デフォルト値、認証メカニズム、キャッシュ動作は Node の移行とは独立して変わる可能性があります。

カスタム JavaScript アクションは別の修正が必要です

独自の JavaScript アクションを保守している場合は、action.yml または action.yaml を確認してください。JavaScript アクションにはまだ次の要素が含まれている場合があります:

runs:
  using: node20
  main: dist/index.js

ランタイム宣言は Node 24 をターゲットにすべきです:

runs:
  using: node24
  main: dist/index.js

その行を変更するだけでは始まりにすぎません。Node 24 でアクションをテストし、必要に応じて依存関係を更新し、コミットされた dist/ バンドルを再構築してください。そうでなければ、ユーザーはソースが変更されていても古い生成された JavaScript を実行し続ける可能性があります。

安全な移行は、開発環境を更新し、依存関係を更新し、runs.using を変更し、分散された JavaScript を再構築し、テストを実行し、実際のワークフローでアクションを試験し、新しいリリースを公開することです。

自前ホスティングランナーは特別な注意が必要です

GitHub が管理するホスティングランナーとは異なり、自前ホスティングランナーは別物です。ランナーアプリケーションには JavaScript アクションで使用される Node.js エクスecutable が含まれており、ランナーのバージョンが重要です。Node 24 を基にしたアクションの最新リリースは、十分に最近の Actions Runner が必要です。

自前ホスティングランナーを運用している組織は、ワークフロー YAML のみを見るのではなく、ランナーのバージョン、オペレーティングシステム、アーキテクチャを含めて移行監査を行うべきです。古い OS は Node 24 がサポートするプラットフォーム基準を変更することで隠れたブロックになる可能性があります。

CodeQL には独自の移行経路があります

GitHub のコードスキャンを使用しているリポジトリは、CodeQL ワークフローも確認すべきです。CodeQL Action v4 は Node.js 24 ランタイムを使用します。高度な CodeQL セットアップは、古い github/codeql-action 参照がないか確認し、GitHub の現在の互換性ガイダンスに従って移行してください。

便利な監査コマンド

Unix 類似の開発マシン上で、簡単な最初のパスは:

grep -R "uses:" .github/workflows

リポジトリ内のカスタムアクションについて:

grep -R "using:.*node20" . --include="action.yml" --include="action.yaml"

これらの検索で互換性を証明するわけではありませんが、効率的な一覧を作成できます。目的は 3 つの質問に答えることです: どのアクションが使用されているか、どのバージョンがピンされているか、どのカスタムアクションが古いランタイムを宣言しているかです。

アクションはタグかコミット SHA にピン留めすべきか?

ランタイム移行は、サプライチェーンの健全性をレビューする機会でもあります。vendor/action@v4 のような参照は保持者によって移動できますが、完全なコミット SHA は不変なリビジョンを示します。

セキュリティに敏感なワークフローでは、サードパーティ製アクションをフルコミット SHA にピン留めすると、予期しないコード変更のリスクを低減できます。その代わりにメンテナンスが必要になります: 更新は deliberate process( deliberate なプロセス)または dependency-update ツールで行う必要があります。

特権付きプルリクエストワークフローには特に注意してください

古いアクションを更新することは重要ですが、ワークフローのセキュリティモデルがより重要です。pull_request_target はベースリポジトリのトークン、シークレット、キャッシュへのアクセス権を持つことができます。特権付きワークフロー内で攻撃者によるプルリクエストコードをチェックアウトすると、深刻なサプライチェーンの脆弱性が生じる可能性があります。

Node 24 に対する監査の際は、トリガーと権限を同時に確認してください。新しいランタイムが不安全なワークフローを安全にしないということです。

実践的な移行チェックリスト

最初に .github/workflows にあるすべての uses: 参照をリストアップします。リリースノートを確認した上で、古いファーストパーティアクションをアップグレードします。すべてのサードパーティアクションが Node 24 に対応した維持されているバージョンを持っているか確認します。カスタムアクションのメタデータで node20 を検索し、node24 へ移行し、バンドルを再構築してテストします。

自前ホスティングランナーについては、ランナーのバージョン、オペレーティングシステム、アーキテクチャを確認します。CodeQL の高度なワークフローをレビューします。最後に、重要なリリース、スケジュール、デプロイメントワークフローおよびデフォルトの CI パスを実行します。なぜなら、あまり使用されないジョブは古いアクションバージョンが残りやすいからです。

この移行を適切に行う価値がある理由

GitHub Actions 内での Node.js ランタイム移行は、他者のインフラ問題のように見えるかもしれません。しかしそれはそうではありません。アクションは CI/CD システム内の実行可能な依存関係です。リリースの構築、資格情報の処理、アーティファクトのアップロード、本番アプリケーションのデプロイを行うことができます。

GitHub が Node 20 から Node 24 へ移行したことは、CI 依存関係もアプリケーション依存関係と同じくライフサイクルを持つことを思い出させる価値があります。

immediate なタスクはシンプルです: 古い JavaScript アクションへの依存を削除し、必要に応じて自前ホスティングインフラを更新します。より長期的な教訓は価値があります: .github/workflows を維持されてきたアプリケーションインフラとして扱い、一度書いて忘れることのできる設定と見なさないこと。

アクション、ランナーのバージョン、権限、サードパーティ製依存関係を定期的に監査するリポジトリは、次のランタイム遷移に対してはるかに準備が整い、遷移間により安全になります。