Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Azure Pipelines-Agent wird mit mehreren Versionen von Node.js-Bibliotheken ausgeliefert, um Zielaufgaben zu unterstützen, die unterschiedliche Node.js Handlern verwenden können.
Warning
Node.js 6, 10 und 16 haben das Ende des Lebenszyklus erreicht und werden am 24. November 2026 aus dem Agenten entfernt. Der Azure Pipelines Agent enthält bereits Node.js 24. Erweiterungs- und benutzerdefinierte Aufgabenautoren sollten ihre Aufgaben mit Node.js 24 aktualisieren , um Auswirkungen auf Pipelines zu vermeiden, die diese Aufgaben verwenden.
Node.js Versionsunterstützung
In der folgenden Tabelle sind die Node.js Versionen aufgeführt, die in Azure-Pipelines unterstützt werden, sowie deren Enddatum und Entfernungsdaten.
| Node.js-Version | Ende des Supports in Azure-Pipelines | Datum der Entfernung in Azure Pipelines |
|---|---|---|
| 24 | April 20281 | Oktober 20281 |
| 20 | April 2026 | April 2027 |
| 16 | September 2021 | 24. November 2026 |
| 10 | April 2021 | 24. November 2026 |
| 6 | 2019. April | 24. November 2026 |
- Ende des Supports in Azure Pipelines – wenn das Enddatum des Supports erreicht ist, wird die Node.js Version nicht im Azure Pipelines-Agent aktualisiert. Der End-of-Support-Termin basiert auf dem offiziellen Node.js Supportzeitplan.
- Entfernungsdatum in Azure Pipelines – wenn das Entfernungsdatum erreicht ist, wird die Node.js Version aus neuen Agentversionen entfernt, und Aufgaben, die diese Node.js Versionen erfordern, können nicht ausgeführt werden. Das Datum der Entfernung liegt immer mindestens sechs Monate nach dem Datum des Support-Endes.
Pipelines geben Warnhinweise aus, um Benutzer auf bevorstehende Supportende- oder Entfernungstermine hinzuweisen.
Ab Node.js 24 umfasst der Azure Pipelines Agent nur alternative LTS-Versionen (Long-Term Support) von Node.js.
1Die Supportende- und Entfernungstermine für Node.js 24 entsprechen mit Stand November 2025 dem offiziellen Node.js Supportzeitplan. Diese Datumsangaben können basierend auf zukünftigen Ankündigungen des Node.js Teams geändert werden.
Entfernungsdatum für Node.js 6, 10 und 16
Node.js 6, 10 und 16 wurden seit ihren jeweiligen End-of-Support-Terminen in Pipelines nicht unterstützt. Pipelines mit Aufgaben, die von diesen Node.js Versionen abhängig sind, geben derzeit Warnungen aus, wenn sie ausgeführt werden. Damit Sie genügend Zeit haben, um Ihre benutzerdefinierten Aufgaben zu einer unterstützten Node.js Version zu migrieren, haben wir das Entfernungsdatum auf den 24. November 2026 verlängert.
Informationen zum Aktualisieren und Testen Ihrer benutzerdefinierten Aufgaben auf die aktuelle Version von Node.jsfinden Sie unter How can I upgrade my task to the latest Node.js version.
Testaufgaben ausführen, bevor Node.js-Runner mit erreichtem End-of-Life entfernt werden
Verwenden Sie die Einstellung Nicht mehr unterstützte Node.js-Versionen in Pipelineaufgaben auf Organisationsebene einschränken, um zu bewerten, wie sich das Entfernen von Node.js 6, 10 und 16 aus dem Agent auf Ihre Pipelines auswirkt. Die Einstellung ist standardmäßig deaktiviert. Wenn Sie dies aktivieren, werden betroffene Aufgaben mit einem neueren verfügbaren Node.js-Runner ausgeführt anstelle des für sie deklarierten End-of-Life-Runners.
Diese Einstellung hilft Ihnen, betroffene Pipelines zu identifizieren und zu aktualisieren, bevor Node.js 6, 10 und 16 am 24. November 2026 vom Agent entfernt werden. Es entfernt die Runner nicht vom Agenten.
Voraussetzungen für dieses Feature
Sie benötigen Agent Version 4.278.0 oder höher für die vorherige Einstellung.
Aktivieren der Einstellung
Wechseln Sie zu Organisationseinstellungen>Pipelines>Einstellungen.
Aktivieren Sie unter "Aufgabeneinschränkungen" die Option "Einschränken der Unterstützung" Node.js Versionen in Pipelineaufgaben.
Führen Sie Ihre Pipelines aus, und prüfen Sie die Protokolle auf Warnungen zu Aufgaben, die von Node.js-Versionen abhängen, die das Ende ihres Lebenszyklus erreicht haben.
Verhalten, wenn die Einstellung aktiviert ist
Für jede Aufgabe, die einen Node.js 6-, 10- oder 16-Ausführungs-Handler deklariert, führt der Agent Folgendes aus:
- Verhindert, dass der Task den als End-of-Life deklarierten Node.js-Runner verwendet.
- Wählt einen neueren verfügbaren Läufer aus, bevorzugt Node.js 24 und dann Node.js 20.
- Protokolliert eine Warnung, die die betroffene Aufgabe angibt und erläutert, dass sie möglicherweise fehlschlagen oder sich unerwartet verhalten könnte.
- Führt die Aufgabe mit dem ausgewählten Läufer aus oder schlägt die Aufgabe fehl, wenn kein kompatibler neuerer Läufer verfügbar ist.
Die Einstellung gilt für Microsoft gehostete und selbst gehostete Agents sowie für Aufgaben, die auf dem Agenthost oder in einem Container ausgeführt werden.
Important
Das Ausführen einer Aufgabe mit einer neueren Node.js Version macht die Aufgabe nicht mit dieser Version kompatibel. Testen Sie betroffene Pipelines, und aktualisieren Sie benutzerdefinierte Aufgaben, um einen aktuellen Node.js Läufer zu verwenden. Anleitungen zur Migration finden Sie unter How can I upgrade my task to the latest Node.js version.
Ausführen von Aufgaben für nicht unterstützte Node.js-Versionen
Um die Abwärtskompatibilität für benutzerdefinierte Aufgaben mit einer nicht mehr unterstützten oder entfernten Node.js-Version aufrechtzuerhalten, bieten wir diese Self-Service-Optionen an, damit Sie die erforderlichen Node.js Runner installieren können:
Installieren Sie den gewünschten Node.js Runner manuell. Weitere Informationen finden Sie unter Unterstützung für Node.js Runner.
Verwenden Sie die
NodeTaskRunnerInstaller@0-Aufgabe in Ihren Pipelines, die eine veraltete Node.js-Bibliothek erfordern.Installieren Sie ein Agent-Paket, das die gewünschten Node.js Bibliotheken enthält.
Azure Pipelines bietet zwei Versionen von Agentpaketen:
-
vsts-agent-\: Pakete, die Node.js 6- und Node.js 10-Bibliotheken unterstützen. -
pipelines-agent-\: Pakete, die Node.js 6- und Node.js 10-Bibliotheken nicht unterstützen. In Zukunft wird diese Version des Pakets zum Standard-Agent-Paket.
Hinweis
Das
pipelines-agentPaket enthält nicht Node.js 16. Erweiterungs- und benutzerdefinierte Aufgabenautoren sollten ihre Aufgaben mit Node.js 24 aktualisieren und testen.Wenn Ihre Aufgaben die Node.js 6- oder Node.js 10-Bibliothek nicht benötigen und Sie die Node.js 6- oder Node.js 10-Bibliothek nicht auf Ihrem Agentcomputer installieren möchten, können Sie den Agent aus dieser Dokumentation unter "Alternative Agent Downloads" installieren.
-
Häufig gestellte Fragen
Was geschieht mit Aufgaben, die Node.js 6, 10 oder 16 verwenden, wenn ich die Einstellung aktiviert habe?
Der Agent blockiert den deklarierten End-of-Life-Läufer der Aufgabe und versucht, die Aufgabe mit Node.js 24 auszuführen, oder mit Node.js 20, wenn Node.js 24 nicht verfügbar oder verwendbar ist. Das Pipelineprotokoll identifiziert den betroffenen Vorgang und zeigt eine Warnung an. Wenn kein neuer verwendbarer Läufer verfügbar ist, schlägt die Aufgabe fehl.
Skripts und Anwendungen, die Node.js verwenden, sind nicht allein betroffen, weil sie Node.jsverwenden. Die Einstellung gilt für den Node.js Ausführungshandler, der von einer Azure Pipelines Aufgabe deklariert wird.
Warum schlug meine Pipeline fehl, nachdem ich die Einstellung aktiviert habe?
Die Pipeline verwendet möglicherweise Vorgänge, die nicht mit dem neueren Node.js Läufer kompatibel sind. Überprüfen Sie die Vorgangswarnung und den Fehler im Pipelineprotokoll, um den betroffenen Vorgang zu identifizieren.
- Aktualisieren Sie bei einer integrierten Aufgabe die Pipeline so, dass die neueste Hauptversion der Aufgabe verwendet wird.
- Suchen Sie bei einer Marketplace-Aufgabe nach einer aktualisierten Version, oder wenden Sie sich an den Erweiterungsherausgeber.
- Aktualisieren Sie für eine benutzerdefinierte Aufgabe den Ausführungshandler und die Abhängigkeiten auf eine aktuelle Node.js Version. Weitere Informationen finden Sie unter Wie kann ich meine Aufgabe auf die neueste Node.js-Version aktualisieren.
- Stellen Sie für einen selbst gehosteten Agent sicher, dass die Agent-Version auf Version 4.278.0 oder höher aktualisiert wird.
Bis die End-of-Life-Läufer entfernt werden, können Sie die Organisationseinstellung vorübergehend deaktivieren, während Sie die Aufgabe aktualisieren. Die Deaktivierung dieser Einstellung ist keine langfristige Lösung, da Node.js 6, 10 und 16 am 24. November 2026 entfernt werden sollen.
Entfernt die Einstellung Node.js 6, 10 oder 16 von meinen Agents?
No. Durch diese Einstellung wird verhindert, dass Pipeline-Tasks diese Runner auswählen, sodass Sie die Auswirkungen ihrer bevorstehenden Entfernung testen können. Es werden keine Dateien von einem Agent deinstalliert.
Kann ich weiterhin einen nicht unterstützten Node.js Läufer verwenden?
Eine End-of-Life-Laufzeit beizubehalten hat Sicherheits- und Kompatibilitätsrisiken, aktualisieren Sie stattdessen die Aufgabe. Informationen zu temporären Self-Hosted-Agent-Optionen finden Sie unter So führen Sie Aufgaben auf nicht unterstützten Node.js-Versionen aus.
Wirkt sich die Einstellung auf Azure DevOps Server aus?
No. Die Organisationseinstellung ist in Azure DevOps Server nicht verfügbar.