Azure Pipelines エージェントの Node.js ランナー

Azure Pipelines エージェントには、異なる Node.js ハンドラーを使用する可能性があるターゲット タスクをサポートするために、複数のバージョンの Node.js ライブラリが付属しています。

Warning

Node.js 6、10、16 は寿命が終了し 、2026 年 11 月 24 日にエージェントから削除されます。 Azure Pipelines エージェントには、既に Node.js 24 が含まれています。 拡張機能およびカスタム タスク作成者は、これらのタスクを使用するパイプラインへの影響を回避するために 、タスクを Node.js 24 で更新 する必要があります。

Node.js バージョンのサポート

次の表に、Azure Pipelines でサポートされている Node.js バージョンと、サポート終了日と削除日を示します。

Node.js バージョン Azure Pipelines でのサポート終了 Azure Pipelines での削除日
24 2028 年 4 月1 日 2028 年10 月 1 日
20 2026 年 4 月 2027 年 4 月
16 2021 年 9 月 2026 年 11 月 24 日
10 2021 年 4 月 2026 年 11 月 24 日
6 2019 年 4 月 2026 年 11 月 24 日
  • Azure Pipelines でのサポートの終了 - サポート終了日に達すると、Node.js バージョンは Azure Pipelines エージェントで更新されません。 サポート終了日は、公式の Node.js サポート スケジュールに基づいています。
  • Azure Pipelines での削除日 - 削除日に達すると、Node.js バージョンが新しいエージェント バージョンから削除され、これらの Node.js バージョンを必要とするタスクは実行に失敗する可能性があります。 削除日は、常にサポート終了日から少なくとも 6 か月後になります。

パイプラインは、今後のサポート終了日または削除日をユーザーに通知する警告を出力します。

Node.js 24 以降、Azure Pipelines エージェントには、Node.jsの代替長期サポート (LTS) バージョンのみが含まれています。

1Node.js 24 のサポート終了日と削除日は、2025 年 11 月時点の公式 のNode.js サポート スケジュール と一致します。 これらの日付は、Node.js チームからの今後の発表に基づいて変更される可能性があります。

Node.js 6、10、16 の削除日

Node.js 6、10、および 16 は、それぞれのサポート終了日以降、パイプラインではサポートされていません。 現在、これらの Node.js バージョンに依存するタスクを含むパイプラインでは、実行時に警告が出力されます。 カスタム タスクをサポートされている Node.js バージョンに移行するのに十分な時間を確保するために、削除日を 2026 年 11 月 24 日に延長しました。

カスタム タスクを更新して現在のバージョンの Node.jsにテストする方法については、「 タスクを最新の Node.js バージョンにアップグレードする方法」を参照してください。

サポート終了した Node.js ランナーが削除される前にタスクをテストする

組織レベルの パイプライン タスクでサポート対象外の Node.js バージョンを制限する 設定を使用して、エージェントから Node.js 6、10、16 を削除した場合のパイプラインへの影響を評価します。 この設定は、既定では無効になっています。 有効にすると、影響を受けるタスクは、宣言された有効期間終了ランナーではなく、新しい使用可能な Node.js ランナーで実行されます。

この設定は、 2026 年 11 月 24 日 Node.js エージェントから 6、10、16 が削除される前に、影響を受けるパイプラインを特定して更新するのに役立ちます。 エージェントからランナーは削除されません。

この機能の前提条件

前の設定には エージェント バージョン 4.278.0 以降が必要です。

設定を有効にする

  1. 組織の 設定>Pipelines>Settings に移動します。

  2. [ タスクの制限] で、[ パイプライン タスクのサポート Node.js バージョンを制限する] を有効にします。

    パイプライン タスクでサポート外のバージョンを制限 Node.js 設定を示すスクリーンショット。

  3. パイプラインを実行し、サポート終了となった Node.js バージョンに依存するタスクに関する警告がないかログを確認します。

設定が有効な場合の動作

Node.js 6、10、または 16 の実行ハンドラーを宣言するタスクごとに、エージェントは次のようにします。

  1. タスクが指定されたサポート終了済みの Node.js ランナーを使用しないようにします。
  2. 利用可能な新しいランナーを選択し、Node.js 24 を優先し、次に Node.js 20 を優先します。
  3. 影響を受けるタスクを識別し、失敗または予期しない動作が発生する可能性があることを説明する警告をログに記録します。
  4. 選択したランナーでタスクを実行するか、互換性のある新しいランナーが使用できない場合はタスクを失敗させます。

