Software do agente versão 5

A equipe de pipelines está atualizando o software do agente da versão 4.x para a versão 5.x (usando .NET 10). É altamente recomendável atualizar seus agentes para a versão 5.x.

Atualizar para o agente 5.x em sistemas operacionais com suporte

Se você estiver executando agentes auto-hospedados em sistemas operacionais mais recentes compatíveis com .NET 10, a atualização para a nova versão do agente será automática se qualquer recurso ou tarefas exigir uma versão mais recente do software do agente.

Para iniciar manualmente a atualização, consulte Atualizar agentes auto-hospedados.

Os sistemas operacionais a seguir têm suporte do agente 5.x.

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

Atualizar para o agente 5.x em sistemas operacionais sem suporte

Se você estiver executando seus agentes auto-hospedados em um sistema operacional que não dá suporte ao .NET 10, você deverá atualizar seus computadores para usar um sistema operacional mais recente com suporte pelo .NET 10. Após a atualização, consulte Atualizar agentes auto-hospedados para obter instruções sobre como atualizar seus agentes para a versão 5.x.

Os sistemas operacionais a seguir dão suporte a agentes 4.x auto-hospedados, mas não são compatíveis com .NET 10 e não podem ser usados para executar agentes da versão 5.x.

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

perguntas frequentes

Qual é a diferença entre os agentes 4.x e 5.x?

Os agentes 4.x usam .NET 8 e os agentes 5.x usam .NET 10.

Como posso verificar se meus agentes podem atualizar para 5.x?

Compare o sistema operacional do seu agente com a lista de sistemas operacionais suportados da seção anterior Atualizar para o agente 5.x em sistemas operacionais suportados.

Você também pode usar um script para prever se os agentes em seus pools auto-hospedados podem atualizar para 5.x.

Como os problemas de segurança no agente serão corrigidos daqui para frente?

Em geral, as versões anteriores do software do agente não recebem patches. Somente os agentes 5.x obtêm patches. No entanto, alguns clientes Azure DevOps Server ainda dependem de agentes 4.x. Portanto, a equipe do produto revisa os problemas de segurança caso a caso para decidir.

O que preciso fazer quando estou em um sistema operacional sem suporte?

Migrar para um sistema operacional mais recente que .NET 10 dá suporte. Caso contrário, o agente poderá tentar se atualizar, mas a atualização falhará, pois não é possível instalar o .NET 10 no seu sistema operacional. A equipe do produto publicará algumas orientações em um post posterior no blog para impedir atualizações automáticas do agente. No entanto, essa orientação destina-se apenas a ser uma solução temporária para dar-lhe mais tempo para atualizar seus computadores de agente.

Posso continuar usando os agentes 3.x ou 4.x se eu não estiver mais fazendo alterações no meu projeto?

Não. A equipe de pipelines adiciona regularmente novos recursos a Azure Pipelines e alguns desses recursos podem exigir uma atualização para o agente, mesmo que seu pipeline não dependa explicitamente desse recurso. Quando você impede atualizações automáticas do agente ao usar as diretrizes em um blog de acompanhamento, esse agente não pode ser usado para agendar o pipeline. Se nenhum agente com os recursos necessários puder ser encontrado, a execução do pipeline falhará.

Preciso instalar o .NET 10 antes de instalar o software do agente 5.x?

Você não precisa instalar .NET 10 no computador do agente antes de instalar e configurar o software do agente 5.x. Todas as dependências .NET que o agente 5.x requer fazem parte do próprio agente.

Preciso criar meu código usando .NET 10 se estiver usando o agente 5.x?

A versão do .NET usada para executar o agente 5.x é independente na instalação do agente e não é usada para criar seu código. A versão do .NET usada para criar seu código depende do pipeline e da versão ou das versões do .NET instaladas no computador do agente.

Uso o Servidor do Azure DevOps e não o Azure DevOps Services. Esta alteração me afeta?

A versão mais recente do Azure DevOps Server usa o software do agente 4.x.

A equipe de pipelines recomenda que você atualize desde já as máquinas do agente para sistemas operacionais mais recentes compatíveis com o .NET 10, caso pretenda acompanhar as futuras versões do Azure DevOps Server.

O Azure DevOps Server dá suporte ao agente 5.x?

As versões do Servidor do Azure DevOps dão suporte à versão do agente implantada com essa versão. A versão mais recente do Azure DevOps Server usa o software do agente 4.x.

O Servidor do Azure DevOps é atendido por meio de patches de segurança ou manutenção que fornecem correções de bug cumulativas direcionadas para recursos existentes no produto. Para obter a melhor e mais segura experiência do produto, use a versão mais recente e segura do Azure DevOps Server. Você pode baixar a versão mais recente do produto na página de download do Azure DevOps Server.

Depois de instalar uma atualização do Servidor do Azure DevOps ou uma nova versão, atualize seus agentes.

Qual é a linha do tempo para a implantação do agente versão 5?

O Agent versão 5.x será lançado em 2026.

O que acontece quando uma tarefa exige que um agente seja atualizado para o agente versão 5?

Normalmente, quando uma tarefa requer uma versão mais recente do agente, o agente se atualiza automaticamente. Por enquanto, enquanto o agente versão 4 continua a ser atualizado, a atualização automática do agente versão 4 para o agente versão 5 está desabilitada. Depois de habilitado, para sistemas operacionais que não são compatíveis com o agente versão 5, o agente versão 4.x não tenta se atualizar para o agente v5. Em vez disso, um aviso é mostrado informando aos usuários que eles precisam atualizar o sistema operacional primeiro: 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