agenty uruchamiające Node.js w Azure Pipelines

Agent usługi Azure Pipelines jest dostarczany z kilkoma wersjami bibliotek Node.js do obsługi zadań docelowych, które mogą używać różnych programów obsługi Node.js.

Warning

Node.js 6, 10 i 16 mają koniec życia i zostaną usunięte z agenta 24 listopada 2026 r. Agent Azure Pipelines zawiera już Node.js 24. Autorzy zadań rozszerzeń i niestandardowych powinni aktualizować swoje zadania przy użyciu Node.js 24 , aby uniknąć wpływu na potoki korzystające z tych zadań.

Obsługa wersji Node.js

W poniższej tabeli wymieniono wersje Node.js obsługiwane w usłudze Azure Pipelines wraz z datami zakończenia wsparcia i datami usunięcia.

wersja Node.js Koniec wsparcia w usłudze Azure Pipelines Data usunięcia w usłudze Azure Pipelines
24 Kwiecień 20281 Październik 20281
20 Kwiecień 2026 r. Kwiecień 2027 r.
16 Wrzesień 2021 24 listopada 2026 r.
10 Kwiecień 2021 24 listopada 2026 r.
6 kwiecień 2019 24 listopada 2026 r.
  • Zakończenie wsparcia w usłudze Azure Pipelines — po osiągnięciu daty zakończenia wsparcia wersja Node.js nie zostanie zaktualizowana w agencie usługi Azure Pipelines. Data zakończenia pomocy technicznej jest oparta na oficjalnym harmonogramie pomocy technicznejNode.js.
  • Data usunięcia w usłudze Azure Pipelines — po osiągnięciu daty usunięcia wersja Node.js zostanie usunięta z nowych wersji agentów, a zadania wymagające tych Node.js wersji mogą zakończyć się niepowodzeniem. Data usunięcia będzie zawsze przypadać co najmniej sześć miesięcy po dacie zakończenia wsparcia.

Potoki wyświetlają ostrzeżenia, aby poinformować użytkowników o nadchodzących terminach zakończenia wsparcia lub usunięcia.

Począwszy od Node.js 24, agent Azure Pipelines obejmuje tylko alternatywne wersje długoterminowego wsparcia (LTS) Node.js.

1Daty zakończenia wsparcia i usunięcia Node.js 24 są zgodne z oficjalnym harmonogramem wsparciaNode.js od listopada 2025 r. Daty te mogą ulec zmianie w oparciu o przyszłe ogłoszenia od zespołu Node.js.

Data usunięcia Node.js 6, 10 i 16

Node.js 6, 10 i 16 nie są już obsługiwane w potokach od odpowiednich dat zakończenia ich wsparcia. Potoki z zadaniami zależnymi od tych wersji Node.js obecnie emitują ostrzeżenia po uruchomieniu. Aby zapewnić wystarczająco dużo czasu na migrację zadań niestandardowych do obsługiwanej wersji Node.js, rozszerzyliśmy datę usunięcia do 24 listopada 2026 r.

Aby uzyskać informacje na temat aktualizowania i testowania zadań niestandardowych w bieżącej wersji Node.js, zobacz Jak mogę uaktualnić zadanie do najnowszej wersji Node.js.

Przetestuj zadania przed usunięciem środowisk uruchomieniowych Node.js wycofanych z użycia

Użyj ustawienia na poziomie organizacji Ogranicz wersje Node.js bez wsparcia w zadaniach potoku, aby ocenić, jak usunięcie Node.js 6, 10 i 16 z agenta wpływa na Twoje potoki. Ustawienie jest domyślnie wyłączone. Po włączeniu tej opcji zadania, których to dotyczy, są uruchamiane przy użyciu nowszego dostępnego środowiska uruchomieniowego Node.js zamiast zadeklarowanego środowiska uruchomieniowego Node.js, dla którego zakończono wsparcie.

To ustawienie ułatwia identyfikowanie i aktualizowanie potoków, których dotyczy ten wpływ przed Node.js 6, 10 i 16, zostaną usunięte z agenta 24 listopada 2026 r. Nie usuwa runnerów z agenta.

Wymagania wstępne dotyczące tej funkcji

Dla poprzedniego ustawienia potrzebujesz agenta w wersji 4.278.0 lub nowszej.

Włącz ustawienie

  1. Przejdź do Ustawień organizacji>Potoki>.

  2. W sekcji Ograniczenia zadań włącz opcję Ogranicz nieobsługiwane wersje Node.js w zadaniach potoku.

    Zrzut ekranu przedstawiający ustawienie włączone, aby ograniczyć nieobsługiwane wersje środowiska Node.js w zadaniach potoku.

  3. Uruchom potoki i przejrzyj dzienniki pod kątem ostrzeżeń dotyczących zadań, które zależą od wersji Node.js, których okres wsparcia dobiegł końca.

Zachowanie po włączeniu ustawienia

Dla każdego zadania deklarującego program obsługi wykonywania Node.js 6, 10 lub 16 agent:

  1. Zapobiega używaniu zadeklarowanego dla zadania wycofanego środowiska uruchomieniowego Node.js.
  2. Wybiera nowsze dostępne środowisko uruchomieniowe, z preferencją dla Node.js 24, a następnie Node.js 20.
  3. Rejestruje ostrzeżenie identyfikujące zadanie, którego dotyczy problem, i wyjaśnia, że może zakończyć się niepowodzeniem lub nieoczekiwanie zachowywać się.
  4. Uruchamia zadanie przy użyciu wybranego programu uruchamiającego lub powoduje niepowodzenie zadania, jeśli nie jest dostępny nowszy, zgodny program uruchamiający.

