Condividi tramite

Software agente versione 4

Il team delle pipeline sta aggiornando il software agente dalla versione 3.x alla versione 4.x (usando .NET 8).

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

Se si eseguono gli agenti self-hosted nei sistemi operativi più recenti supportati da .NET 8, l'aggiornamento alla nuova versione dell'agente è automatico.

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

I sistemi operativi seguenti sono supportati dall'agente 4.x.

Nota

Vedere .NET 8 - Versioni supportate del sistema operativo per l'elenco completo dei sistemi operativi.

  • 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
    • Alpine 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
    • Sistema operativo server
      • Windows Server 2012 o versione successiva

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

Se si eseguono gli agenti self-hosted in un sistema operativo non supportato da .NET 8, è necessario aggiornare i computer per usare un sistema operativo supportato più recente supportato da .NET 8. Dopo l'aggiornamento, consultare Aggiornare gli agenti su server autonomo per istruzioni su come aggiornare gli agenti alla versione 4.x.

L'elenco seguente dei sistemi operativi era compatibile per gli agenti 3.x self-hosted, ma non sono supportati da .NET 8 e non possono essere utilizzati per eseguire gli agenti 4.x.

Nota

Vedere .NET 8 - Versioni del sistema operativo non supportate per l'elenco completo dei sistemi operativi non supportati per .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
    • Alpine x64
  • macOS
    • x64
      • macOS 10.15 "Catalina"
      • macOS 11.0 "Big Sur"
    • ARM64
      • macOS 11.0 "Big Sur"
  • Windows

Domande frequenti

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

Gli agenti 3.x usano .NET 6 e gli agenti 4.x usano .NET 8.

Come è possibile controllare gli agenti per verificare se possono eseguire l'aggiornamento alla versione 4.x?

Confronta il sistema operativo del tuo agente con l'elenco di sistemi operativi supportati della sezione precedente Aggiornamento a 4.x.

È anche possibile usare uno script per stimare se gli agenti nei pool self-hosted potranno eseguire l'aggiornamento alla versione 4.x.

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

Non ci saranno patch eseguite, in generale, per le versioni precedenti del software agente. Le patch verranno eseguite solo per gli agenti 4.x. Tuttavia, abbiamo anche clienti di Azure DevOps Server che si affidano ancora agli agenti 3.x. Verranno quindi esaminati i problemi di sicurezza in base al caso per decidere.

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

È consigliabile eseguire la migrazione a un sistema operativo più recente supportato da .NET 8. In caso contrario, l'agente potrebbe tentare di eseguire l'aggiornamento e avrà esito negativo perché .NET 8 non può essere installato nel sistema operativo. Verranno pubblicate alcune indicazioni in un post di blog di completamento che impedirà l'aggiornamento automatico dell'agente. Tuttavia, questo è pensato solo per essere una soluzione temporanea per dare un po' più di tempo per aggiornare le macchine degli agenti.

Posso rimanere su agenti 2.x o 3.x se non sto più lavorando ad alcuna modifica del progetto?

No Il team delle pipeline aggiunge regolarmente nuove funzionalità ad Azure Pipelines e alcuni di essi possono richiedere un aggiornamento all'agente anche se la pipeline non dipende in modo esplicito da tale funzionalità. Quando si impedisce l'aggiornamento automatico dell'agente utilizzando le indicazioni contenute in un blog di follow-up, quell'agente non può essere utilizzato per pianificare la pipeline. Se non è possibile trovare alcun agente con le funzionalità necessarie, l'esecuzione della pipeline avrà esito negativo.

È necessario installare .NET 8 prima di installare il software dell'agente 4.x?

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

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

La versione di .NET usata per eseguire l'agente 4.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.

Uso Azure DevOps Server e non Azure DevOps Services. Questa modifica mi riguarda?

In questo momento, le versioni correnti di Azure DevOps Server usano ancora il software agente 3.x, quindi non c'è alcun impatto immediato.

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

Azure DevOps Server supporta l’agente 4.x?

Le versioni di Azure DevOps Server supportano la versione dell'agente distribuito con tale versione. Attualmente, le versioni più recenti di Azure DevOps Server supportano le versioni del software dell'agente 3.x. Per ulteriori informazioni, vedere Il server di Azure DevOps supporta l'agente 3.x.

Nota

Azure DevOps Server 2020 e versioni successive supporterà il software dell'agente 4.x tramite gli aggiornamenti. Quando questi aggiornamenti vengono rilasciati, questo articolo verrà aggiornato con la versione corrispondente dell'agente.

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, è consigliabile e consigliare a tutti i clienti di usare la versione più recente e sicura di Azure DevOps Server. Puoi scaricare l'ultima versione del prodotto dalla pagina di download di Azure DevOps Server .

Dopo aver installato un aggiornamento o una nuova versione di Azure DevOps Server, aggiornate i vostri agenti.

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

La versione 4.x dell'agente è stata rilasciata a ottobre 2024.

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

In genere, quando un'attività richiede una versione più recente dell'agente, verrà aggiornata automaticamente. Per il momento, mentre l'agente versione 3 continua a essere aggiornato, abbiamo disabilitato l'aggiornamento automatico dall'agente versione 3 all'agente versione 4. Dopo averla abilitata, per i sistemi operativi che non sono compatibili con l'agente versione 4, l'agente versione 3.248 e successive non tenterà di aggiornarsi all'agente v4. Verrà 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 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