Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El agente de Azure Pipelines se incluye con varias versiones de bibliotecas de Node.js para dar soporte a tareas específicas que pueden usar diferentes manejadores de Node.js.
Warning
Node.js 6, 10 y 16 han llegado al final de su vida útil y se eliminarán del agente el 24 de noviembre de 2026. El agente de Azure Pipelines ya incluye Node.js 24. Los autores de tareas de extensión y personalizados deben actualizar sus tareas con Node.js 24 para evitar cualquier impacto en las canalizaciones que usan estas tareas.
compatibilidad con versiones de Node.js
En la tabla siguiente se enumeran las versiones de Node.js que se admiten en Azure Pipelines, junto con sus fechas de finalización de soporte técnico y fechas de eliminación.
| versión de Node.js | Finalización del soporte técnico en Azure Pipelines | Fecha de eliminación en Azure Pipelines |
|---|---|---|
| 24 | 1 de abril de 2028 | Octubre de 20281 |
| 20 | Abril de 2026 | Abril de 2027 |
| 16 | Septiembre de 2021 | 24 de noviembre de 2026 |
| 10 | Abril de 2021 | 24 de noviembre de 2026 |
| 6 | Abril de 2019 | 24 de noviembre de 2026 |
- Fin del soporte técnico en Azure Pipelines : cuando se alcanza la fecha de finalización del soporte técnico, la versión de Node.js no se actualizará en el agente de Azure Pipelines. La fecha de finalización del soporte técnico se basa en la programación oficial de soporte técnicoNode.js.
- Fecha de eliminación en Azure Pipelines : cuando se alcanza la fecha de eliminación, la versión de Node.js se quitará de las nuevas versiones del agente y las tareas que requieren estas versiones de Node.js pueden no ejecutarse. La fecha de eliminación siempre será al menos seis meses después de la fecha de finalización del soporte técnico.
Las canalizaciones emiten advertencias para informar a los usuarios de las próximas fechas de finalización del soporte o retirada.
A partir de Node.js 24, el agente de Azure Pipelines solo incluye versiones alternativas de soporte técnico a largo plazo (LTS) de Node.js.
1Las fechas de fin de soporte técnico y eliminación de Node.js 24 se alinean con la programación oficial de soporte técnicoNode.js a partir de noviembre de 2025. Estas fechas están sujetas a cambios en función de los anuncios futuros del equipo de Node.js.
Fecha de eliminación de Node.js 6, 10 y 16
Node.js 6, 10 y 16 no se admiten en canalizaciones desde sus fechas de finalización de soporte técnico respectivas. Las canalizaciones con tareas que dependen de estas versiones de Node.js emiten actualmente advertencias cuando se ejecutan. Para proporcionarle tiempo suficiente para migrar las tareas personalizadas a una versión de Node.js compatible, ampliamos la fecha de eliminación hasta el 24 de noviembre de 2026.
Para obtener información sobre cómo actualizar y probar las tareas personalizadas a la versión actual de Node.js, vea How can I upgrade my task to the latest Node.js version.
Pruebe las tareas antes de que se retiren los runners de Node.js al final de su vida útil
Use la configuración Restringir las versiones de Node.js sin soporte técnico en las tareas de canalización a nivel de organización para evaluar cómo afecta a sus canalizaciones la eliminación de Node.js 6, 10 y 16 del agente. La configuración está deshabilitada de forma predeterminada. Al habilitarlo, las tareas afectadas se ejecutan con una versión más reciente disponible del runtime de Node.js en lugar del runtime declarado que ha llegado al fin de su vida útil.
Esta configuración le ayuda a identificar y actualizar las canalizaciones afectadas antes de que se eliminen Node.js 6, 10 y 16 del agente el 24 de noviembre de 2026. No quita los ejecutores del agente.
Requisitos previos para esta característica
Necesita la versión del Agente 4.278.0 o posterior para la configuración anterior.
Habilitar la configuración
Vaya a Configuración de la organización>Canalizaciones>Configuración.
En Restricciones de tareas, habilite Restringir las versiones de Node.js sin soporte en las tareas de canalización.
Ejecute las canalizaciones y revise los registros en busca de advertencias sobre tareas que dependen de versiones de Node.js que han llegado al final de su vida útil.
Comportamiento cuando la configuración está habilitada
Para cada tarea que declara un controlador de ejecución de Node.js 6, 10 o 16, el agente:
- Impide que la tarea utilice su entorno de ejecución de Node.js declarado como obsoleto.
- Selecciona un ejecutor más reciente disponible, con preferencia por Node.js 24 y después por Node.js 20.
- Registra una advertencia que identifica la tarea afectada y explica que podría producir un error o comportarse de forma inesperada.
- Ejecuta la tarea con el ejecutor seleccionado o produce un error en la tarea si no hay ningún ejecutor más reciente compatible disponible.
La configuración se aplica a los agentes hospedados por Microsoft y a los agentes autohospedados, así como a las tareas que se ejecutan en el host del agente o en un contenedor.
Importante
La ejecución de una tarea con una versión de Node.js más reciente no hace que la tarea sea compatible con esa versión. Pruebe las canalizaciones afectadas y actualice las tareas personalizadas para usar un ejecutor de Node.js actual. Para obtener instrucciones de migración, consulte How can I upgrade my task to the latest Node.js version.
Ejecución de tareas en versiones de Node.js no admitidas
Para mantener la compatibilidad con versiones anteriores para tareas personalizadas mediante una versión de Node.js que ya no se admite o se ha quitado, ofrecemos estas opciones de autoservicio para que pueda instalar el ejecutor de Node.js necesario:
Instale manualmente el ejecutor de Node.js deseado. Para obtener más información, consulte compatibilidad del ejecutor de Node.js.
Utilice la tarea
NodeTaskRunnerInstaller@0en sus canalizaciones que requieren una biblioteca obsoleta de Node.js.Instale un paquete de agente que incluya las bibliotecas de Node.js deseadas.
Azure Pipelines proporciona dos versiones de paquetes de agente:
-
vsts-agent-\: paquetes que admiten bibliotecas de Node.js 6 y Node.js 10. -
pipelines-agent-\: paquetes que no admiten Node.js 6 y Node.js 10 bibliotecas. En el futuro, esta versión del paquete se convierte en el paquete de agente predeterminado.
Nota:
El
pipelines-agentpaquete no incluye Node.js 16. Los autores de extensiones y tareas personalizadas deben actualizar y probar sus tareas con Node.js 24.Si las tareas no requieren la biblioteca Node.js 6 o Node.js 10 y no desea instalar la biblioteca de Node.js 6 o Node.js 10 en el equipo del agente, puede instalar el agente desde esta documentación, en Descargas alternativas del agente.
-
FAQ
¿Qué ocurre con las tareas que usan Node.js 6, 10 o 16 cuando se habilita la configuración?
El agente bloquea el ejecutor declarado de fin de vida de la tarea e intenta ejecutar la tarea con Node.js 24 o con Node.js 20 si Node.js 24 no está disponible ni se puede usar. El registro de canalización identifica la tarea afectada y muestra una advertencia. Si no hay ningún ejecutor utilizable más reciente disponible, se produce un error en la tarea.
Los scripts y las aplicaciones que usan Node.js no se ven afectados únicamente porque usan Node.js. La configuración se aplica al controlador de ejecución Node.js declarado por una tarea de Azure Pipelines.
¿Por qué mi canalización comenzó a generar errores después de habilitar la configuración?
La canalización puede usar tareas que no sean compatibles con el ejecutor de Node.js más reciente. Revise la advertencia y el error de la tarea en el registro de la canalización para identificar la tarea afectada.
- Para una tarea integrada, actualice la canalización para usar la versión principal más reciente de la tarea.
- Para una tarea de Marketplace, compruebe si hay una versión actualizada o póngase en contacto con el publicador de extensiones.
- Para una tarea personalizada, actualice su controlador de ejecución y sus dependencias a una versión de Node.js actual. Para obtener más información, consulte ¿Cómo puedo actualizar mi tarea a la versión más reciente de Node.js?.
- Para un agente hospedado de forma local, asegúrese de que la versión del agente esté actualizada a la v4.278.0 o a una versión posterior.
Hasta que se quiten los ejecutores de fin de vida, puede deshabilitar temporalmente la configuración de la organización mientras actualiza la tarea. Deshabilitar la configuración no es una solución a largo plazo porque Node.js 6, 10 y 16 están programadas para su eliminación el 24 de noviembre de 2026.
¿Esta configuración elimina Node.js 6, 10 o 16 de mis agentes?
N.º La configuración impide que las tareas de la canalización seleccionen esos ejecutores, de modo que pueda probar los efectos de su próxima retirada. No desinstala archivos de un agente.
¿Puedo seguir usando un ejecutor de Node.js no admitido?
Mantener un entorno de ejecución que ha llegado al fin de su vida útil conlleva riesgos de seguridad y compatibilidad, así que actualiza la tarea en lugar de eso. Para obtener opciones de agente autohospedado temporales, consulte Ejecución de tareas en versiones de Node.js no admitidas.
¿Afecta la configuración a Azure DevOps Server?
N.º La configuración de la organización no está disponible en Azure DevOps Server.