Megosztás a következőn keresztül:

Ügynökszoftver 3-as verziója

  • Cikk

A folyamatok csapata az ügynökszoftvert a 2.x verzióról (a .NET Core 3.1 használatával) a 3.x verzióra frissíti (a .NET 6 használatával). Az új ügynökverzió támogatja az új Apple szilíciumhardvereket és újabb operációs rendszereket, például az Ubuntu 22.04-et vagy az ARM64-es Windowst.

Feljegyzés

Ez a funkció az Azure DevOps Server 2022.1-től érhető el.

Frissítés 3.x-ügynökre a támogatott operációs rendszereken

Ha a .NET 6 által támogatott újabb operációs rendszereken futtatja a saját üzemeltetésű ügynökeit, az új ügynökverzióra való frissítés automatikus.

A 3.x ügynök az alábbi operációs rendszereket támogatja.

  • Linux
    • x64
      • Debian 10+
      • Fedora 36+
      • openSUSE 15+
      • Red Hat Enterprise Linux 7+
        • Már nincs szükség külön csomagra
      • SUSE Enterprise Linux 12 SP2 vagy újabb
      • Ubuntu 22.04, 20.04, 18.04, 16.04
      • Azure Linux 2.0
      • Oracle Linux 7 és újabb
    • ARM64
      • Debian 10+
      • Ubuntu 22.04, 20.04, 18.04
    • Alpine x64
  • 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"
  • A Windows
    • Ügyfél operációs rendszere
      • Windows 7 SP1 ESU
      • Windows 8.1
      • Windows 10
      • Windows 11
    • Kiszolgáló operációs rendszere
      • Windows Server 2012 vagy újabb

Frissítés 3.x-ügynökre nem támogatott operációs rendszereken

Ha olyan operációs rendszeren futtatja a saját üzemeltetésű ügynökeit, amelyet a .NET 6 nem támogat, frissítenie kell a gépeket a .NET 6 által támogatott újabb támogatott operációs rendszer használatára.

A saját üzemeltetésű 2.x-ügynökökhöz gyakran használt operációs rendszerek alábbi listája. Ezeket az operációs rendszereket a .NET 6 nem támogatja, és nem használható az új .NET 6-alapú 3.x-ügynök futtatására.

Rendszer/disztribúció A .NET 6 által nem támogatott verzió
Debian <= 4,9
Fedora <= 32
RedHat Enterprise Linux <= 6
Ubuntu < 18.04 LTS
macOS < 10.15

Szkripttel előre jelezheti, hogy a saját üzemeltetésű készletek ügynökei képesek-e frissíteni a 2.x-ről 3.x-re.

Amikor az ügynök 2.218-on (vagy az RHEL 6-on a 2.214-es verzión) próbál folyamatokat futtatni, az itt felsorolt egyik nem támogatott operációs rendszeren futó folyamatok a következő hibaüzenettel fognak meghiúsulni: 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.

A hiba elhárításához a következőt teheti:

  1. Frissítse vagy helyezze át ügynökgépeit a cikkben korábban felsorolt támogatott operációs rendszerek egyikére. Ez az előnyben részesített megoldás, és lehetővé teszi az ügynök jövőbeli frissítéseinek lekérését,
  2. Állítson be egy változót AGENT_ACKNOWLEDGE_NO_UPDATES az ügynökön egy környezeti vagy egy folyamatváltozó beállításával.

  • A beállításhoz AGENT_ACKNOWLEDGE_NO_UPDATES konfigurálhat egy környezeti változót az ügynökön, például a /etc/environment vagy a stb/profile.d fájlban: AGENT_ACKNOWLEDGE_NO_UPDATES=true.

  • Beállíthat egy folyamatváltozót.

    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

GYIK

Mi a különbség a 2.x és a 3.x ügynök között?

A 2.x ügynök (például 2.212) a .NET Core 3.1, a 3.x ügynök (például 3.212) pedig .NET 6. Az I. és a II. fázisban mindkét verzió elérhető, a 3.x verzió pedig előzetes verzióban érhető el.

Hogyan ellenőrizhetim az ügynökeimet, hogy frissíthetnek-e 3.x-re?

Szkripttel előre jelezheti, hogy a saját üzemeltetésű készletek ügynökei képesek lesznek-e frissíteni a 2.x-ről 3.x-re.

Hogyan lesznek javítva az ügynök biztonsági problémái?

