Software agenta verze 3

Článek
09/26/2024

Tým kanálů upgraduje software agenta z verze 2.x (pomocí .NET Core 3.1) na verzi 3.x (pomocí .NET 6). Nová verze agenta podporuje nový hardware Apple Silicon a novější operační systémy, jako je Ubuntu 22.04 nebo Windows v ARM64.

Poznámka:

Tato funkce je dostupná od Azure DevOps Serveru 2022.1.

Upgrade na agenta 3.x v podporovaných operačních systémech

Pokud používáte agenty v místním prostředí v novějších operačních systémech podporovaných platformou .NET 6, upgrade na novou verzi agenta je automatický.

Agent 3.x podporuje následující operační systémy.

Linux
- x64
  - Debian 10+
  - Fedora 36 a novější
  - openSUSE 15+
  - Red Hat Enterprise Linux 7+
    - Už nepotřebujete samostatný balíček.
  - SUSE Enterprise Linux 12 SP2 nebo novější
  - Ubuntu 22.04, 20.04, 18.04, 16.04
  - Azure Linux 2.0
  - Oracle Linux 7 a novější
- ARM64
  - Debian 10+
  - Ubuntu 22.04, 20.04, 18.04
- Alpine x64
  - Alpine Linux 3.13 a vyšší (vyžaduje agenta 3.227 nebo vyšší)
macOS
- x64
  - macOS 10.15 "Catalina"
  - macOS 11.0 "Big Sur"
  - macOS 12.0 "Monterey"
  - macOS 13.0 "Ventura"
  - macOS 14.0 "Sonoma"
- ARM64
  - macOS 11.0 "Big Sur"
  - macOS 12.0 "Monterey"
  - macOS 13.0 "Ventura"
  - macOS 14.0 "Sonoma"
Windows
- Klientský operační systém
  - Windows 7 SP1 ESU
  - Windows 8.1
  - Windows 10
  - Windows 11
- Serverový operační systém
  - Windows Server 2012 nebo novější

Upgrade na agenta 3.x v nepodporovaných operačních systémech

Pokud používáte agenty v místním prostředí v operačním systému, který rozhraní .NET 6 nepodporuje, musíte počítače aktualizovat tak, aby používaly novější podporovaný operační systém podporovaný platformou .NET 6.

Následující seznam operačních systémů se běžně používá pro agenty 2.x v místním prostředí. Tyto operační systémy nepodporují .NET 6 a nejde je použít ke spuštění nového agenta .NET 6 verze 3.x.

Systém/distribuce	Verze nepodporovaná rozhraním .NET 6
Debian	<= 4,9
Fedora	<= 32
RedHat Enterprise Linux	<= 6
Ubuntu	< 18.04 LTS
macOS	< 10.15

Pomocí skriptu můžete předpovědět, jestli bude možné agenty v místních fondech upgradovat z verze 2.x na verzi 3.x.

Při pokusu o spuštění kanálů v agentu verze 2.218 (nebo 2.214 v RHEL 6) kanály spuštěné v některém z nepodporovaných operačních systémů zde selžou s následující chybovou zprávou: This operating system will stop receiving updates of the Pipelines Agent in the future. To be able to continue to run pipelines please upgrade the operating system or set an environment variable or agent knob "AGENT_ACKNOWLEDGE_NO_UPDATES" to "true". See https://aka.ms/azdo-pipeline-agent-v2-eos for more information.

Pokud chcete tuto chybu vyřešit, můžete:

Upgradujte nebo přesuňte počítače agenta do některého z podporovaných operačních systémů uvedených dříve v tomto článku. Toto je upřednostňované řešení a umožňuje získat budoucí aktualizace agentů.
Nastavte proměnnou AGENT_ACKNOWLEDGE_NO_UPDATES agenta nastavením proměnné prostředí nebo proměnné kanálu.

Můžete nastavit AGENT_ACKNOWLEDGE_NO_UPDATES tak, že v agentu nakonfigurujete proměnnou prostředí, například v /etc/environment nebo etc/profile.d: AGENT_ACKNOWLEDGE_NO_UPDATES=true.

Můžete nastavit proměnnou kanálu.

jobs:
- job: 'agentWithVariables'
  displayName: 'Agent with variables'

  variables:
    AGENT_ACKNOWLEDGE_NO_UPDATES: 'true' # Required to not fail job on operating system that is not supported by .NET 6

Často kladené dotazy

Jaký je rozdíl mezi agenty 2.x a 3.x?

Agenti 2.x (například 2.212) jsou .NET Core 3.1 a agenti 3.x (například 3.212) jsou .NET 6. Během fáze I a II jsou obě verze k dispozici s verzemi 3.x v předběžné verzi.

Jak můžu zkontrolovat agenty a zjistit, jestli můžou upgradovat na verzi 3.x?

Pomocí skriptu můžete předpovědět, jestli se agenti ve fondech v místním prostředí budou moct upgradovat z verze 2.x na 3.x.

