Sdílet prostřednictvím

Novinky ve službě Azure VM Image Builder

  • Článek

Platí pro: ✔️ Virtuální počítače s Windows s Linuxem ✔️ ✔️ – Flexibilní škálovací sady Uniform Scale Sets ✔️

Tento článek obsahuje všechny hlavní změny rozhraní API a aktualizace funkcí pro službu Azure VM Image Builder (AIB).

Aktualizace

Září 2024

Automatické vytváření imagí prostřednictvím triggerů se deaktivuje, pokud sestavení šablony image selhalo několikrát po sobě, aby se zabránilo zbytečným selháním sestavení.

Šablonu image můžete přesto sestavit ručně. Jakmile bude ruční sestavení úspěšné, automatické triggery se znovu aktivují.

Upozorňujeme, že toto chování je stejné bez ohledu na verzi rozhraní API, kterou používáte pro prostředek šablony image.

Květen 2024

Změna způsobující chybu: Citlivost malých a velkých písmen

Od 21. května 2024 bude rozhraní API Image Builderu virtuálního počítače Azure verze 2024-02-01 a novější vynucovat citlivost na velká a malá písmena pro všechna pole. To znamená, že velká písmena v požadavcích API musí přesně odpovídat očekávanému formátu.

Důležité

Důležitá poznámka pro stávající uživatele Azure Image Builderu

Pokud jste stávajícím uživatelem Azure VM Image Builderu, ujišťujte se, že tato změna nebude mít vliv na vaše stávající prostředky. Vynucení citlivosti případu se vztahuje pouze na nově vytvořené prostředky pomocí rozhraní API verze 2024-02-01 a novější. Vaše stávající prostředky budou i nadále fungovat podle očekávání bez jakýchkoli změn.

Pokud narazíte na nějaké problémy související s citlivostí písmen, projděte si aktualizovanou dokumentaci k rozhraní API v Azure Image Builderu, kde najdete pokyny.

V minulosti bylo rozhraní API Azure Image Builderu v pohledu případu více odpustit, ale v budoucnu je přesnost zásadní. Při volání rozhraní API se ujistěte, že pro názvy polí, parametry a hodnoty použijete správnou velká písmena. Pokud je například pole s názvem "vmBoot", musíte použít "vmBoot" (nikoli "VMBoot" nebo "vmboot").

Pokud odešlete požadavek rozhraní API do rozhraní API Azure Image Builderu verze 2024-02-01 a vyšší s nesprávným případem nebo nerozpoznanými poli, služba ji odmítne. Zobrazí se chybová odpověď, která značí, že požadavek je neplatný. Chyba bude vypadat přibližně takto:

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.

Chybová zpráva zmíní "neznámé pole" a přesměruje vás na oficiální dokumentaci: Vytvořte šablonu JSON pro Azure Image Builder Bicep nebo šablonu ARM.

Poznámka:

Referenční informace o Swaggeru Azure Image Builderu pro volání rozhraní API

Při volání služby Azure Image Builder vždy odkazujte na dokumentaci Swaggeru, která slouží jako konečný zdroj pravdivých informací pro specifikace rozhraní API Azure Image Builderu. I když byla veřejná dokumentace aktualizována tak, aby obsahovala správné názvy velkých písmen a polí před vydáním rozhraní API, definice Swaggeru obsahuje přesné podrobnosti o jednotlivých rozhraních API AIB, abyste zajistili správné volání služby.

Níže je seznam změn dokumentace, které byly provedeny tak, aby odpovídaly názvům polí v rozhraní API verze 2024-02-01:

V dokumentaci k šabloně JSON pro vytvoření Azure Image Builderu bicep nebo šablony ARM:

Pole aktualizována:

  • Nahrazeno několika zmínkami vmbootvmBoot
  • Nahrazeno jednou zmínkou imageVersionIDimageVersionId

Pole odebráno:

  • apiVersion: Doporučujeme vyhnout se zahrnutí tohoto pole do vašich požadavků, protože není explicitně zadáno v našem rozhraní API, takže zahrnutí do šablony JSON může vést k chybám v sestavení image.

V dokumentaci k možnostem sítě Azure VM Image Builderu:

Pole aktualizováno:

  • Nahrazeno jednou zmínkou VirtualNetworkConfigvnetConfig

Odebraná pole:

  • subnetNamevnetConfig ve vlastnosti – toto pole je zastaralé a nové pole jesubnetId
  • resourceGroupNamevnetConfig ve vlastnosti – toto pole je zastaralé a nové pole jesubnetId

