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年2月1日 |
| 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 版本的任務可能會無法執行。 移除日期將始終至少在停止支援日期後六個月。
管線會發出警告,告知用戶即將到來的支援終止或下架日期。
備註
由於 Node.js Node.js 20 中報告存在漏洞, 20 的移除日期從 2027 年 4 月延至 2027 年 2 月 1 日。 從代理程式版本 283 起,該 pipelines-agent 套件不再包含 Node.js 20 執行器。
從 Node.js 24 開始,Azure Pipelines 代理程式僅包含交替的長期支援(LTS)Node.js 版本。
124 Node.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 從代理移除前,識別並更新受影響的管線。 它不會從代理程式中移除執行器。
此功能的前提條件
你需要 Agent 4.278.0 或更新版本 才能使用上述設定。
啟用該設定
前往 組織設定>管道>設定。
在 任務限制 下,啟用 限制在管線工作中使用已停止支援的 Node.js 版本。
執行您的管線,並檢查記錄中是否有關於相依於已終止支援之 Node.js 版本的工作的警告。
啟用設定時的行為
當代理程式選擇由代理程式管理的執行者時,此設定會防止宣告 Node.js 6、10 或 16 個執行處理器的任務使用這些執行者。 當任務以較新的執行程式執行時,代理程式會記錄警告,以識別該任務並說明它可能會失敗或出現異常行為。 Runner 選擇取決於代理程式版本:
- 代理程式版本 5.283.0 及更新版本: 代理程式也會將此行為套用於宣告 Node.js 20 執行處理器的任務。 它嘗試 Node.js 24,卻沒有回落到 Node.js 20。 如果 Node.js 24 不可用或無法使用,即使 Node.js 20 可用,任務或容器作業也會失敗。
- 較早期的代理程式版本: 代理會嘗試 Node.js 24,如果 Node.js 24 不可用且 Node.js 20 可用,則會回退到 Node.js 20。 如果兩個執行程式都無法取得且無法正常運作,任務就會失敗。
明確設定的自訂 Node.js 路徑會覆蓋代理程式管理的執行者選擇。
此設定適用於 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 提供兩個版本的代理程式套件:
-
vsts-agent-\:支援 Node.js 6 與 Node.js 10 函式庫的套件。 -
pipelines-agent-\:不支援 Node.js 6 和 Node.js 10 函式庫的套件。 未來,此版本的套件會成為預設代理程式套件。
備註
該
pipelines-agent套件不包含 Node.js 16;且從代理程式版本 283 起,也不包含 Node.js 20。 擴充功能與自訂任務作者應更新 並測試 Node.js 24 的任務。如果您的工作不需要 Node.js 6 或 Node.js 10 程式庫,而且您不想在代理程式電腦上安裝 Node.js 6 或 Node.js 10 程式庫,您可以從 本文件的替代代理程式下載下安裝代理程式。
-
FAQ
當我啟用該設定時,使用 Node.js 6、10或16的任務會發生什麼事?
對於代理程式管理的 5.283.0 版本及更新版本的執行程式,代理程式會嘗試以 Node.js 24 執行這些任務,且不會回退至 Node.js 20。 同樣的規則也適用於宣告 Node.js 20 執行處理器的任務。 如果 Node.js 24 不可用或無法使用,該任務或容器作業就會失敗。 若 Node.js 24 不可用或無法使用,較早期版本的代理程式可退回到使用 Node.js 20,適用於使用 Node.js 6、10 或 16 的任務。 檢查任務記錄是否有警告或錯誤。
使用 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 版本上執行任務。
為什麼 Node.js 20 在我的代理程式中無法取得?
從代理程式版本 283 開始,套件 pipelines-agent 中不再包含 Node.js 20 的執行器。 由於回報的漏洞,Azure Pipelines 中的 Node.js 20 的移除日期也被延後至 2027 年 2 月 1 日。 使用 Node.js 24 更新並測試自訂任務。 關於遷移指引,請參閱「 我如何將我的任務升級到最新版本的 Node.js」。
這個設定會影響 Azure DevOps Server 嗎?
No. 組織設定在 Azure DevOps Server 中無法使用。