Node.js löpare i Azure-pipelines Agent

Azure-pipelines-agenten levereras med flera versioner av Node.js bibliotek för att stödja måluppgifter som kan använda olika Node.js hanterare.

Varning

Node.js 6, 10 och 16 har nått slutet av sin livscykel och kommer att tas bort från agenten den 24 november 2026. Azure-pipelines-agenten innehåller redan Node.js 24. Författare av tillägg och anpassade aktiviteter bör uppdatera sina aktiviteter till Node.js 24 för att undvika påverkan på Pipelines som använder dessa aktiviteter.

stöd för Node.js version

I följande tabell visas de Node.js versioner som stöds i Azure-pipelines, tillsammans med deras slutdatum för support och borttagningsdatum.

Node.js-version Support upphör i Azure-pipelines Borttagningsdatum i Azure-pipelines
24 April 20281 Oktober 20281
20 April 2026 april 2027
16 2021 september den 24 november 2026
10 2021 april den 24 november 2026
6 2019 april den 24 november 2026
  • Support upphör i Azure-pipelines – när supportdatumet har nåtts uppdateras inte den Node.js versionen i Azure-pipelines-agenten. Slutdatumet för support baseras på det officiella Node.js supportschemat.
  • Borttagningsdatum i Azure-pipelines – när borttagningsdatumet har nåtts tas Node.js versionen bort från nya agentversioner och uppgifter som kräver dessa Node.js versioner kan misslyckas. Borttagningsdatumet kommer alltid att vara minst sex månader efter datum för supportens slut.

Pipelines utfärdar varningar för att informera användarna om kommande datum då supporten upphör eller funktionen tas bort.

Från och med Node.js 24 innehåller Azure-pipelines-agenten endast alternativa långsiktiga supportversioner (LTS) av Node.js.

1Slutdatumen för support och borttagning för Node.js 24 överensstämmer med det officiella Node.js supportschemat från och med november 2025. Dessa datum kan komma att ändras baserat på framtida meddelanden från Node.js-teamet.

Borttagningsdatum för Node.js 6, 10 och 16

Node.js 6, 10 och 16 har inte haft stöd i pipelines sedan deras respektive datum då supporten upphörde. Pipelines med uppgifter som är beroende av dessa Node.js versioner genererar för närvarande varningar när de körs. För att ge dig tillräckligt med tid för att migrera dina anpassade uppgifter till en Node.js version som stöds har vi förlängt borttagningsdatumet till den 24 november 2026.

Information om hur du uppdaterar och testar dina anpassade uppgifter till den aktuella versionen av Node.jsfinns i Hur kan jag uppgradera min uppgift till den senaste Node.js versionen.

Testuppgifter innan uttjänt Node.js löpare tas bort

Använd inställningen på organisationsnivå Begränsa Node.js-versioner utan support i pipelineuppgifter för att bedöma hur borttagningen av Node.js 6, 10 och 16 från agenten påverkar dina pipelines. Inställningen är inaktiverad som standard. När du aktiverar det körs berörda uppgifter med en nyare tillgänglig Node.js-körmiljö i stället för den körmiljö som de har deklarerats för och som har nått slutet av sin livscykel.

Den här inställningen hjälper dig att identifiera och uppdatera påverkade pipelines innan Node.js 6, 10 och 16 tas bort från agenten den 24 november 2026. Det tar inte bort löparna från agenten.

Förutsättningar för den här funktionen

Du behöver Agent version 4.278.0 eller senare för föregående inställning.

Aktivera inställningen

  1. Gå till Organisationsinställningar>Pipelines>Inställningar.

  2. Under Uppgiftsbegränsningar aktiverar du Begränsa Node.js-versioner som inte längre stöds i pipelineuppgifter.

    Skärmbild som visar att inställningen är aktiverad för att begränsa versioner av Node.js som inte längre stöds i pipelineuppgifter.

  3. Kör dina pipelines och granska loggarna efter varningar om aktiviteter som är beroende av Node.js-versioner som har nått slutet av sin livslängd.

Beteende när inställningen är aktiverad

För varje uppgift som deklarerar en körningshanterare för Node.js 6, 10 eller 16 gör agenten:

  1. Förhindrar att aktiviteten använder sin deklarerade Node.js-körmiljö som har nått slutet av sin livscykel.
  2. Väljer en nyare tillgänglig runner, med företräde för Node.js 24 och därefter Node.js 20.
  3. Loggar en varning som identifierar den berörda aktiviteten och förklarar att den kan misslyckas eller bete sig oväntat.
  4. Kör uppgiften med den valda löparen eller misslyckas om det inte finns någon kompatibel nyare löpare tillgänglig.