Jak budou problémy se zabezpečením v agentu opraveny?

Když bude agent .NET 6 obecně dostupný pro fondy v místním prostředí v Q1 2023, nebudou obecně provedeny žádné opravy pro agenty 2.x. Opravy budou provedeny pouze pro agenty verze 3.x. Máme ale také zákazníky Azure DevOps Serveru, kteří budou stále spoléhat na agenty 2.x. Proto se podíváme na problémy se zabezpečením podle případu, abychom se mohli rozhodnout.

Co je potřeba udělat, když jsem na nepodporovaném operačním systému?

Měli byste migrovat do novějšího operačního systému, který teď podporuje .NET 6. Jinak se váš agent může pokusit o upgrade a selže, protože v operačním systému nejde nainstalovat .NET 6. Některé pokyny publikujeme v následném blogovém příspěvku, který zabrání automatickým upgradům agenta. To je ale jen dočasné řešení, které vám poskytne další čas na upgrade počítačů agenta.

Můžu zůstat na agentech 2.x, pokud už nepracuji na žádných změnách v projektu?

Ne. Tým kanálů pravidelně přidává nové funkce do Služby Azure Pipelines a některé z nich můžou vyžadovat aktualizaci agenta, i když váš kanál explicitně nezávisí na této funkci. Pokud zabráníte automatickým upgradům agenta pomocí pokynů v následném blogu, tento agent se nedá použít k naplánování kanálu. Pokud nenajdete žádného agenta s požadovanými možnostmi, spuštění kanálu selže.

Musím před instalací softwaru agenta 3.x nainstalovat .NET 6?

Před instalací a konfigurací softwaru agenta 3.x nemusíte na počítač agenta instalovat .NET 6. Všechny závislosti rozhraní .NET, které agent 3.x vyžaduje, jsou součástí samotného agenta.

Musím vytvořit kód pomocí .NET 6, pokud používám agenta 3.x?

Verze rozhraní .NET použitá ke spuštění agenta 3.x je samostatná v instalaci agenta a nepoužívá se k sestavení kódu. Verze rozhraní .NET, která se používá k sestavení kódu, závisí na kanálu a verzi nebo verzích rozhraní .NET, které jste nainstalovali na počítač agenta.

Používám Azure DevOps Server, nikoli Azure DevOps Services. Má tato změna vliv na mě?

Ano, pokud používáte některou z verzí Azure DevOps Serveru uvedenou v následující části.

Tým kanálů doporučuje aktualizovat počítače agenta na novější operační systémy podporované platformou .NET 6, pokud plánujete držet krok s verzemi Azure DevOps Serveru v budoucnu.

Podporuje Azure DevOps Server agenta 3.x.

Verze Azure DevOps Serveru podporují verzi agenta nasazeného s danou verzí. Následující tabulka uvádí každou podporovanou verzi Azure DevOps Serveru a její podporovanou verzi agenta.

Verze Azure DevOps Serveru	Verze agenta
Azure DevOps Server 2022.2	3.238.0
Azure DevOps Server 2020.1.2	3.225.0
Azure DevOps Server 2019.1.2	3.225.0

Azure DevOps Server se obsluhuje prostřednictvím oprav zabezpečení nebo údržby, které poskytují cílené kumulativní opravy chyb pro stávající funkce v produktu. V zájmu co nejlepšího a nejbezpečnějšího prostředí produktů důrazně doporučujeme a doporučujeme, aby všichni zákazníci používali nejnovější a nejbezpečnější verzi Azure DevOps Serveru. Nejnovější verzi produktu si můžete stáhnout ze stránky pro stažení Azure DevOps Serveru.

Po instalaci aktualizace Azure DevOps Serveru nebo nové verze aktualizujte agenty.

Následující tabulka uvádí verze Azure DevOps Serveru, které nejprve obsahovaly verzi agenta 3.x.

Jaká je časová osa nasazení agenta verze 3?

Agent verze 3 byl vydán 2023. března 2023.

Co se stane, když úloha vyžaduje aktualizaci agenta na verzi 3 agenta?

Obvykle platí, že pokud úloha vyžaduje novější verzi agenta, automaticky se aktualizuje. Zatímco se agent verze 2 stále aktualizuje, zakázali jsme automatickou aktualizaci z agenta verze 2 na verzi 3. Jakmile ho povolíme, pro operační systémy, které nejsou kompatibilní s agentem verze 3, agent verze 2.217 a novější se nepokouší aktualizovat sám na agenta verze 3. Místo toho se uživatelům zobrazí upozornění, že musí nejprve upgradovat operační systém: The operating system the agent is running on is <OS>, which will not be supported by the .NET 6 based v3 agent. Please upgrade the operating system of this host to ensure compatibility with the v3 agent. See https://aka.ms/azdo-pipeline-agent-version

Sdílet prostřednictvím