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

Az Azure VM Image Builder újdonságai

  • Cikk

A következőkre vonatkozik: ✔️ Linux rendszerű virtuális gépek ✔️ Windows rendszerű virtuális gépek Rugalmas méretezési ✔️ csoportok ✔️ Egységes méretezési csoportok

Ez a cikk az Azure VM Image Builder (AIB) szolgáltatás összes jelentős API-módosítását és funkciófrissítését tartalmazza.

Frissítések

2024. május

Kompatibilitástörő változás: Kis- és nagybetűk érzékenysége

2024. május 21-től az Azure-beli VM Image Builder API 2024-02-01-es és újabb verziója minden mező esetében kényszeríti a kis- és nagybetűk érzékenységét. Ez azt jelenti, hogy az API-kérelmekben szereplő betűk nagybetűsítésének pontosan meg kell egyeznie a várt formátummal.

Fontos

Fontos megjegyzés meglévő Azure Image Builder-felhasználók számára

Ha Ön az Azure VM Image Builder meglévő felhasználója, biztos lehet benne, hogy ez a módosítás nem érinti a meglévő erőforrásokat. Az esetérzékenység érvényesítése csak az újonnan létrehozott erőforrásokra vonatkozik az API 2024-02-01-es és újabb verziójával. A meglévő erőforrások a várt módon fognak működni módosítások nélkül.

Ha a kis- és nagybetűk érzékenységével kapcsolatos problémákat tapasztal, útmutatásért tekintse meg az Azure Image Builder frissített API-dokumentációját.

Korábban az Azure Image Builder API-ja megbocsátóbb volt az eset szempontjából, de a precizitással való előrelépés kulcsfontosságú. API-hívások indításakor győződjön meg arról, hogy a megfelelő nagybetűsítést használja a mezőnevekhez, paraméterekhez és értékekhez. Ha például egy mező neve "vmBoot", akkor a "vmBoot" (nem "VMBoot" vagy "vmboot") értéket kell használnia.

Ha api-kérelmet küld az Azure Image Builder API 2024-02-01-es verziójának, és nem megfelelő esettel vagy ismeretlen mezőkkel, a szolgáltatás elutasítja azt. Hibaüzenet jelenik meg, amely azt jelzi, hogy a kérés érvénytelen. A hiba a következőképpen fog kinézni:

Unmarshalling entity encountered error: unmarshalling type *v2024_02_01.ImageTemplate: struct field Properties: unmarshalling type *v2024_02_01.ImageTemplateProperties: struct field Optimize: unmarshalling type *v2024_02_01.ImageTemplatePropertiesOptimize: unmarshalling type *v2024_02_01.ImageTemplatePropertiesOptimize, unknown field \"vmboot\". There is an issue with the syntax with the JSON template you are submitting. Please check the JSON template for syntax and grammar. For more information on the syntax and grammar of the JSON template, visit http://aka.ms/azvmimagebuildertmplref.

A hibaüzenet megemlít egy "ismeretlen mezőt", és átirányítja a hivatalos dokumentációhoz: Azure Image Builder Bicep- vagy ARM-sablon JSON-sablon létrehozása.

Feljegyzés

Az Azure Image Builder Swagger for API-hívásokra vonatkozó hivatkozása

Az Azure Image Builder szolgáltatás hívásai során mindig hivatkozzon a Swagger dokumentációjára, amely az Azure Image Builder API-specifikációinak végleges igazságforrása. Bár a nyilvános dokumentáció úgy lett frissítve, hogy az API-kiadás előtt tartalmazza a megfelelő nagybetűket és mezőneveket, a Swagger-definíció pontos részleteket tartalmaz az egyes AIB API-król, hogy biztosan helyesen hívhassa meg a szolgáltatást.

Az alábbiakban felsoroljuk a 2024-02-01 API-verzió mezőneveinek megfelelő dokumentációs módosításokat:

Az Azure Image Builder Bicep vagy ARM-sablon JSON-sablondokumentációjában:

Mezők frissítve:

  • Több említést is lecserélt a következőre:vmbootvmBoot
  • Az egyik említést imageVersionID a következőre cserélte: imageVersionId

Mező el lett távolítva:

  • apiVersion: Javasoljuk, hogy kerülje a mező felvételét a kérésekbe, mert nincs explicit módon megadva az API-ban, ezért a JSON-sablonba való belefoglalás a kép buildjében hibákhoz vezethet .

Az Azure VM Image Builder hálózatkezelési beállításainak dokumentációjában:

Mező frissítve:

  • Az egyik említést VirtualNetworkConfig a következőre cserélte: vnetConfig

Eltávolított mezők:

  • subnetName tulajdonságban – ez a vnetConfig mező elavult, és az új mező subnetId
  • resourceGroupName tulajdonságban – ez a vnetConfig mező elavult, és az új mező subnetId

Rögzítés régebbi Azure Image Builder API-verzióra

Fontos szempont a régebbi API-verziókhoz való rögzítésnél

