Compartir a través de

Versión 4 del software del agente

  • Artículo

El equipo de canalizaciones está actualizando el software del agente de la versión 3.x a la versión 4.x (con .NET 8).

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

Si ejecuta los agentes autohospedados en sistemas operativos más recientes compatibles con .NET 8, la actualización a la nueva versión del agente es automática.

El agente 4.x admite los siguientes sistemas operativos.

Nota

Consulte .NET 8: versiones de sistema operativo compatibles para obtener la lista completa de sistemas operativos.

  • Linux
    • x64
      • Debian 12
      • Fedora 39 & 40
      • openSUSE 15.5 & 15.6
      • Red Hat Enterprise Linux 8 & 9
      • SUSE Enterprise Linux 15.5
      • Ubuntu 24.04, 22.04, 20.04
      • Azure Linux 2.0
      • Oracle Linux 8 & 9
    • ARM64
      • Debian 11 & 12
      • Ubuntu 24.04, 22.04, 20.04
    • Alpine x64
  • macOS
    • x64
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
      • macOS 15.0 "Sequoia"
    • ARM64
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
      • macOS 15.0 "Sequoia"
  • Windows
    • Windows 10
      • 21H2, 1809, 1607
    • Windows 11
      • 23H2, 22H2, 21H2
    • Sistema operativo del servidor
      • Windows Server 2012 o superior

Actualización al agente 4.x en sistemas operativos no compatibles

Si ejecuta los agentes autohospedados en un sistema operativo que no es compatible con .NET 8, debe actualizar las máquinas para usar un sistema operativo compatible más reciente compatible con .NET 8.

La siguiente lista de sistemas operativos se admitieron para agentes autohospedados de 3.x, pero no son compatibles con .NET 8 y no se pueden usar para ejecutar agentes de la versión 4.x.

Nota

Consulte .NET 8 - versiones de sistemas operativos que no tienen soporte para obtener la lista completa de sistemas operativos que no tienen soporte para .NET 8.

  • Linux
    • x64
      • Debian 10 & 11
      • Fedora 36
      • openSUSE 15
      • Red Hat Enterprise Linux 7
      • SUSE Enterprise Linux 12 SP2
      • Ubuntu 18.04, 16.04
      • Oracle Linux 7
    • ARM64
      • Debian 10 & 11
      • Ubuntu 18.04
    • Alpine x64
  • macOS
    • x64
      • macOS 10.15 "Catalina"
      • macOS 11.0 "Big Sur"
    • ARM64
      • macOS 11.0 "Big Sur"
  • Windows

Preguntas más frecuentes

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

Los agentes 3.x usan .NET 6 y los agentes 4.x usan .NET 8.

¿Cómo puedo comprobar mis agentes para ver si pueden actualizar a la versión 4.x?

Compare el sistema operativo del agente con la lista de compatibilidad de la sección Actualización al agente 4.x en sistemas operativos compatibles.

También puede usar un script para predecir si los agentes de los grupos autohospedados pueden actualizar a 4.x.

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

En general, no se realizarán parches para las versiones anteriores del software del agente. Los parches solo se realizarán para los agentes 4.x. Sin embargo, también tenemos clientes de Azure DevOps Server que seguirán confiando en agentes de 3.x. Por lo tanto, revisaremos los problemas de seguridad en un caso por caso para decidir.

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

Ahora debe migrar a un sistema operativo más reciente compatible con .NET 8. De lo contrario, el agente puede intentar actualizar y se producirá un error, ya que .NET 8 no se puede instalar en el sistema operativo. Publicaremos algunas instrucciones en una entrada de blog de seguimiento que impedirá las actualizaciones automáticas del agente. Sin embargo, eso solo está pensado para ser la solución temporal para proporcionarle más tiempo para actualizar las máquinas de sus agentes.

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

No. El equipo de canalizaciones agrega periódicamente nuevas características a Azure Pipelines y algunas de ellas pueden requerir una actualización del agente aunque la canalización no dependa explícitamente de esa característica. Al evitar actualizaciones automáticas del agente mediante las instrucciones de un blog de seguimiento, ese agente no se puede usar para programar la canalización. Si no se encuentra ningún agente con las funcionalidades necesarias, se producirá un error en la ejecución de la canalización.

¿Tengo que instalar .NET 8 antes de instalar el software del agente 4.x?

No tiene que instalar .NET 8 en el equipo del agente antes de instalar y configurar el software del agente 4.x. Todas las dependencias de .NET que requiere el agente 4.x forman parte del propio agente.

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

La versión de .NET que se usa para ejecutar el agente 4.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?

En este momento, las versiones actuales de Azure DevOps Server siguen usando el software del agente 3.x, por lo que no hay ningún impacto inmediato.

El equipo de canalizaciones recomienda actualizar las máquinas del agente a sistemas operativos más recientes compatibles con .NET 8 a partir de ahora, si planea mantenerse al día con las versiones de Azure DevOps Server en el futuro.

¿Admite Azure DevOps Server el agente 4.x?

Las versiones de Azure DevOps Server admiten la versión del agente que se implementa con esa versión. Actualmente, las versiones más recientes de Azure DevOps Server admiten las versiones de software del agente 3.x. Para más información, consulte ¿Admite Azure DevOps Server el agente 3.x.

Nota

Azure DevOps Server 2020 y versiones posteriores admitirán el software del agente 4.x a través de actualizaciones. Cuando se publiquen esas actualizaciones, este artículo se actualizará con la versión del agente correspondiente.

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, recomendamos encarecidamente que todos los clientes usen la versión más reciente y segura de Azure DevOps Server. Puede descargar la versión más reciente del producto en 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 4?

La versión 4.x del agente se publicó en octubre de 2024.

¿Qué ocurrirá cuando una tarea requiere que un agente se actualice a la versión 4 del agente?

Normalmente, cuando una tarea requiere una versión más reciente del agente, se actualizará automáticamente. Por ahora, mientras que la versión 3 del agente sigue actualizándose, hemos deshabilitado la actualización automática de la versión 3 del agente a la versión 4 del agente. Una vez que lo habilitemos, para sistemas operativos que no sean compatibles con la versión 4 del agente, la versión del agente 3.248 y versiones posteriores no intentarán actualizarse al agente v4. En su lugar, se mostrará 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 8 based v4 agent. Please upgrade the operating system of this host to ensure compatibility with the v4 agent. See https://aka.ms/azdo-pipeline-agent-version