Partilhar via

Software do agente versão 4

  • Artigo

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).

Atualize para o agente 4.x em sistemas operacionais suportados

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

Os seguintes sistemas operacionais são suportados pelo agente 4.x.

Observação

Consulte .NET 8 - Versões de SO suportadas para obter a 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
    • Alpino 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
    • SO do servidor
      • Windows Server 2012 ou superior

Atualizar para o agente 4.x em sistemas operacionais não suportados

Se você estiver executando seus agentes auto-hospedados em um sistema operacional que não é suportado pelo .NET 8, você deve atualizar suas máquinas para usar um sistema operacional suportado mais recente suportado pelo .NET 8.

A lista de sistemas operacionais a seguir era suportada para agentes 3.x auto-hospedados, mas não são suportados pelo .NET 8 e não podem ser usados para executar agentes da versão 4.x.

Observação

Consulte .NET 8 - Versões do SO sem suporte para obter a lista completa de sistemas operativos que não suportam o .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
    • Alpino x64
  • macOS
    • x64
      • macOS 10.15 "Catalina"
      • macOS 11.0 "Big Sur"
    • ARM64
      • macOS 11.0 "Big Sur"
  • Windows

Perguntas Frequentes

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

Os agentes 3.x usam .NET 6 e os agentes 4.x usam .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 suportada da seção anterior Atualizar para o agente 4.x em sistemas operacionais suportados.

Você também pode usar um de script para prever se os agentes nos seus pools autogeridos conseguirã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 apenas para os agentes 4.x. No entanto, também temos clientes do Azure DevOps Server que ainda dependerão de agentes 3.x. Assim, analisaremos as questões de segurança caso a caso para decidir.

O que eu preciso fazer quando estou em um sistema operacional não suportado?

Você deve migrar para um sistema operacional mais recente que é suportado pelo .NET 8 agora. Caso contrário, seu agente pode tentar atualizar e ele falhará, pois o .NET 8 não pode ser instalado no seu sistema operacional. Publicaremos algumas orientações num post no blog de seguimento que impedirá as atualizações automáticas do agente. No entanto, isso é apenas para ser uma solução temporária para lhe dar mais algum tempo para atualizar as suas máquinas dos agentes.

Posso continuar nos agentes 2.x ou 3.x se não estiver mais a fazer qualquer alteração 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 seu pipeline não dependa explicitamente desse recurso. Quando você impede atualizações automáticas do agente usando as orientações 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á.

Tenho que instalar o .NET 8 antes de instalar o software do agente 4.x?

Não é necessário instalar o .NET 8 na máquina do agente antes de instalar e configurar o software do agente 4.x. Todas as dependências do .NET que o agente 4.x requer fazem parte do próprio agente.

Tenho que 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 é independente na instalação do agente e não é usada para criar seu 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?

No momento, as versões atuais do Azure DevOps Server ainda usam o software do agente 3.x, portanto, não há impacto imediato.

A equipe de pipelines recomenda que você atualize suas máquinas de agente para sistemas operacionais mais recentes que são suportados pelo .NET 8 a partir de agora, se você planeja acompanhar as versões do Azure DevOps Server no futuro.

O Servidor de DevOps do Azure suporta o agente 4.x

As versões do Servidor de DevOps do Azure dão suporte à versão do agente implantada com essa versão. Atualmente, as versões mais recentes do Azure DevOps Server suportam as versões de software do agente 3.x. Para mais informações, consulte se o Azure DevOps Server suporta o agente 3.x.

Observação

O Azure DevOps Server 2020 e superior dará suporte ao software do agente 4.x por meio de atualizações. Quando essas atualizações forem lançadas, este artigo será atualizado com a versão do agente correspondente.

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 obter a melhor e mais segura experiência do produto, recomendamos e recomendamos vivamente que todos os clientes utilizem a versão mais recente e mais 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 Azure DevOps Server ou uma nova versão, atualize seus agentes.

Qual é o cronograma para a implantação do agente versão 4?

A versão 4.x do agente foi lançada em outubro de 2024.

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

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