Versión 5 del software del agente

El equipo de canalizaciones está actualizando el software del agente de la versión 4.x a la versión 5.x (con .NET 10). Se recomienda encarecidamente actualizar los agentes a la versión 5.x.

Actualización al agente 5.x en sistemas operativos compatibles

Si ejecuta agentes autohospedados en sistemas operativos más recientes compatibles con .NET 10, la actualización a la nueva versión del agente es automática si alguna característica o tarea requiere una versión más reciente del software del agente.

Para iniciar manualmente la actualización, consulte Actualización de agentes autohospedados.

El agente 5.x admite los siguientes sistemas operativos.

• Linux
  • x64
    • Debian 13 y 12
    • Fedora 44, 43 y 42
    • openSUSE Leap 16.0
    • Red Hat Enterprise Linux 10, 9 y 8
    • SUSE Enterprise Linux 16.0 y 15.7
    • Ubuntu 25.10, 24.04 y 22.04
    • Azure Linux 3.0
    • CentOS Stream 10 y 9
    • Oracle Linux 9 y 8
  • ARM64
    • Debian 13 y 12
    • Fedora 44, 43 y 42
    • Red Hat Enterprise Linux 10 y 9
    • Ubuntu 25.10, 24.04 y 22.04
  • Alpine x64
    • Alpine Linux 3.23, 3.22, 3.21
• macOS
  • x64
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"
    • macOS 26.0 "Tahoe"
  • ARM64
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"
    • macOS 26.0 "Tahoe"
• Windows
  • x64
    • Sistema operativo cliente
      • Windows 10
        • 21H2, 1809, 1607
      • Windows 11
        • 26H1, 25H2, 24H2, 23H2
    • Sistema operativo del servidor
      • Windows Server 2025, 2022, 2019, 2016, 2012 R2, 2012
  • ARM64
    • Sistema operativo cliente
      • Windows 11
        • 26H1, 25H2, 24H2, 23H2

Actualización al agente 5.x en sistemas operativos no admitidos

Si ejecuta los agentes autohospedados en un sistema operativo que no admite .NET 10, debe actualizar las máquinas para usar un sistema operativo compatible más reciente compatible con .NET 10. Después de actualizar, consulte Actualización de agentes autohospedados para obtener instrucciones sobre cómo actualizar los agentes a la versión 5.x.

Los siguientes sistemas operativos admiten agentes autohospedados 4.x, pero no son compatibles con .NET 10 y no se pueden usar para ejecutar agentes de la versión 5.x.

• Linux
  • x64
    • Fedora 39 y 40
    • openSUSE 15.5 y 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux 3.17 a 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • Sistema operativo cliente
    • Windows 11
      • 22H2, 21H2

FAQ

¿Cuál es la diferencia entre los agentes 4.x y 5.x?

Los agentes 4.x usan .NET 8 y los agentes 5.x usan .NET 10.

¿Cómo puedo comprobar si mis agentes pueden actualizar a 5.x?

Compare el sistema operativo de su agente con la lista de sistemas operativos compatibles de la sección anterior Actualizar a 5.x el agente en sistemas operativos compatibles.

También puede usar un script para determinar si los agentes de los pools autohospedados pueden actualizarse a la versión 5.x.

¿Cómo se corregirán los problemas de seguridad en el agente en el futuro?

En general, las versiones anteriores del software del agente no reciben revisiones. Solo los agentes de la versión 5.x reciben parches. Sin embargo, algunos clientes Azure DevOps Server siguen confiando en agentes 4.x. Por lo tanto, el equipo de productos revisa los problemas de seguridad por caso para decidir.

¿Qué debo hacer cuando estoy en un sistema operativo no compatible?

Migre a un sistema operativo más reciente que .NET 10 admite. De lo contrario, el agente podría intentar actualizar y se produce un error porque no se puede instalar .NET 10 en el sistema operativo. El equipo de producto publicará algunas orientaciones en una entrada posterior del blog sobre cómo evitar las actualizaciones automáticas del agente. Sin embargo, esa recomendación solo pretende ser una solución temporal para darle más tiempo a actualizar los equipos donde está instalado el agente.

¿Puedo permanecer en agentes de 3.x o 4.x si ya no estoy trabajando en ningún cambio en mi proyecto?

N.º El equipo de canalizaciones agrega periódicamente nuevas características a Azure Pipelines y algunas de esas características pueden requerir una actualización al agente aunque la canalización no dependa explícitamente de esa característica. Si impide las actualizaciones automáticas del agente siguiendo las indicaciones de una entrada posterior del blog, ese agente no se puede usar para programar la canalización. Si no se encuentra ningún agente con las funcionalidades necesarias, se produce un error en la ejecución de la canalización.

¿Tengo que instalar .NET 10 antes de instalar el software del agente 5.x?

No es necesario instalar .NET 10 en el equipo del agente antes de instalar y configurar el software del agente 5.x. Todas las .NET dependencias que requiere el agente 5.x forman parte del propio agente.

¿Tengo que compilar mi código con .NET 10 si uso el agente 5.x?

La versión de .NET usada para ejecutar el agente 5.x está independiente en la instalación del agente y no se usa para compilar el código. La versión de .NET que se usa para compilar el código depende de la canalización y de la versión o versiones de .NET que ha instalado en el equipo del agente.

Uso Azure DevOps Server y no Azure DevOps Services. ¿Este cambio me afecta?

La versión más reciente de Azure DevOps Server usa el software del agente 4.x.

El equipo de pipelines recomienda que actualice las máquinas de agente a sistemas operativos más recientes compatibles con .NET 10 a partir de ahora, si tiene previsto mantenerse al día con las futuras versiones de Azure DevOps Server.

¿Azure DevOps Server admite el agente 5.x?

Las versiones de Azure DevOps Server admiten la versión del agente que se implementa con esa versión. La versión más reciente de Azure DevOps Server usa el software del agente 4.x.

Azure DevOps Server se atiende a través de revisiones de seguridad o mantenimiento que proporcionan correcciones de errores acumulativas dirigidas para las características existentes del producto. Para obtener la mejor y la experiencia de producto más segura, use la versión más reciente y segura de Azure DevOps Server. Puede descargar la versión más reciente del producto desde la página de descarga de Azure DevOps Server.

Después de instalar una actualización de Azure DevOps Server o una nueva versión, actualiza tus agentes.

¿Cuál es la escala de tiempo para la implementación del agente versión 5?

La versión 5.x del agente se publica en 2026.

¿Qué ocurre cuando una tarea requiere que un agente se actualice a la versión 5 del agente?

Normalmente, cuando una tarea requiere una versión más reciente del agente, el agente se actualiza automáticamente. Por ahora, mientras la versión 4 del agente sigue recibiendo actualizaciones, se ha deshabilitado la actualización automática del agente de la versión 4 a la versión 5. Una vez habilitado, para los sistemas operativos que no son compatibles con la versión 5 del agente, la versión 4.x del agente no intenta actualizarse al agente v5. En su lugar, se muestra una advertencia que informa a los usuarios de que necesitan actualizar el sistema operativo en primer lugar: The operating system the agent is running on is <OS>, which will not be supported by the .NET 10 based v5 agent. Please upgrade the operating system of this host to ensure compatibility with the v5 agent. See https://aka.ms/azdo-pipeline-agent-version