Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O agente do Azure Pipelines é fornecido com várias versões de bibliotecas de Node.js para dar suporte a tarefas de destino que podem usar diferentes manipuladores de Node.js.
Warning
Node.js 6, 10 e 16 chegaram ao fim da vida útil e serão removidos do agente em 24 de novembro de 2026. O agente de Azure Pipelines já inclui Node.js 24. Os autores de tarefas personalizadas e de extensão devem atualizar suas tarefas com Node.js 24 para evitar qualquer impacto nos Pipelines que usam essas tarefas.
suporte à versão Node.js
A tabela a seguir lista as versões Node.js com suporte no Azure Pipelines, juntamente com suas datas de fim de suporte e datas de remoção.
| versão do Node.js | Fim do suporte no Azure Pipelines | Data de remoção no Azure Pipelines |
|---|---|---|
| 24 | 1 de abril de 2028 | Outubro de 20281 |
| 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 Agente do Azure Pipelines. A data de fim do suporte baseia-se no agendamento oficial de suporte doNode.js.
- Data de remoção no Azure Pipelines – quando a data de remoção for atingida, a versão do Node.js será removida das novas versões do agente e as tarefas que exigem essas versões Node.js poderão não ser executadas. A data de remoção sempre será de pelo menos seis meses após a data de fim do suporte.
Os pipelines emitem avisos para informar os usuários sobre as próximas datas de fim de suporte ou remoção.
A partir do Node.js 24, o agente Azure Pipelines inclui apenas versões alternativas de LTS (suporte de longo prazo) de Node.js.
1As datas de fim do suporte e remoção do Node.js 24 se alinham ao agendamento oficial de suporte doNode.js a partir de novembro de 2025. Essas datas estão sujeitas a alterações com base em anúncios futuros da equipe de Node.js.
Data de remoção para Node.js 6, 10 e 16
Node.js 6, 10 e 16 não têm suporte em pipelines desde suas respectivas datas de fim de suporte. Pipelines com tarefas que dependem dessas versões do Node.js atualmente geram avisos quando são executados. Para dar tempo suficiente para migrar suas tarefas personalizadas para uma versão de Node.js com suporte, estendemos a data de remoção para 24 de novembro de 2026.
Para obter informações sobre como atualizar e testar suas tarefas personalizadas para a versão atual do Node.js, consulte Como posso atualizar minha tarefa para a versão mais recente do Node.js.
Teste as tarefas antes que os executores do Node.js em fim de vida sejam removidos
Use a configuração no nível da organização Restringir versões sem suporte do Node.js em tarefas de pipeline para avaliar como a remoção do Node.js 6, 10 e 16 do agente afeta seus pipelines. A configuração é desabilitada por padrão. Ao habilitá-lo, as tarefas afetadas são executadas com um executor de Node.js mais recente disponível em vez de seu executor de fim de vida declarado.
Essa configuração ajuda você a identificar e atualizar os pipelines afetados antes que Node.js 6, 10 e 16 sejam removidos do agente em 24 de novembro de 2026. Isso não remove os runners do agente.
Pré-requisitos para esse recurso
Você precisa do Agent versão 4.278.0 ou posterior para a configuração anterior.
Ativar a configuração
Vá para Configurações da organizaçãoPipelines>>.
Em Restrições de tarefa, habilite Restringir versões sem suporte do Node.js em tarefas de pipeline.
Execute seus pipelines e examine os logs em busca de avisos sobre tarefas que dependem de versões do Node.js que chegaram ao fim da vida útil.
Comportamento quando a configuração está habilitada
Para cada tarefa que declara um manipulador de execução Node.js 6, 10 ou 16, o agente:
- Impede que a tarefa use seu respectivo executor de fim de vida Node.js declarado.
- Seleciona um executor mais recente disponível, preferindo Node.js 24 e Node.js 20.
- Registra um aviso que identifica a tarefa afetada e explica que ela pode falhar ou se comportar inesperadamente.
- Executa a tarefa com o executor selecionado ou falha na tarefa se nenhum executor mais recente compatível estiver disponível.
A configuração se aplica a agentes Microsoft hospedados e auto-hospedados e a tarefas executadas no host do agente ou em um contêiner.
Importante
Executar uma tarefa com uma versão de Node.js mais recente não torna a tarefa compatível com essa versão. Teste os pipelines afetados e atualize as tarefas personalizadas para usar um executor de Node.js atual. Para obter diretrizes de migração, consulte Como posso atualizar minha tarefa para a versão mais recente do Node.js.
Como executar tarefas em versões de Node.js sem suporte
Para manter a compatibilidade com versões anteriores para tarefas personalizadas usando uma versão Node.js que não tem mais suporte ou foi removida, oferecemos essas opções de autoatendimento para que você possa instalar o executor de Node.js necessário:
Instale manualmente o executor de Node.js desejado. Para obter mais informações, consulte o suporte ao executor de Node.js.
Utilize a tarefa
NodeTaskRunnerInstaller@0em seus pipelines que requerem uma biblioteca Node.js desatualizada.Instale um pacote de agente que inclua as bibliotecas de Node.js desejadas.
O Azure Pipelines fornece duas versões de pacotes de agente:
-
vsts-agent-\: pacotes que dão suporte a bibliotecas Node.js 6 e Node.js 10. -
pipelines-agent-\: pacotes que não dão suporte a bibliotecas Node.js 6 e Node.js 10. No futuro, essa 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 tarefas personalizadas e de extensão devem atualizar e testar 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 no computador do agente, você poderá instalar o agente nesta documentação, em Downloads de Agente Alternativo.
-
perguntas frequentes
O que acontece com tarefas que usam Node.js 6, 10 ou 16 quando eu habilitar a configuração?
O agente bloqueia o executor de fim de vida declarado da tarefa e tenta executar a tarefa com o Node.js 24 ou com o Node.js 20 se o Node.js 24 não estiver disponível nem utilizável. O log de pipeline identifica a tarefa afetada e exibe um aviso. Se nenhum executor utilizável mais recente estiver disponível, a tarefa falhará.
Scripts e aplicativos que usam Node.js não são afetados apenas porque usam Node.js. A configuração se aplica ao manipulador de execução Node.js declarado por uma tarefa Azure Pipelines.
Por que meu pipeline começou a falhar depois que eu habilitei a configuração?
O Pipeline pode estar usando tarefas que não são compatíveis com o Node.js executor mais recente. Analise o aviso da tarefa e o erro no log do pipeline para identificar a tarefa afetada.
- Para uma tarefa interna, atualize o pipeline para usar a versão principal mais recente da tarefa.
- Para uma tarefa do Marketplace, verifique se há uma versão atualizada ou entre em contato com o editor de extensão.
- Para uma tarefa personalizada, atualize seu manipulador de execução e dependências para uma versão atual do Node.js. Para obter mais informações, consulte Como posso atualizar minha tarefa para a versão mais recente do Node.js.
- Para um agente auto-hospedado, verifique se a versão do Agente é atualizada para a v 4.278.0 ou posterior.
Até que os runners em fim de vida sejam removidos, você pode desativar temporariamente a configuração da organização enquanto atualiza a tarefa. Desabilitar a configuração não é uma solução de longo prazo porque Node.js 6, 10 e 16 estão programados para remoção em 24 de novembro de 2026.
A configuração remove Node.js 6, 10 ou 16 dos meus agentes?
No. A configuração impede que as tarefas de pipeline selecionem esses executores para que você possa testar o efeito de sua próxima remoção. Ele não desinstala os arquivos de um agente.
Posso continuar a usar um corredor de Node.js sem suporte?
Manter um runtime de fim de vida tem riscos de segurança e compatibilidade, portanto, atualize a tarefa. Para obter opções temporárias de agente auto-hospedado, consulte Como executar tarefas em versões de Node.js sem suporte.
A configuração afeta Azure DevOps Server?
No. A configuração da organização não está disponível no Azure DevOps Server.