Jak připnout na starší verzi rozhraní API Azure Image Builderu

Důležité informace o připnutí na starší verze rozhraní API

Připnutí na starší verzi rozhraní API Azure Image Builderu může zajistit kompatibilitu se stávajícími šablonami, ale nedoporučuje se kvůli následujícím faktorům:

  • Riziko vyřazení: Starší verze rozhraní API můžou být nakonec zastaralé.

  • Chybějící funkce: Připnutím na starší verzi rozhraní API vám chybí nejnovější funkce a vylepšení představená v novějších verzích. Tato vylepšení často zlepšují výkon, zabezpečení a funkce.

Pokud se chcete vyhnout změnám vlastností v šablonách obrázků kvůli novým pravidlům citlivosti malých a malých písmen, máte možnost připnout volání rozhraní API Pro Image Builder virtuálních počítačů Azure na předchozí verzi rozhraní API. Díky tomu můžete dál používat známé chování bez jakýchkoli úprav.

Pokud chcete zajistit kompatibilitu se stávajícími šablonami, zadejte při vytváření nebo aktualizaci šablony image požadovanou verzi rozhraní API (např. api-version=2022-07-01) zahrnutím parametru api-version do volání služby. Příklad:

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

Otestování kódu

Po připnutí na starší verzi rozhraní API otestujte kód a ověřte, že se chová podle očekávání. Ujistěte se, že vaše stávající šablony nadále fungují správně.

Listopad 2023

Azure Image Builder umožňuje izolované sestavení imagí pomocí služby Azure Container Instances fázovaným způsobem. Očekává se, že zavedení bude dokončeno do začátku roku 2024. Vaše stávající šablony imagí budou dál fungovat a způsob, jakým vytváříte nebo vytváříte nové šablony imagí, se nemění.

V přípravné skupině prostředků se může dočasně zobrazit jiná sada přechodných prostředků Azure, ale to nemá vliv na vaše skutečné buildy nebo způsob interakce s Azure Image Builderem. Další informace najdete v tématu Sestavení izolovaných imagí.

Důležité

Ujistěte se, že je vaše předplatné zaregistrované pro Microsoft.ContainerInstance poskytovatele a neblokují nasazení prostředků služby Azure Container Instances žádné zásady. Také se ujistěte, že je kvóta k dispozici pro prostředky služby Azure Container Instances.

Duben 2023

Byla přidána nová funkce portálu pro Azure Image Builder. Vyhledejte "Šablony obrázků" na webu Azure Portal a pak klikněte na Vytvořit. Můžete také začít se sestavováním a ověřováním vlastních imagí na portálu.

Vydané verze rozhraní API

Verze 2024-02-01

Vylepšení

  • Nová autoRun vlastnost, která umožňuje spustit sestavení image při vytváření nebo aktualizaci šablony. Další informace naleznete v tématu Vlastnosti: autoRun.
  • Nová managedResourceTags vlastnost, která umožňuje použít značky na prostředky, které služba Azure Image Builder vytvoří v přípravné skupině prostředků během sestavení image. Další informace naleznete v tématu Vlastnosti: managedResourceTags.
  • Nová containerInstanceSubnetId vlastnost, která umožňuje zadat podsíť, ve které se služba Azure Container Instance nasadí pro izolované sestavení. Toto pole lze zadat pouze v případě, že subnetId je zadáno a musí být ve stejné virtuální síti jako podsíť zadaná v subnetId. Další informace najdete v tématu Používání vlastní podsítě virtuálního počítače buildu a používání vlastní podsítě ACI.
  • Přidání podpory pro aktualizaci vmProfile vlastnosti včetně následujících polí:
    • vmSize
    • osDiskSizeGB
    • userAssignedIdentities
    • vnetConfig
      • subnetId
      • containerInstanceSubnetId Další informace o vmProfile vlastnosti naleznete v tématu vmProfile.

Změny rozhraní API verze 2024-02-01 zavádí zásadní změnu, která vynucuje citlivost na velká a malá písmena pro všechna pole. To znamená, že velká písmena v požadavcích API musí přesně odpovídat očekávanému formátu. Pokud odešlete požadavek rozhraní API do rozhraní API Azure Image Builderu verze 2024-02-01 a vyšší s nesprávným případem nebo nerozpoznanými poli, služba ji odmítne. Zobrazí se chybová odpověď, která značí, že požadavek je neplatný. Další informace najdete v tématu Zásadní změna: Citlivost malých a velkých písmen.