To ustawienie dotyczy agentów hostowanych przez Microsoft i agentów hostowanych samodzielnie oraz zadań uruchamianych na hoście agenta lub w kontenerze.

Important

Uruchomienie zadania z nowszą wersją Node.js nie powoduje, że zadanie jest zgodne z tą wersją. Przetestuj potoki, których dotyczy problem, i zaktualizuj zadania niestandardowe, aby używać bieżącego modułu uruchamiającego Node.js. Aby uzyskać wskazówki dotyczące migracji, zobacz Jak mogę uaktualnić zadanie do najnowszej wersji Node.js.

Jak uruchamiać zadania w nieobsługiwanych wersjach Node.js

Aby zachować zgodność z poprzednimi wersjami dla zadań niestandardowych przy użyciu wersji Node.js, która nie jest już obsługiwana lub została usunięta, oferujemy te opcje samoobsługi, aby można było zainstalować wymagany moduł uruchamiający Node.js:

  • Ręcznie zainstaluj żądany moduł uruchamiający Node.js. Aby uzyskać więcej informacji, zobacz obsługa modułu uruchamiającegoNode.js.

  • Użyj zadania NodeTaskRunnerInstaller@0 w potokach, które wymagają przestarzałej biblioteki Node.js.

  • Zainstaluj pakiet agenta zawierający żądane biblioteki Node.js.

    Usługa Azure Pipelines udostępnia dwie wersje pakietów agentów:

    • vsts-agent-\: pakiety obsługujące biblioteki Node.js 6 i Node.js 10.
    • pipelines-agent-\: pakiety, które nie obsługują bibliotek Node.js 6 i Node.js 10. W przyszłości ta wersja pakietu stanie się domyślnym pakietem agenta.

    Uwaga / Notatka

    Pakiet pipelines-agent nie zawiera Node.js 16. Autorzy rozszerzeń i niestandardowych zadań powinni aktualizować i testować swoje zadania przy użyciu Node.js 24.

    Jeśli zadania nie wymagają biblioteki Node.js 6 lub Node.js 10 i nie chcesz instalować biblioteki Node.js 6 lub Node.js 10 na maszynie agenta, możesz zainstalować agenta z tej dokumentacji w obszarze Pliki do pobrania alternatywnego agenta.

Często zadawane pytania

Co się stanie z zadaniami używającymi Node.js 6, 10 lub 16 po włączeniu ustawienia?

Agent blokuje zadeklarowany moduł uruchomieniowy zadania, którego cykl życia dobiegł końca, i próbuje uruchomić zadanie przy użyciu Node.js 24 albo Node.js 20, jeśli Node.js 24 nie jest dostępny lub nie można go użyć. Dziennik potoku identyfikuje zadanie, którego dotyczy problem, i wyświetla ostrzeżenie. Jeśli nie jest dostępny nowszy runner nadający się do użycia, zadanie zakończy się błędem.

Skrypty i aplikacje korzystające z Node.js nie są dotknięte tym problemem wyłącznie z tego powodu, że używają Node.js. To ustawienie dotyczy modułu obsługi uruchamiania Node.js zadeklarowanego przez zadanie Azure Pipelines.

Dlaczego mój potok zaczął kończyć się niepowodzeniem po włączeniu tego ustawienia?

Potok może używać zadań, które nie są zgodne z nowszym modułem uruchamiającym Node.js. Przejrzyj ostrzeżenie i błąd dotyczące zadania w dzienniku potoku, aby zidentyfikować zadanie, którego dotyczy problem.

  • W przypadku wbudowanego zadania zaktualizuj potok, aby używał najnowszej wersji głównej zadania.
  • W przypadku zadania w witrynie Marketplace sprawdź, czy jest dostępna nowsza wersja, lub skontaktuj się z wydawcą rozszerzenia.
  • W przypadku zadania niestandardowego zaktualizuj procedurę obsługi wykonywania i zależności do bieżącej wersji Node.js. Aby uzyskać więcej informacji, zobacz How can I upgrade my task to the latest Node.js version (Jak mogę uaktualnić zadanie do najnowszej wersji Node.js).
  • W przypadku własnego agenta upewnij się, że wersja agenta została zaktualizowana do wersji 4.278.0 lub nowszej.

Dopóki wycofane z użytku runnery nie zostaną usunięte, można tymczasowo wyłączyć ustawienie organizacyjne na czas aktualizacji zadania. Wyłączenie tego ustawienia nie jest rozwiązaniem długoterminowym, ponieważ Node.js 6, 10 i 16 mają zostać usunięte 24 listopada 2026 r.

Czy ustawienie usuwa Node.js 6, 10 lub 16 z moich agentów?

No. To ustawienie uniemożliwia zadaniom potoku wybieranie tych runnerów, dzięki czemu można przetestować skutki ich planowanego usunięcia. Nie powoduje odinstalowania plików z agenta.

Czy mogę nadal używać nieobsługiwanego modułu uruchamiającego Node.js?

Utrzymywanie środowiska uruchomieniowego końca życia ma zagrożenia związane z zabezpieczeniami i zgodnością, dlatego zaktualizuj zadanie zamiast tego. Aby zapoznać się z tymczasowymi opcjami własnego agenta, zobacz How to run tasks on unsupported Node.js versions (Jak uruchamiać zadania w nieobsługiwanych wersjach Node.js).

Czy ustawienie ma wpływ na Azure DevOps Server?

No. Ustawienie organizacji nie jest dostępne w Azure DevOps Server.

Informacje dodatkowe

  • Last updated on