Egy régebbi Azure Image Builder API-verzió rögzítése kompatibilitást biztosíthat a meglévő sablonokkal, de a következő tényezők miatt nem ajánlott:

  • Elavulás kockázata: Előfordulhat, hogy a régebbi API-verziók elavultak.

  • Hiányzó funkciók: Ha egy régebbi API-verziót rögzít, lemarad az újabb verziókban bevezetett legújabb funkciókról és fejlesztésekről. Ezek a fejlesztések gyakran javítják a teljesítményt, a biztonságot és a funkcionalitást.

Ha az új kis- és nagybetűk bizalmassági szabályai miatt el szeretné kerülni a képsablonok tulajdonságainak módosítását, lehetősége van az Azure VM Image Builder API-hívások rögzítésére egy korábbi API-verzióra. Ez lehetővé teszi, hogy módosítások nélkül továbbra is használja az ismerős viselkedést.

A meglévő sablonokkal való kompatibilitás biztosítása érdekében a rendszerképsablonok létrehozásakor vagy frissítésekor adja meg a kívánt API-verziót (például api-version=2022-07-01), és adja meg a api-version paramétert a szolgáltatás hívásában. Példa:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}?api-version=2022-07-01

A kód tesztelése

Miután rögzítette a régebbi API-verziót, tesztelje a kódot, hogy ellenőrizze, hogy a várt módon működik-e. Győződjön meg arról, hogy a meglévő sablonok továbbra is megfelelően működnek.

2023. november

Az Azure Image Builder szakaszos módon engedélyezi az izolált rendszerkép-buildeket az Azure Container Instances használatával. A bevezetés várhatóan 2024 elejére fejeződik be. A meglévő képsablonok továbbra is működni fognak, és nem változik az új képsablonok létrehozása vagy létrehozása.

Előfordulhat, hogy az átmeneti Azure-erőforrások egy másik készlete jelenik meg ideiglenesen az átmeneti erőforráscsoportban, de ez nem befolyásolja a tényleges buildeket vagy az Azure Image Builder használatát. További információ: Izolált rendszerkép-buildek.

Fontos

Győződjön meg arról, hogy az előfizetés regisztrálva van a Microsoft.ContainerInstance szolgáltatónál, és nincsenek olyan szabályzatok, amelyek blokkolják az Azure Container Instances-erőforrások üzembe helyezését. Győződjön meg arról is, hogy a kvóta elérhető az Azure Container Instances-erőforrásokhoz.

2023. április

Új portálfunkció lett hozzáadva az Azure Image Builderhez. Keressen a "Képsablonok" kifejezésre az Azure Portalon, majd kattintson a "Létrehozás" gombra. Az egyéni rendszerképek portálon belüli létrehozásával és érvényesítésével is megismerkedhet .

API-kiadások

2024-02-01-es verzió

Fejlesztések

  • Új autoRun tulajdonság, amely lehetővé teszi a rendszerkép sablonlétrehozásra vagy frissítésre való futtatását. További információ: Tulajdonságok: autoRun.
  • Új managedResourceTags tulajdonság, amely lehetővé teszi címkék alkalmazását az Azure Image Builder szolgáltatás által az átmeneti erőforráscsoportban a rendszerkép készítése során létrehozott erőforrásokra. További információ: Tulajdonságok: managedResourceTags.
  • Új containerInstanceSubnetId tulajdonság, amely lehetővé teszi egy alhálózat megadását, amelyen az Azure Container Instance az izolált buildekhez lesz üzembe helyezve. Ez a mező csak akkor adható meg, ha subnetId szintén meg van adva, és ugyanazon a virtuális hálózaton kell lennie, mint a megadott alhálózat.subnetId További információ: Saját buildes virtuálisgép-alhálózat létrehozása és saját ACI-alhálózat használata.
  • A tulajdonság frissítésének támogatása a vmProfile következő mezőkkel együtt:
    • vmSize
    • osDiskSizeGB
    • userAssignedIdentities
    • vnetConfig
      • subnetId
      • containerInstanceSubnetId További információ a tulajdonságról: vmProfile vmProfile.

A Changes API 2024-02-01-es verziója olyan kompatibilitástörő változást vezet be, amely minden mező esetében kényszeríti a kis- és nagybetűk érzékenységét. Ez azt jelenti, hogy az API-kérelmekben szereplő betűk nagybetűsítésének pontosan meg kell egyeznie a várt formátummal. Ha api-kérelmet küld az Azure Image Builder API 2024-02-01-es verziójának, és nem megfelelő esettel vagy ismeretlen mezőkkel, a szolgáltatás elutasítja azt. Hibaüzenet jelenik meg, amely azt jelzi, hogy a kérés érvénytelen. További információ: Kompatibilitástörő változás: Kis- és nagybetűk érzékenysége.

2023-07-01-es verzió

Hamarosan elérhető

Az Azure Compute Gallery terjesztési céljainak frissítésének támogatása.

Változások

Új errorHandling tulajdonság. Ezzel a tulajdonsággal a felhasználók jobban szabályozhatják a hibák kezelését a képkészítési folyamat során. További információ: errorHandling