Inställningen gäller för Microsoft värdbaserade och lokalt installerade agenter och för uppgifter som körs på agentvärden eller i en container.

Important

Att köra en uppgift med en nyare Node.js version gör inte uppgiften kompatibel med den versionen. Testa berörda pipelines och uppdatera anpassade uppgifter för att använda en aktuell Node.js löpare. Information om migrering finns i Hur kan jag uppgradera min uppgift till den senaste Node.js versionen.

Så här kör du uppgifter på Node.js versioner som inte stöds

För att upprätthålla bakåtkompatibilitet för anpassade uppgifter med hjälp av en Node.js version som inte längre stöds eller har tagits bort, erbjuder vi dessa självbetjäningsalternativ så att du kan installera de nödvändiga Node.js löpare:

  • Installera önskad Node.js löpare manuellt. För mer information, se om Node.js runner-stöd.

  • Använd uppgiften NodeTaskRunnerInstaller@0 i dina pipelines som kräver ett föråldrat Node.js-bibliotek.

  • Installera ett agentpaket som innehåller önskade Node.js bibliotek.

    Azure-pipelines innehåller två versioner av agentpaket:

    • vsts-agent-\: Paket som stöder Node.js 6- och Node.js 10 bibliotek.
    • pipelines-agent-\: Paket som inte stöder Node.js 6- och Node.js 10 bibliotek. I framtiden blir den här versionen av paketet standardagentpaketet.

    Anmärkning

    Paketet pipelines-agent innehåller inte Node.js 16. Författare av tillägg och anpassade uppgifter bör uppdatera och testa sina uppgifter med Node.js 24.

    Om dina uppgifter inte kräver biblioteket Node.js 6 eller Node.js 10 och du inte vill installera biblioteket Node.js 6 eller Node.js 10 på agentdatorn kan du installera agenten från den här dokumentationen under Alternativ agentnedladdning.

FAQ

Vad händer med uppgifter som använder Node.js 6, 10 eller 16 när jag aktiverar inställningen?

Agenten blockerar uppgiftens deklarerade slutpunktslöpare och försöker köra uppgiften med Node.js 24, eller med Node.js 20 om Node.js 24 inte är tillgänglig eller användbar. Pipelineloggen identifierar den berörda aktiviteten och visar en varning. Om ingen nyare användbar löpare är tillgänglig misslyckas uppgiften.

Skript och program som använder Node.js påverkas inte enbart eftersom de använder Node.js. Inställningen gäller för körningshanteraren för Node.js som deklareras av en Azure-pipelines-uppgift.

Varför började min pipeline misslyckas när jag har aktiverat inställningen?

Pipelinen kanske använder uppgifter som inte är kompatibla med den nyare Node.js löparen. Granska aktivitetsvarningen och felet i pipelineloggen för att identifiera den berörda aktiviteten.

  • För en inbyggd uppgift uppdaterar du pipelinen så att den använder den senaste huvudversionen av aktiviteten.
  • För en Marketplace-uppgift kontrollerar du om det finns en uppdaterad version eller kontaktar utgivaren av tillägget.
  • För en anpassad uppgift uppdaterar du dess körningshanterare och beroenden till en aktuell Node.js version. Mer information finns i Hur kan jag uppgradera min uppgift till den senaste Node.js versionen.
  • För en lokalt installerad agent kontrollerar du att agentversionen har uppdaterats till v 4.278.0 eller senare.

Till dess att de runners som har nått slutet av sin livscykel har tagits bort kan du tillfälligt inaktivera organisationsinställningen medan du uppdaterar uppgiften. Att inaktivera inställningen är inte en långsiktig lösning eftersom Node.js 6, 10 och 16 är schemalagda för borttagning den 24 november 2026.

Tar inställningen bort Node.js 6, 10 eller 16 från mina agenter?

No. Inställningen förhindrar att pipelineaktiviteter väljer dessa löpare så att du kan testa effekten av deras kommande borttagning. Den avinstallerar inte filer från en agent.

Kan jag fortsätta att använda en Node.js löpare som inte stöds?

Att använda en runtime-miljö som har nått slutet av sin livscykel medför säkerhets- och kompatibilitetsrisker, så uppdatera aktiviteten i stället. Tillfälliga alternativ för lokalt installerad agent finns i Så här kör du uppgifter på Node.js versioner som inte stöds.

Påverkar inställningen Azure DevOps Server?

No. Organisationsinställningen är inte tillgänglig i Azure DevOps Server.

Se även

  • Last updated on