Software agente versão 5

A equipa de pipelines está a atualizar o software do agente da versão 4.x para a versão 5.x (usando .NET 10). Recomendamos vivamente que atualizemos os seus agentes para a versão 5.x.

Atualizar para o agente 5.x em sistemas operativos suportados

Se estiver a executar agentes auto-hospedados em sistemas operativos mais recentes suportados pelo .NET 10, a atualização para a nova versão do agente é automática se alguma funcionalidade ou tarefa exigir uma versão mais recente do software do agente.

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

Os seguintes sistemas operativos são suportados pelo 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 "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
    • SO do servidor
      • Windows Server 2025, 2022, 2019, 2016, 2012 R2, 2012
  • ARM64
    • Sistema Operativo Cliente
      • Windows 11
        • 26H1, 25H2, 24H2, 23H2

Atualizar para agente 5.x em sistemas operativos não suportados

Se estiver a executar os seus agentes auto-hospedados num sistema operativo que não suporta .NET 10, deve atualizar as suas máquinas para usar um sistema operativo suportado mais recente suportado pelo .NET 10. Após atualizar, consulte Atualizar agentes auto-hospedados para instruções sobre como atualizar os seus agentes para a versão 5.x.

Os seguintes sistemas operativos suportam agentes 4.x auto-hospedados, mas não são suportados pelo .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 Operativo Cliente
    • Windows 11
      • 22H2, 21H2

FAQ

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 os meus agentes conseguem atualizar para a versão 5.x?

Compare o sistema operativo do seu agente com a lista de sistemas operativos suportados indicada na secção anterior Atualizar para o agente 5.x em sistemas operativos suportados.

Também pode usar um script para prever se os agentes nos seus pools auto-hospedados podem atualizar para a versão 5.x.

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

Em geral, versões anteriores do software agente não recebem patches. Só os agentes 5.x recebem patches. No entanto, alguns clientes do Azure DevOps Server ainda dependem de agentes 4.x. Assim, a equipa de produto analisa as questões de segurança caso a caso para decidir.

O que preciso de fazer quando estou num sistema operativo não suportado?

Migrar para um sistema operativo mais recente que o .NET 10 suporte. Caso contrário, o seu agente pode tentar atualizar, mas falha porque o .NET 10 não pode ser instalado no seu sistema operativo. A equipa do produto publicará algumas orientações num artigo subsequente no blogue para impedir atualizações automáticas do agente. No entanto, essa orientação serve apenas como uma solução temporária para te dar mais tempo para atualizares as tuas máquinas de agentes.

Posso continuar nos agentes 3.x ou 4.x se já não estiver a trabalhar em nenhuma alteração no meu projeto?

Não. A equipa de pipelines adiciona regularmente novas funcionalidades ao Azure Pipelines, e algumas dessas funcionalidades podem exigir uma atualização do agente, mesmo que o seu pipeline não dependa explicitamente dessa funcionalidade. Quando impede as atualizações automáticas do agente seguindo as orientações num artigo de blogue subsequente, esse agente não pode ser usado para programar o pipeline. Se não for encontrado nenhum agente com as capacidades necessárias, a execução do pipeline falha.

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

Não precisas de instalar o .NET 10 na tua máquina agente antes de instalar e configurar o software agente 5.x. Todas as dependências .NET que o agente 5.x requer fazem parte do próprio agente.

Tenho de compilar o meu código usando .NET 10 se estiver a usar o agente 5.x?

A versão do .NET usada para correr o agente 5.x é autónoma na instalação do agente e não é usada para construir o teu código. A versão do .NET que é usada para criar seu código depende do pipeline e da versão ou versões do .NET que você instalou na máquina do agente.

Eu uso o Servidor de DevOps do Azure e não os Serviços de DevOps do Azure. Essa mudança me impacta?

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

A equipa de pipelines recomenda que atualize as suas máquinas agentes para sistemas operativos mais recentes que o .NET 10 suporta a partir de agora, se planeia acompanhar as versões do Azure DevOps Server no futuro.

O Azure DevOps Server suporta o agente 5.x?

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

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

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

Qual é o cronograma para a implementação da versão 5 do agente?

A versão do agente 5.x será lançada em 2026.

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

Normalmente, quando uma tarefa requer uma versão mais recente do agente, o agente atualiza-se automaticamente. Por agora, enquanto a versão 4 do agente continua a ser atualizada, a atualização automática da versão 4 para a versão 5 do agente está desativada. Uma vez ativado, para sistemas operativos que não são compatíveis com a versão 5 do agente, a versão 4.x do agente não tenta atualizar-se para o agente v5. Em vez disso, é mostrado um aviso informando os utilizadores de que precisam primeiro de atualizar o sistema operativo: 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