2022-07-01-es verzió

Fejlesztések

  • Támogatás hozzáadva az Azure Compute Galleryben tárolt legújabb rendszerkép-verzió használatához a képsablon forrásaként
  • Hozzáadva versioning a rendszerkép-disztribúciók verziószámainak létrehozásához. További információ: tulajdonságok: verziószámozás
  • A régiónkénti konfiguráció támogatása az Azure Compute Galleryben való terjesztéskor. További információ: Distribute:targetRegions
  • Új "Fájl" érvényesítési típust adott hozzá. További információ: tulajdonságok érvényesítése
  • A virtuális merevlemezek mostantól terjeszthetők egy egyéni blobba vagy tárolóba egy egyéni tárfiókban. További információ: Distribute: VHD
  • A közvetlen megosztott katalógus rendszerképének a képsablon forrásaként való használatának támogatása

Változások

  • replicationRegions a katalógus-disztribúciók esetében elavult. További információkért használja a katalógus replikált régióinak használatát
  • A virtuális merevlemezek mostantól terjeszthetők egy egyéni blobba vagy tárolóba egy egyéni tárfiókban
  • targetRegions tömb hozzáadva és alkalmazva csak a "SharedImage" típusú elosztásra. További információ: targetRegionsAzure Compute Gallery
  • A közvetlen megosztott katalógus képének a képsablon forrásaként való használatának támogatása. A közvetlen megosztott katalógus jelenleg előzetes verzióban érhető el.
  • Az eseményindítók mostantól nyilvános előzetes verzióban is elérhetők az automatikus rendszerkép-buildek beállításához. További információ: AIB-eseményindítók használata

2022-02-14-es verzió

Fejlesztések

2021-10-01-es verzió

Kompatibilitástörő változás

Az API 2021-10-01-es verziója megváltoztatja a hibasémát, amely minden jövőbeli API-kiadás része lesz. Ha rendelkezik Azure VM Image Builder-automatizálással, vegye figyelembe az új hibakimenetet , amikor az API 2021-10-01-es vagy újabb verziójára vált. Azt javasoljuk, hogy miután a legújabb API-verzióra váltott, ne térjen vissza egy korábbi verzióra, mert a korábbi hibaséma létrehozásához újra módosítania kell az automatizálást. Nem számítunk arra, hogy a hibaséma a jövőbeni kiadásokban is megváltozik.

Hibakimenet a 2020-02-14-es és korábbi verzióhoz
{ 
  "code": "ValidationFailed",
  "message": "Validation failed: 'ImageTemplate.properties.source': Field 'imageId' has a bad value: '/subscriptions/subscriptionID/resourceGroups/resourceGroupName/providers/Microsoft.Compute/images/imageName'. Please review  http://aka.ms/azvmimagebuildertmplref  for details on fields requirements in the Image Builder Template." 
}
Hibakimenet a 2021-10-01-es és újabb verzióhoz
{ 
  "error": {
    "code": "ValidationFailed", 
    "message": "Validation failed: 'ImageTemplate.properties.source': Field 'imageId' has a bad value: '/subscriptions/subscriptionID/resourceGroups/resourceGroupName/providers/Microsoft.Compute/images/imageName'. Please review  http://aka.ms/azvmimagebuildertmplref  for details on fields requirements in the Image Builder Template." 
  }
}

Fejlesztések

  • A virtuálisgép-msi-k buildeléséhez hozzáadott támogatás.
  • A proxy virtuális gép méretének testreszabása is támogatott.

2020-02-14-es verzió

Fejlesztések

  • Az alábbi forrásokból származó képek létrehozásának támogatása hozzáadva:
    • Felügyelt rendszerkép
    • Azure Compute-katalógus
    • Platformrendszerkép-adattár (beleértve a platformrendszerkép vásárlási csomagját)
  • A következő testreszabások támogatása hozzáadva:
    • Shell (Linux): Szkript vagy beágyazott
    • PowerShell (Windows): Szkript vagy beágyazott, rendszergazda jogú futtatás, futtatás rendszerként
    • Fájl (Linux és Windows)
    • Windows újraindítása (Windows)
    • Windows Update (Windows): Keresési feltételek, szűrők és frissítési korlát
  • A következő disztribúciós típusok támogatása hozzáadva:
    • VHD (virtuális merevlemez)
    • Felügyelt rendszerkép
    • Azure Compute-katalógus
  • Egyéb funkciók:
    • További támogatás az ügyfelek számára a saját virtuális hálózatuk használatához
    • Az ügyfelek támogatása a buildelési virtuális gép testreszabásához (virtuális gép mérete, operációs rendszer lemezmérete)
    • A felhasználó által hozzárendelt Microsoft Windows Installer (MSI) támogatása (a testreszabási/elosztási lépésekhez)
    • Gen2-rendszerképek támogatása hozzáadva

Előzetes verziójú API-k

A következő API-k elavultak, de továbbra is támogatottak:

  • 2019-05-01-preview verzió

Következő lépések

További információ a virtuálisgép-rendszerkép-készítőről.