Amikor a .NET 6 ügynök általánosan elérhetővé válik a saját üzemeltetésű készletek számára 2023 első negyedévében, a 2.x ügynökök esetében általában nem lesznek javítások. A javítások csak a 3.x ügynökök esetében lesznek végrehajtva. Vannak azonban Olyan Azure DevOps Server-ügyfelek is, akik továbbra is 2.x ügynökre támaszkodnak. Ezért eseti alapon áttekintjük a biztonsági problémákat.

Mit kell tennem, ha nem támogatott operációs rendszeren vagyok?

A .NET 6 által támogatott újabb operációs rendszerre kell migrálnia. Ellenkező esetben előfordulhat, hogy az ügynök megpróbál frissíteni, és sikertelen lesz, mivel a .NET 6 nem telepíthető az operációs rendszerre. Egy követési blogbejegyzésben teszünk közzé néhány útmutatást, amely megakadályozza az ügynök automatikus frissítését. Ez azonban csak átmeneti megoldás, amely több időt biztosít az ügynökgépek frissítésére.

Maradhatok 2.x ügynökön, ha már nem dolgozom a projektem módosításain?

Szám A folyamatokért felelős csapat rendszeresen új funkciókat ad hozzá az Azure Pipelineshoz, és néhányukhoz szükség lehet az ügynök frissítésére annak ellenére, hogy a folyamat nem függ kifejezetten az adott funkciótól. Ha egy követési blog útmutatásával megakadályozza az ügynök automatikus frissítését, az ügynök nem használható a folyamat ütemezésére. Ha nem található a szükséges képességekkel rendelkező ügynök, a folyamat végrehajtása sikertelen lesz.

Telepíteni kell a .NET 6-ot a 3.x ügynökszoftver telepítése előtt?

A 3.x ügynökszoftver telepítése és konfigurálása előtt nem kell telepítenie a .NET 6-ot az ügynökgépre. A 3.x ügynök által igényelt .NET-függőségek az ügynök részét képezik.

Létre kell hoznom a kódot a .NET 6 használatával, ha a 3.x ügynököt használom?

A 3.x ügynök futtatásához használt .NET-verzió önálló az ügynök telepítésében, és nem a kód létrehozásához használatos. A kód létrehozásához használt .NET-verzió a folyamattól és a .NET ügynökgépre telepített verziójától vagy verzióitól függ.

Az Azure DevOps Servert használom, nem az Azure DevOps Service-t. Hatással van rám ez a változás?

Igen, ha az Azure DevOps Server alábbi szakaszban felsorolt verzióit használja.

A folyamatokért felelős csapat azt javasolja, hogy frissítse ügynökgépeit a .NET 6 által támogatott újabb operációs rendszerekre, ha a jövőben is lépést szeretne tartani az Azure DevOps Server kiadásaival.

Támogatja az Azure DevOps Server a 3.x ügynököt?

Az Azure DevOps Server-verziók támogatják az adott verzióval üzembe helyezett ügynök verzióját. Az alábbi táblázat felsorolja a támogatott Azure DevOps Server-verziókat és annak támogatott ügynökverzióit.

Az Azure DevOps Server verziója Ügynök verziója
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

Az Azure DevOps Server olyan biztonsági vagy karbantartási javításokkal van kiszolgálva, amelyek célzott kumulatív hibajavításokat biztosítanak a termék meglévő funkcióihoz. A legjobb és legbiztonságosabb termékélmény érdekében határozottan javasoljuk és javasoljuk, hogy minden ügyfél használja az Azure DevOps Server legújabb, legbiztonságosabb kiadását. A termék legújabb verzióját az Azure DevOps Server letöltési oldaláról töltheti le.

Az Azure DevOps Server frissítésének vagy új verziójának telepítése után frissítse az ügynököket.

Az alábbi táblázat az Azure DevOps Server azon verzióit sorolja fel, amelyek először tartalmazzák a 3.x ügynök egyik verzióját.

Mi az idővonal az ügynök 3-es verziójának üzembe helyezéséhez?

Az ügynök 3- es verziója 2023 márciusában jelent meg.

Mi történik, ha egy feladathoz egy ügynök frissítése szükséges a 3. ügynökverzióra?

Általában, ha egy feladathoz az ügynök újabb verziója szükséges, az automatikusan frissül. Egyelőre, amíg az ügynök 2-es verziója továbbra is frissül, letiltottuk az automatikus frissítést a 2. ügynökverzióról a 3. ügynökverzióra. Miután engedélyeztük, a 3. ügynökverzióval nem kompatibilis operációs rendszerek esetében az ügynök 2.217-es és újabb verziója nem próbálja meg frissíteni magát a v3-ügynökre. Ehelyett egy figyelmeztetés jelenik meg, amely tájékoztatja a felhasználókat, hogy először frissíteniük kell az operációs rendszert: 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