Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O agente Azure Pipelines vem com várias versões de bibliotecas de Node.js para suportar tarefas-alvo que podem usar diferentes tratadores de Node.js.
Warning
Node.js 6, 10 e 16 estão no fim da vida útil e serão removidos do agente a 24 de novembro de 2026. O agente Azure Pipelines já inclui Node.js 24. Os autores de extensões e tarefas personalizadas devem atualizar as suas tarefas com Node.js 24 para evitar qualquer impacto nos Pipelines que utilizam estas tarefas.
Suporte de versões do Node.js
A tabela seguinte lista as Node.js versões suportadas no Azure Pipelines, juntamente com as suas datas de fim de suporte e datas de remoção.
| Versão do Node.js | Fim do suporte em Azure Pipelines | Data de remoção em Azure Pipelines |
|---|---|---|
| 24 | Abril 20281 | 1 de outubro de 2028 |
| 20 | Abril de 2026 | Abril de 2027 |
| 16 | Setembro de 2021 | 24 de novembro de 2026 |
| 10 | Abril de 2021 | 24 de novembro de 2026 |
| 6 | Abril de 2019 | 24 de novembro de 2026 |
- Fim do suporte no Azure Pipelines - quando a data de fim do suporte for atingida, a versão Node.js não será atualizada no Azure Pipelines Agent. A data de fim do suporte baseia-se no calendário oficial de suporteNode.js.
- Data de remoção no Azure Pipelines - quando a data de remoção é atingida, a versão Node.js será removida das novas versões do agente, e as tarefas que requerem estas versões Node.js podem falhar em ser executadas. A data de remoção será sempre pelo menos seis meses após o fim da pensão de alimentos.
Os oleodutos emitem avisos para informar os utilizadores sobre datas próximas de fim de suporte ou remoção.
A partir do Node.js 24, o agente do Azure Pipelines inclui apenas versões LTS (suporte de longo prazo) alternadas do Node.js.
1As datas de fim do suporte e de remoção do Node.js 24 estão alinhadas com o calendário oficial de suporte do Node.js à data de novembro de 2025. Estas datas podem ser alteradas consoante futuros anúncios da equipa Node.js.
Data de remoção para Node.js 6, 10 e 16
Node.js 6, 10 e 16 têm estado sem suporte nos pipelines desde as respetivas datas de fim de suporte. As pipelines com tarefas que dependem destas versões do Node.js emitem atualmente avisos quando são executadas. Para lhe dar tempo suficiente para migrar as suas tarefas personalizadas para uma versão Node.js suportada, estendemos a data de remoção para 24 de novembro de 2026.
Para informações sobre como atualizar e testar as suas tarefas personalizadas para a versão atual do Node.js, veja Como posso atualizar a minha tarefa para a versão mais recente Node.js.
Teste as tarefas antes de os executores do Node.js em fim de vida serem removidos
Utilize a definição ao nível da organização Restringir versões do Node.js sem suporte em tarefas de pipeline para avaliar como a remoção do Node.js 6, 10 e 16 do agente afeta os seus pipelines. A definição está desativada por padrão. Quando o ativar, as tarefas afetadas são executadas com uma versão de execução do Node.js mais recente disponível, em vez da versão de execução declarada em fim de vida.
Esta definição ajuda-o a identificar e atualizar pipelines afetados antes de Node.js 6, 10 e 16 serem removidos do agente a 24 de novembro de 2026. Não remove os corredores do agente.
Pré-requisitos para esta funcionalidade
Precisas da versão do Agente 4.278.0 ou posterior para a configuração anterior.
Ativar a configuração
Vá a Definições da organização>Pipelines>Definições.
Em Restrições de tarefas, ative Restringir versões do Node.js sem suporte em tarefas de pipeline.
Execute os seus pipelines e reveja os registos à procura de avisos sobre tarefas que dependem de versões Node.js em fim de vida.
Comportamento quando a configuração está ativada
Para cada tarefa que especifique um processador de execução Node.js 6, 10 ou 16, o agente:
- Impede a tarefa de utilizar o executor Node.js declarado em fim de vida.
- Seleciona um executor disponível mais atual, dando preferência ao Node.js 24 e, depois, ao Node.js 20.
- Regista um aviso que identifica a tarefa afetada e explica que pode falhar ou comportar-se de forma inesperada.
- Executa a tarefa com o runner selecionado, ou falha a tarefa se não houver um runner mais recente compatível disponível.
A definição aplica-se a agentes hospedados e auto-hospedados pela Microsoft e a tarefas que correm no host do agente ou num contentor.
Importante
Executar uma tarefa com uma versão Node.js mais recente não torna a tarefa compatível com essa versão. Teste pipelines afetados e atualize tarefas personalizadas para usar um runner de Node.js atual. Para orientações sobre migração, veja Como posso atualizar a minha tarefa para a versão Node.js mais recente.
Como executar tarefas em versões Node.js não suportadas
Para manter a compatibilidade retroativa para tarefas personalizadas usando uma versão do Node.js que já não é suportada ou foi removida, oferecemos estas opções de autoatendimento para que possa instalar o Node.js runner necessário.
Instale manualmente o Node.js desejado. Para obter mais informações, consulte suporte para runner Node.js.
Utilize uma
NodeTaskRunnerInstaller@0tarefa que requer uma biblioteca de Node.js desatualizada nos seus pipelines.Instala um pacote de agentes que inclua as bibliotecas de Node.js desejadas.
O Azure Pipelines fornece duas versões de pacotes de agente:
-
vsts-agent-\: Pacotes que suportam bibliotecas Node.js 6 e Node.js 10. -
pipelines-agent-\: Pacotes que não suportam bibliotecas Node.js 6 e Node.js 10. No futuro, esta versão do pacote se tornará o pacote de agente padrão.
Observação
O
pipelines-agentpacote não inclui Node.js 16. Os autores de extensões e tarefas personalizadas devem atualizar e testar as suas tarefas com Node.js 24.Se suas tarefas não exigirem a biblioteca Node.js 6 ou Node.js 10 e você não quiser instalar a biblioteca Node.js 6 ou Node.js 10 na máquina do agente, poderá instalar o agente a partir desta documentação, em Downloads de agentes alternativos.
-
FAQ
O que acontece às tarefas que consomem Node.js 6, 10 ou 16 quando ativo a definição?
O agente bloqueia o runner declarado no fim de vida da tarefa e tenta executá-la com Node.js 24, ou com Node.js 20 se Node.js 24 não estiver disponível ou utilizável. O registo do pipeline identifica a tarefa afetada e apresenta um aviso. Se não houver um runner utilizável mais recente disponível, a tarefa falha.
Scripts e aplicações que usam Node.js não são afetados apenas porque usam Node.js. A definição aplica-se ao handler de execução Node.js declarado por uma tarefa Azure Pipelines.
Porque é que o meu pipeline começou a falhar depois de ativar a definição?
O Pipeline pode estar a usar tarefas(ões) que não são compatíveis com o mais recente Node.js runner. Verifique o aviso e o erro da tarefa no registo do pipeline para identificar a tarefa afetada.
- Para uma tarefa integrada, atualize o pipeline para usar a versão principal mais recente da tarefa.
- Para uma tarefa no Marketplace, verifique se existe uma versão atualizada ou contacte o editor da extensão.
- Para uma tarefa personalizada, atualize o seu gestor de execução e as dependências para uma versão Node.js atual. Para mais informações, veja Como posso atualizar a minha tarefa para a versão mais recente Node.js.
- Para um agente auto-hospedado, certifique-se de que a versão do Agente está atualizada para a v 4.278.0 ou posterior.
Até que os runners em fim de vida sejam removidos, pode desativar temporariamente a definição da organização enquanto atualiza a tarefa. Desativar a definição não é uma solução a longo prazo porque Node.js 6, 10 e 16 estão agendados para remoção a 24 de novembro de 2026.
A configuração remove o Node.js 6, 10 ou 16 nos meus agentes?
Não. A configuração impede que as tarefas do pipeline selecionem esses runners, permitindo testar o efeito da sua futura remoção. Não desinstala ficheiros de um agente.
Posso continuar a usar um corredor de Node.js sem suporte?
Manter um runtime de fim de vida traz riscos de segurança e compatibilidade, por isso atualize a tarefa em vez disso. Para opções temporárias de agente auto-hospedado, veja Como executar tarefas em versões Node.js não suportadas.
A definição afeta o Azure DevOps Server?
Não. A definição de organização não está disponível no Azure DevOps Server.