この設定は、Microsoftホスト型エージェントとセルフホステッド エージェント、およびエージェント ホストまたはコンテナーで実行されるタスクに適用されます。

Important

新しい Node.js バージョンでタスクを実行しても、タスクはそのバージョンと互換性がありません。 影響を受けるパイプラインをテストし、現在の Node.js ランナーを使用するようにカスタム タスクを更新します。 移行ガイダンスについては、「 タスクを最新の Node.js バージョンにアップグレードする方法」を参照してください。

サポートされていない Node.js バージョンでタスクを実行する方法

サポートされなくなった、または削除された Node.js バージョンを使用してカスタム タスクの下位互換性を維持するために、必要な Node.js ランナーをインストールできるように、次のセルフサービス オプションが提供されています。

  • 目的の Node.js ランナーを手動でインストールします。 詳細については、Node.js ランナーサポートを参照してください。

  • 古い Node.js ライブラリを必要とするパイプラインの NodeTaskRunnerInstaller@0 タスクを使用します。

  • 目的の Node.js ライブラリを含むエージェント パッケージをインストールします。

    Azure Pipelines には、次の 2 つのバージョンのエージェント パッケージが用意されています。

    • vsts-agent-\: Node.js 6 および Node.js 10 のライブラリをサポートするパッケージ。
    • pipelines-agent-\: Node.js 6 および Node.js 10 個のライブラリをサポートしていないパッケージ。 今後、このバージョンのパッケージが既定のエージェント パッケージになります。

    注

    pipelines-agent パッケージには、Node.js 16 は含まれません。 拡張機能およびカスタム タスク作成者は、 Node.js 24 でタスクを更新してテストする必要があります。

    タスクに Node.js 6 または Node.js 10 ライブラリが不要で、エージェント コンピューターに Node.js 6 または Node.js 10 ライブラリをインストールしない場合は、 このドキュメントの [代替エージェントのダウンロード] でエージェントをインストールできます。

FAQ

設定を有効にすると、Node.js 6、10、または 16 を使用するタスクはどうなりますか?

エージェントは、タスクの宣言された有効期間終了ランナーをブロックし、Node.js 24、または Node.js 20 (Node.js 24 が使用できない場合、または使用できない場合) でタスクを実行しようとします。 パイプライン ログは、影響を受けるタスクを識別し、警告を表示します。 使用可能な新しいランナーがない場合、タスクは失敗します。

Node.js を使用するスクリプトとアプリケーションは、Node.jsを使用するためだけに影響を受けるわけではありません。 この設定は、Azure Pipelines タスクによって宣言された Node.js 実行ハンドラーに適用されます。

設定を有効にした後、パイプラインが失敗し始めたのはなぜですか?

パイプラインは、新しい Node.js ランナーと互換性のないタスクを使用している可能性があります。 パイプライン ログのタスクの警告とエラーを確認して、影響を受けるタスクを特定します。

  • 組み込みタスクの場合は、最新のタスク メジャー バージョンを使用するようにパイプラインを更新します。
  • Marketplace タスクの場合は、更新されたバージョンを確認するか、拡張機能の発行元にお問い合わせください。
  • カスタム タスクの場合は、その実行ハンドラーと依存関係を現在の Node.js バージョンに更新します。 詳細については、「 タスクを最新の Node.js バージョンにアップグレードする方法」を参照してください。
  • セルフホステッド エージェントの場合は、エージェントのバージョンが v 4.278.0 以降に更新されていることを確認します。

サポート終了したランナーが削除されるまでの間、タスクを更新するあいだは、組織設定を一時的に無効にできます。 Node.js 6、10、16 は 2026 年 11 月 24 日に削除される予定であるため、この設定を無効にすることは長期的な解決策ではありません。

この設定では、エージェントから Node.js 6、10、または 16 が削除されますか?

No. この設定により、パイプライン タスクでこれらのランナーが選択されるのを防ぎ、今後の削除の効果をテストできます。 エージェントからファイルがアンインストールされることはありません。

サポートされていない Node.js ランナーを引き続き使用できますか?

有効期間の終了ランタイムを維持すると、セキュリティと互換性のリスクがあるため、代わりにタスクを更新します。 一時的なセルフホステッド エージェント オプションについては、「 サポートされていない Node.js バージョンでタスクを実行する方法」を参照してください。

この設定はAzure DevOps Serverに影響しますか?

No. 組織の設定は、Azure DevOps Serverでは使用できません。

関連項目

  • Last updated on