Software agente versione 5

Il team delle pipeline sta aggiornando il software agente dalla versione 4.x alla versione 5.x (usando .NET 10). È consigliabile aggiornare gli agenti alla versione 5.x.

Eseguire l'aggiornamento all'agente 5.x nei sistemi operativi supportati

Se si eseguono agenti self-hosted in sistemi operativi più recenti supportati da .NET 10, l'aggiornamento alla nuova versione dell'agente è automatico se una funzionalità o attività richiede una versione più recente del software agente.

Per avviare manualmente l'aggiornamento, vedere Update self-hosted agents.

I sistemi operativi seguenti sono supportati dall'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
  • Alpine 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 client
      • Windows 10
        • 21H2, 1809
      • Windows 11
        • 26H1, 25H2, 24H2
    • Sistema operativo server
      • Windows Server 2025, 2022, 2019, 2016, 2012 R2, 2012
  • ARM64 (anteprima pubblica)
    • Sistema operativo client
      • Windows 11
        • 26H1, 25H2, 24H2

Eseguire l'aggiornamento all'agente 5.x nei sistemi operativi non supportati

Se esegui gli agenti self-hosted su un sistema operativo che non supporta .NET 10, devi aggiornare le macchine per usare un sistema operativo supportato più recente supportato da .NET 10. Dopo l'aggiornamento, consulta Aggiornare gli agenti self-hosted per istruzioni su come aggiornare i tuoi agenti alla versione 5.x.

I sistemi operativi seguenti supportano agenti 4.x self-hosted, ma non sono supportati da .NET 10 e non possono essere usati per eseguire gli agenti versione 5.x.

• Linux
  • x64
    • Fedora 39 e 40
    • openSUSE 15.5 e 15.6
    • SUSE Enterprise Linux 15.5
  • Alpine x64
    • Alpine Linux da 3.17 a 3.20
• macOS
  • x64
    • macOS 13.0 "Ventura"
  • ARM64
    • macOS 13.0 "Ventura"
• Windows
  • Sistema operativo client
    • Windows 10
      • 1607
    • Windows 11
      • 23H2, 22H2, 21H2

FAQ

Qual è la differenza tra gli agenti 4.x e 5.x?

Gli agenti 4.x usano .NET 8 e gli agenti 5.x usano .NET 10.

Come è possibile verificare se gli agenti possono eseguire l'aggiornamento a 5.x?

Confrontare il sistema operativo dell'agente con l'elenco dei sistemi operativi supportati nella precedente sezione Aggiornamento dell'agente 5.x sui sistemi operativi supportati.

È anche possibile usare uno script per stimare se gli agenti nei pool self-hosted possono eseguire l'aggiornamento a 5.x.

In che modo i problemi di sicurezza nell'agente verranno corretti in futuro?

In generale, le versioni precedenti del software agente non ricevono patch. Solo gli agenti 5.x ottengono patch. Tuttavia, alcuni Azure DevOps Server clienti si affidano ancora agli agenti 4.x. Il team del prodotto esamina quindi i problemi di sicurezza caso per caso per decidere.

Cosa è necessario fare quando si usa un sistema operativo non supportato?

Eseguire la migrazione a un sistema operativo più recente supportato .NET 10. In caso contrario, l'agente potrebbe tentare di eseguire l'aggiornamento e ha esito negativo perché non è possibile installare .NET 10 nel sistema operativo. Il team del prodotto pubblicherà alcune indicazioni in un post di blog di completamento che impedisce l'aggiornamento automatico dell'agente. Tuttavia, tale indicazione è intesa solo come soluzione temporanea per darvi più tempo per aggiornare i computer con l'agente installato.

Posso continuare a usare gli agenti 3.x o 4.x se non sto più apportando modifiche al mio progetto?

No. Il team delle pipeline aggiunge regolarmente nuove funzionalità a Azure Pipelines e alcune di queste funzionalità potrebbero richiedere un aggiornamento all'agente anche se la pipeline non dipende in modo esplicito da tale funzionalità. Se si impediscono gli aggiornamenti automatici dell'agente seguendo le indicazioni fornite in un articolo di blog successivo, tale agente non può essere utilizzato per pianificare la pipeline. Se non è possibile trovare alcun agente con le funzionalità necessarie, l'esecuzione della pipeline ha esito negativo.

È necessario installare .NET 10 prima di installare il software dell'agente 5.x?

Non è necessario installare .NET 10 nel computer agente prima di installare e configurare il software agente 5.x. Tutte le dipendenze .NET richieste dall'agente 5.x fanno parte dell'agente stesso.

È necessario compilare il codice usando .NET 10 se si usa l'agente 5.x?

La versione di .NET usata per eseguire l'agente 5.x è autonoma nell'installazione dell'agente e non viene usata per compilare il codice. La versione di .NET usata per compilare il codice dipende dalla pipeline e dalla versione o dalle versioni di .NET installate nel computer agente.

Io uso Azure DevOps Server e non Azure DevOps Services. Questa modifica influisce su di me?

La versione più recente di Azure DevOps Server usa il software agente 4.x.

Il team delle pipeline consiglia di aggiornare i computer agente ai sistemi operativi più recenti supportati .NET 10 a partire da ora, se si prevede di mantenere il passo con le versioni Azure DevOps Server in futuro.

Azure DevOps Server supporta l'agente 5.x?

Le versioni di Azure DevOps Server supportano la versione dell'agente distribuito con tale versione. La versione più recente di Azure DevOps Server usa il software agente 4.x.

Azure DevOps Server viene fornito tramite patch di sicurezza o manutenzione che forniscono correzioni di bug cumulativi mirate per le funzionalità esistenti nel prodotto. Per un'esperienza di prodotto ottimale e sicura, usare la versione più recente e sicura di Azure DevOps Server. È possibile scaricare la versione più recente del prodotto dalla pagina di download Azure DevOps Server.

Dopo aver installato un aggiornamento di Azure DevOps Server o una nuova versione, aggiornare gli agenti.

Qual è la sequenza temporale per la distribuzione dell'agente versione 5?

La versione 5.x dell'agente viene rilasciata nel 2026.

Cosa accade quando un'attività richiede l'aggiornamento di un agente alla versione 5 dell'agente?

In genere, quando un'attività richiede una versione più recente dell'agente, l'agente si aggiorna automaticamente. Per il momento, finché la versione 4 dell'agente continua a essere aggiornata, l'aggiornamento automatico dalla versione 4 dell'agente alla versione 5 è disattivato. Dopo l'abilitazione, per i sistemi operativi che non sono compatibili con l'agente versione 5, la versione dell'agente 4.x non tenta di aggiornarsi all'agente v5. Viene invece visualizzato un avviso che informa gli utenti che devono aggiornare prima il 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