Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De Azure-pipelines-agent wordt geleverd met verschillende versies van Node.js-bibliotheken ter ondersteuning van doeltaken die verschillende Node.js handlers kunnen gebruiken.
Warning
Node.js 6, 10 en 16 hebben het einde van de levensduur bereikt en worden op 24 november 2026 uit de agent verwijderd. De Azure-pipelines-agent bevat al Node.js 24. Auteurs van extensies en aangepaste taken moeten hun taken bijwerken met Node.js 24 om gevolgen te voorkomen voor pijplijnen die deze taken gebruiken.
ondersteuning voor Node.js-versie
De volgende tabel bevat de Node.js versies die worden ondersteund in Azure-pipelines, samen met hun einddatums en verwijderingsdatums.
| Node.js versie | Einde van ondersteuning in Azure-pipelines | Verwijderingsdatum in Azure-pipelines |
|---|---|---|
| 24 | April 20281 | Oktober 20281 |
| 20 | April 2026 | april 2027 |
| 16 | 2021 september | 24 november 2026 |
| 10 | 2021 april | 24 november 2026 |
| 6 | Mei 2019 | 24 november 2026 |
- Einde van de ondersteuning in Azure-pipelines : wanneer de einddatum van de ondersteuning is bereikt, wordt de Node.js versie niet bijgewerkt in de Azure-pipelines-agent. De einddatum van de ondersteuning is gebaseerd op het officiële Node.js ondersteuningsschema.
- Verwijderingsdatum in Azure-pipelines : wanneer de verwijderingsdatum is bereikt, wordt de Node.js versie verwijderd uit nieuwe agentversies en kunnen taken waarvoor deze Node.js versies zijn vereist, niet worden uitgevoerd. De verwijderingsdatum zal altijd ten minste zes maanden na de einddatum van de ondersteuning zijn.
Pipelines geven waarschuwingen weer om gebruikers te informeren over naderende datums waarop de ondersteuning eindigt of waarop iets wordt verwijderd.
Vanaf Node.js 24 bevat de Azure-pipelines agent alleen alternatieve LTS-versies (Long-Term Support) van Node.js.
1De einddatums en verwijderingsdatums voor Node.js 24 komen overeen met het officiële Node.js ondersteuningsschema vanaf november 2025. Deze datums kunnen worden gewijzigd op basis van toekomstige aankondigingen van het Node.js team.
Verwijderingsdatum voor Node.js 6, 10 en 16
Node.js 6, 10 en 16 worden in pipelines niet meer ondersteund sinds hun respectieve ondersteunings-einddatums. Pijplijnen met taken die afhankelijk zijn van deze Node.js versies verzenden momenteel waarschuwingen wanneer ze worden uitgevoerd. Om u voldoende tijd te geven om uw aangepaste taken te migreren naar een ondersteunde Node.js versie, hebben we de verwijderingsdatum verlengd tot 24 november 2026.
Zie Hoe kan ik mijn taak bijwerken en testen naar de nieuwste Node.js-versie voor meer informatie over het bijwerken en testen van uw aangepaste taken naar de huidige versie van Node.js.
Test taken voordat end-of-life Node.js-runners worden verwijderd
Gebruik de instelling op organisatieniveau Niet-ondersteunde Node.js-versies beperken in pijplijntaken om te beoordelen welke invloed het verwijderen van Node.js 6, 10 en 16 van de agent op uw pijplijnen heeft. De instelling is standaard uitgeschakeld. Wanneer u dit inschakelt, worden de betreffende taken uitgevoerd met een nieuwere beschikbare Node.js-runner in plaats van hun opgegeven end-of-life-runner.
Met deze instelling kunt u betrokken pijplijnen identificeren en bijwerken voordat Node.js 6, 10 en 16 van de agent worden verwijderd op 24 november 2026. De hardlopers worden niet van de agent verwijderd.
Vereisten voor deze functie
Voor de voorgaande instelling hebt u Agent versie 4.278.0 of hoger nodig.
De instelling inschakelen
Ga naar Organisatie-instellingen>Pijplijnen>Instellingen.
Schakel onder TaakbeperkingenNiet-ondersteunde Node.js-versies in pijplijntaken beperken in.
Voer uw pijplijnen uit en bekijk de logboeken voor waarschuwingen over taken die afhankelijk zijn van de end-of-life-Node.js versies.
Gedrag wanneer de instelling is ingeschakeld
Voor elke taak die een Node.js 6, 10 of 16 uitvoeringshandler declareert, is de agent:
- Hiermee voorkomt u dat de taak de opgegeven end-of-life Node.js-runner gebruikt.
- Selecteert een nieuwere beschikbare runner, met voorkeur voor Node.js 24 en daarna Node.js 20.
- Registreert een waarschuwing waarmee de betrokken taak wordt geïdentificeerd en wordt uitgelegd dat deze mogelijk mislukt of onverwacht werkt.
- Voert de taak uit met de geselecteerde runner, of laat de taak mislukken als er geen nieuwere compatibele runner beschikbaar is.
De instelling is van toepassing op Microsoft gehoste en zelf-hostende agents en op taken die worden uitgevoerd op de agenthost of in een container.
Important
Als u een taak uitvoert met een nieuwere Node.js versie, wordt de taak niet compatibel met die versie. Test de betrokken pijplijnen en werk aangepaste taken bij om een huidige Node.js runner te gebruiken. Zie Hoe kan ik mijn taak upgraden naar de meest recente Node.js versie voor migratie.
Taken uitvoeren op niet-ondersteunde Node.js versies
Om compatibiliteit met eerdere versies voor aangepaste taken te behouden met behulp van een Node.js-versie die niet meer wordt ondersteund of verwijderd, bieden we deze selfserviceopties zodat u de vereiste Node.js runner kunt installeren:
Installeer de gewenste Node.js runner handmatig. Zie Node.js runner-ondersteuning voor meer informatie.
Gebruik de
NodeTaskRunnerInstaller@0taak in uw pijplijnen waarvoor een verouderde Node.js-bibliotheek is vereist.Installeer een agentpakket met de gewenste Node.js bibliotheken.
Azure-pipelines biedt twee versies van agentpakketten:
-
vsts-agent-\: Pakketten die ondersteuning bieden voor Node.js 6- en Node.js 10 bibliotheken. -
pipelines-agent-\: Pakketten die geen ondersteuning bieden voor Node.js 6- en Node.js 10 bibliotheken. In de toekomst wordt deze versie van het pakket het standaardagentpakket.
Opmerking
Het
pipelines-agentpakket bevat geen Node.js 16. Auteurs van extensies en aangepaste taken moeten hun taken bijwerken en testen met Node.js 24.Als voor uw taken de bibliotheek Node.js 6 of Node.js 10 niet is vereist en u de bibliotheek Node.js 6 of Node.js 10 niet wilt installeren op uw agentcomputer, kunt u de agent installeren vanuit deze documentatie onder Alternatieve agentdownloads.
-
FAQ
Wat gebeurt er met taken die gebruikmaken van Node.js 6, 10 of 16 wanneer ik de instelling inschakelen?
De agent blokkeert de gedeclareerde end-of-life runner van de taak en probeert de taak uit te voeren met Node.js 24 of met Node.js 20 als Node.js 24 niet beschikbaar of bruikbaar is. Het pijplijnlogboek identificeert de betrokken taak en geeft een waarschuwing weer. Als er geen nieuwere bruikbare runner beschikbaar is, mislukt de taak.
Scripts en toepassingen die gebruikmaken van Node.js worden niet alleen beïnvloed omdat ze Node.jsgebruiken. De instelling is van toepassing op de Node.js uitvoeringshandler die door een Azure-pipelines taak is gedeclareerd.
Waarom begon mijn pipeline te mislukken nadat ik de instelling had ingeschakeld?
De pijplijn gebruikt mogelijk taak(en) die niet compatibel zijn met de nieuwere Node.js runner. Bekijk de taakwaarschuwing en -fout in het pijplijnlogboek om de betrokken taak te identificeren.
- Werk voor een ingebouwde taak de pijplijn bij om de meest recente primaire versie van de taak te gebruiken.
- Voor een Marketplace-taak controleert u op een bijgewerkte versie of neemt u contact op met de uitgever van de extensie.
- Werk voor een aangepaste taak de uitvoeringshandler en afhankelijkheden bij naar een huidige Node.js versie. Zie Hoe kan ik mijn taak upgraden naar de meest recente Node.js versie voor meer informatie.
- Voor een zelf-gehoste agent zorgt u ervoor dat de Agent-versie is bijgewerkt naar v 4.278.0 of later.
Totdat de eindlopers worden verwijderd, kunt u de organisatie-instelling tijdelijk uitschakelen terwijl u de taak bijwerkt. Het uitschakelen van de instelling is geen langetermijnoplossing omdat Node.js 6, 10 en 16 zijn gepland voor verwijdering op 24 november 2026.
Verwijdert de instelling Node.js 6, 10 of 16 van mijn agents?
No. De instelling voorkomt dat pijplijntaken deze runners selecteren, zodat u het effect van de aanstaande verwijdering kunt testen. Hiermee worden bestanden niet van een agent gedeïnstalleerd.
Kan ik een niet-ondersteunde Node.js runner blijven gebruiken?
Een runtime waarvan de ondersteuning is beëindigd, brengt beveiligings- en compatibiliteitsrisico's met zich mee, dus werk de taak in plaats daarvan bij. Zie Taken uitvoeren op niet-ondersteunde Node.js versies voor tijdelijke zelf-hostende agentopties.
Heeft de instelling invloed op Azure DevOps Server?
No. De organisatie-instelling is niet beschikbaar in Azure DevOps Server.