Software do agente versão 4

A equipe de pipelines está atualizando o software do agente da versão 3.x para a versão 4.x (usando o .NET 8).

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

Se você estiver executando seus agentes auto-hospedados em sistemas operacionais mais recentes compatíveis com o .NET 8, a atualização para a nova versão do agente será automática.

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

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

• 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
  • Alpino x64
    • Alpine Linux 3.17 a 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequóia"
  • ARM64
    • macOS 13.0 "Ventura"
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequóia"
• Windows
  • Sistema Operacional do cliente
    • Windows 10
      • 21H2, 1809, 1607
    • Windows 11
      • 23H2, 22H2, 21H2
  • Sistema Operacional do servidor
    • Windows Server 2012 ou posterior

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

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

A lista a seguir de sistemas operacionais tinha suporte para agentes 3.x auto-hospedados, mas não tem suporte do .NET 8 e não pode ser usada para executar agentes da versão 4.x.

• 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
  • Alpino x64
    • Alpine Linux 3.13
• macOS
  • x64
    • macOS 10.15 "Catalina"
    • macOS 11.0 "Big Sur"
  • ARM64
    • macOS 11.0 "Big Sur"
• Windows
  • Sistema Operacional do cliente
    • Windows 7 SP1 ESU
    • Windows 8.1
    • Windows 10
      • 21H2 (E)
    • Windows 11
      • 21H2 (E) &22H2 (E)

perguntas frequentes

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

Os agentes 3.x usam o .NET 6 e os agentes 4.x usam o .NET 8.

Como posso verificar meus agentes para ver se eles podem atualizar para 4.x?

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

Você também pode usar um script para prever se os agentes em seus pools auto-hospedados poderão atualizar para 4.x.

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

Não haverá patches feitos, em geral, para as versões anteriores do software do agente. Os patches serão feitos somente para os agentes 4.x. No entanto, também temos clientes do Servidor do Azure DevOps que ainda dependerão de agentes 3.x. Portanto, examinaremos os problemas de segurança caso a caso para decidir.

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

Você deve migrar para um sistema operacional mais recente com suporte do .NET 8 agora. Caso contrário, o agente poderá tentar atualizar e falhará, pois o .NET 8 não pode ser instalado no sistema operacional. Publicaremos algumas diretrizes em uma postagem de acompanhamento no blog que impedirão atualizações automáticas do agente. No entanto, isso é destinado apenas a ser uma solução temporária para dar-lhe mais tempo para atualizar seus computadores de agente.

Posso continuar utilizando agentes 2.x ou 3.x se não fizer mais alterações no meu projeto?

Não. A equipe de pipelines está adicionando regularmente novos recursos ao Azure Pipelines e alguns deles podem exigir uma atualização para o agente, mesmo que o pipeline não dependa explicitamente desse recurso. Quando você impede atualizações automáticas do agente usando 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 8 antes de instalar o software do agente 4.x?

Você não precisa instalar o .NET 8 no computador do agente antes de instalar e configurar o software do agente 4.x. Todas as dependências do .NET necessárias pelo agente 4.x fazem parte do próprio agente.

Preciso criar meu código usando o .NET 8 se estiver usando o agente 4.x?

A versão do .NET usada para executar o agente 4.x é autocontida 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 e as versões anteriores usam o software do agente 3.x.

A equipe de pipelines recomenda que você atualize seus computadores de agente para sistemas operacionais mais recentes compatíveis com o .NET 8 a partir de agora, se você planeja acompanhar as versões do Servidor do Azure DevOps no futuro.

O Azure DevOps Server dá suporte ao agente 4.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 e as versões anteriores usam o software do agente 3.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, recomendamos e recomendamos que todos os clientes usem 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 4?

O agent versão 4.x foi lançado em outubro de 2024.

O que acontecerá quando uma tarefa exigir que um agente seja atualizado para o agente versão 4?

Normalmente, quando uma tarefa requer uma versão mais recente do agente, ela se atualizará automaticamente. Por enquanto, enquanto o agente versão 3 continua a ser atualizado, desabilitamos a atualização automática do agente versão 3 para o agente versão 4. Depois de habilitá-lo, para sistemas operacionais que não são compatíveis com o agente versão 4, o agente versão 3.248 e mais recente não tentarão se atualizar para o agente v4. Em vez disso, um aviso será 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 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