Verze 2023-07-01

Novinky

Podpora aktualizace distribučních cílů galerie výpočetních prostředků Azure

Změny

Nová errorHandling vlastnost. Tato vlastnost poskytuje uživatelům větší kontrolu nad tím, jak se chyby zpracovávají během procesu vytváření obrázků. Další informace naleznete v tématu errorHandling

Verze 2022-07-01

Vylepšení

  • Přidání podpory pro použití nejnovější verze image uložené v Galerii služby Azure Compute jako zdroj šablony image
  • Přidáno versioning do podpory generování čísel verzí pro distribuce imagí. Další informace najdete v tématu vlastnosti: správa verzí
  • Přidání podpory konfigurace jednotlivých oblastí při distribuci do Galerie výpočetních prostředků Azure Další informace naleznete v tématu Distribuce:targetRegions
  • Byl přidán nový typ ověření "Soubor". Další informace najdete v tématu ověření vlastností.
  • Virtuální pevné disky se teď dají distribuovat do vlastního objektu blob nebo kontejneru ve vlastním účtu úložiště. Další informace naleznete v tématu Distribuce: VHD
  • Přidání podpory pro použití image Direct Shared Gallery jako zdroje šablony obrázku

Změny

  • replicationRegions pro distribuce v galerii je teď zastaralý. Další informace najdete v galerii replikovaných oblastech.
  • Virtuální pevné disky se teď dají distribuovat do vlastního objektu blob nebo kontejneru ve vlastním účtu úložiště.
  • targetRegions pole bylo přidáno a použito pouze pro distribuci typu SharedImage. Další informace o targetRegionsslužbě Azure Compute Gallery
  • Přidání podpory pro použití image Direct Shared Gallery jako zdroje šablony obrázku Přímá sdílená galerie je aktuálně ve verzi Preview.
  • Triggery jsou teď k dispozici ve verzi Public Preview pro nastavení automatických buildů imagí. Další informace najdete v tématu Jak používat triggery AIB.

Verze 2022-02-14

Vylepšení

Verze 2021-10-01

Změna způsobující chybu

Rozhraní API verze 2021-10-01 zavádí změnu schématu chyb, která bude součástí každé budoucí verze rozhraní API. Pokud máte nějaké automatizace Image Builderu virtuálních počítačů Azure, mějte při přechodu na rozhraní API verze 2021–10-01 nebo novější informace o novém chybovém výstupu . Doporučujeme, abyste se po přepnutí na nejnovější verzi rozhraní API vrátili k dřívější verzi, protože budete muset znovu změnit automatizaci, abyste vytvořili dřívější schéma chyb. Neočekáváme, že schéma chyb změníme znovu v budoucích verzích.

Výstup chyby pro verzi 2020-02-14 a starší
{ 
  "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." 
}
Výstup chyby pro verzi 2021-10-01 a novější
{ 
  "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." 
  }
}

Vylepšení

Verze 2020-02-14

Vylepšení

  • Přidání podpory pro vytváření imagí z následujících zdrojů:
    • Spravovaná image
    • Azure Compute Gallery
    • Úložiště imagí platformy (včetně plánu nákupu imagí platformy)
  • Přidání podpory pro následující přizpůsobení:
    • Prostředí (Linux): Skript nebo vložený
    • PowerShell (Windows): Skript nebo vložený, spustit se zvýšenými oprávněními, spustit jako systém
    • Soubor (Linux a Windows)
    • Windows Restart (Windows)
    • služba Windows Update (Windows): Kritéria vyhledávání, filtry a limit aktualizací
  • Přidání podpory pro následující typy distribuce:
    • Virtuální pevný disk (virtuální pevný disk)
    • Spravovaná image
    • Azure Compute Gallery
  • Další funkce:
    • Přidání podpory pro zákazníky, kteří používají vlastní virtuální síť
    • Přidání podpory pro zákazníky pro přizpůsobení virtuálního počítače sestavení (velikost virtuálního počítače, velikost disku operačního systému)
    • Přidání podpory pro uživatelsky přiřazenou instalační službu systému Microsoft Windows (MSI) (pro přizpůsobení nebo distribuci kroků)
    • Přidání podpory pro image Gen2

Rozhraní API ve verzi Preview

Následující rozhraní API jsou zastaralá, ale stále se podporují:

  • Verze 2019-05-01-preview

Další kroky

Další informace o Tvůrci imagí virtuálních počítačů