Delen via

Wat is er nieuw in Azure VM Image Builder

  • Artikel

Van toepassing op: ✔️ Virtuele Linux-machines voor Windows-VM's ✔️ ✔️ Flexibele schaalsets Uniform-schaalsets ✔️

Dit artikel bevat alle belangrijke API-wijzigingen en functie-updates voor de AIB-service (Azure VM Image Builder).

Updates

Mei 2024

Wijziging die fouten veroorzaken: hoofdlettergevoeligheid

Vanaf 21 mei 2024 wordt voor alle velden de API-versie 2024-02-01 van Azure VM Image Builder afgedwongen. Dit betekent dat het hoofdlettergebruik van letters in uw API-aanvragen exact moet overeenkomen met de verwachte indeling.

Belangrijk

Belangrijke opmerking voor bestaande Gebruikers van Azure Image Builder

Als u een bestaande gebruiker van Azure VM Image Builder bent, kunt u er zeker van zijn dat deze wijziging geen invloed heeft op uw bestaande resources. De afdwinging van hoofdlettergevoeligheid is alleen van toepassing op nieuw gemaakte resources met API-versie 2024-02-01 en hoger. Uw bestaande resources blijven werken zoals verwacht zonder wijzigingen.

Als u problemen ondervindt met betrekking tot hoofdlettergevoeligheid, raadpleegt u de bijgewerkte API-documentatie van Azure Image Builder voor hulp.

Voorheen was de API van Azure Image Builder meer vergevend in termen van case, maar vooruitgaand is precisie cruciaal. Wanneer u API-aanroepen maakt, moet u ervoor zorgen dat u het juiste hoofdlettergebruik gebruikt voor veldnamen, parameters en waarden. Als een veld bijvoorbeeld de naam 'vmBoot' heeft, moet u 'vmBoot' gebruiken (niet 'VMBoot' of 'vmboot').

Als u een API-aanvraag verzendt naar de API-versie 2024-02-01 van Azure Image Builder en verder met onjuiste hoofdletters of niet-herkende velden, wordt deze geweigerd door de service. U ontvangt een foutbericht dat aangeeft dat de aanvraag ongeldig is. De fout ziet er ongeveer als volgt uit:

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.

Het foutbericht vermeldt een onbekend veld en stuurt u naar de officiële documentatie: Een JSON-sjabloon voor Azure Image Builder Bicep of ARM-sjabloon maken.

Notitie

Verwijzing naar Swagger van Azure Image Builder voor API-aanroepen

Wanneer u aanroepen naar de Azure Image Builder-service maakt, raadpleegt u altijd de Swagger-documentatie, die fungeert als de definitieve bron van waarheid voor de API-specificaties van Azure Image Builder. Hoewel de openbare documentatie is bijgewerkt met de juiste hoofdletters en veldnamen vóór de API-release, bevat de Swagger-definitie nauwkeurige details over elke AIB-API om ervoor te zorgen dat u de service correct aanroept.

Hieronder ziet u een lijst met de documentatiewijzigingen die zijn aangebracht zodat deze overeenkomen met de veldnamen in API-versie 2024-02-01:

In de documentatie voor een JSON-sjabloon voor Een Azure Image Builder Bicep- of ARM-sjabloon maken:

Bijgewerkte velden:

  • Meerdere vermeldingen vervangen vmboot door vmBoot
  • Eén vermelding vervangen imageVersionID door imageVersionId

Veld verwijderd:

  • apiVersion: Het is raadzaam om het opnemen van dit veld in uw aanvragen te voorkomen omdat dit niet expliciet is opgegeven in onze API, dus het opnemen ervan in uw JSON-sjabloon kan leiden tot fouten in de build van uw installatiekopieën.

In de documentatie voor netwerkopties van Azure VM Image Builder:

Veld bijgewerkt:

  • Eén vermelding vervangen VirtualNetworkConfig door vnetConfig

Velden verwijderd:

  • subnetName in de vnetConfig eigenschap : dit veld is afgeschaft en het nieuwe veld is subnetId
  • resourceGroupName in de vnetConfig eigenschap : dit veld is afgeschaft en het nieuwe veld is subnetId

Vastmaken aan een oudere API-versie van Azure Image Builder

Belangrijke overweging voor het vastmaken aan oudere API-versies

Het vastmaken aan een oudere Versie van de Azure Image Builder-API kan compatibiliteit bieden met uw bestaande sjablonen, maar dit wordt niet aanbevolen vanwege de volgende factoren:

  • Afschaffingsrisico: oudere API-versies kunnen uiteindelijk worden afgeschaft.

  • Ontbrekende functies: Door vast te maken aan een oudere API-versie, mist u de nieuwste functies en verbeteringen die zijn geïntroduceerd in nieuwere versies. Deze verbeteringen verbeteren vaak de prestaties, beveiliging en functionaliteit.

Als u wilt voorkomen dat u wijzigingen aanbrengt in de eigenschappen in uw afbeeldingssjablonen vanwege de nieuwe regels voor hoofdlettergevoeligheid, hebt u de mogelijkheid om uw Api-aanroepen van Azure VM Image Builder vast te maken aan een eerdere API-versie. Hierdoor kunt u het vertrouwde gedrag blijven gebruiken zonder wijzigingen.

Als u compatibiliteit met uw bestaande sjablonen wilt garanderen, geeft u bij het maken of bijwerken van een afbeeldingssjabloon de gewenste API-versie (bijvoorbeeld api-version=2022-07-01) op door de api-version parameter in uw aanroep naar de service op te geven. Voorbeeld:

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

Uw code testen

Nadat u de oudere API-versie hebt vastgemaakt, test u uw code om te controleren of deze zich gedraagt zoals verwacht. Zorg ervoor dat uw bestaande sjablonen correct blijven functioneren.

November 2023

Azure Image Builder schakelt geïsoleerde builds van installatiekopieën in met behulp van Azure Container Instances op een gefaseerde manier. De implementatie wordt naar verwachting begin 2024 voltooid. Uw bestaande afbeeldingssjablonen blijven werken en er is geen wijziging in de manier waarop u nieuwe afbeeldingssjablonen maakt of maakt.

Mogelijk ziet u dat een andere set tijdelijke Azure-resources tijdelijk wordt weergegeven in de faseringsresourcegroep, maar dit heeft geen invloed op uw werkelijke builds of de manier waarop u met Azure Image Builder werkt. Zie Isolated Image Builds voor meer informatie.

Belangrijk

Zorg ervoor dat uw abonnement is geregistreerd voor de Microsoft.ContainerInstance provider en dat er geen beleid is dat de implementatie van Azure Container Instances-resources blokkeert. Zorg er ook voor dat het quotum beschikbaar is voor Azure Container Instances-resources.

April 2023

Er is nieuwe portalfunctionaliteit toegevoegd voor Azure Image Builder. Zoek 'Afbeeldingssjablonen' in De Azure-portal en klik vervolgens op Maken. U kunt hier ook aan de slag met het bouwen en valideren van aangepaste installatiekopieën in de portal.

API-releases

Versie 2024-02-01

Verbeteringen

  • Nieuwe autoRun eigenschap waarmee u de build van de installatiekopie kunt uitvoeren bij het maken of bijwerken van een sjabloon. Zie Eigenschappen: autoRun voor meer informatie.
  • Nieuwe managedResourceTags eigenschap waarmee u tags kunt toepassen op de resources die de Azure Image Builder-service maakt in de faseringsresourcegroep tijdens de build van de installatiekopieën. Zie Properties: managedResourceTags voor meer informatie.
  • Nieuwe containerInstanceSubnetId eigenschap waarmee u een subnet kunt opgeven waarop Azure Container Instance wordt geïmplementeerd voor geïsoleerde builds. Dit veld mag alleen worden opgegeven als subnetId dit ook is opgegeven en moet zich in hetzelfde virtuele netwerk bevinden als het subnet dat is opgegeven in subnetId. Zie Bring your own Build VM subnet and bring your own ACI subnet( Bring Your Own Build VM) voor meer informatie.
  • Er is ondersteuning toegevoegd voor het bijwerken van de vmProfile eigenschap, inclusief de volgende velden:
    • vmSize
    • osDiskSizeGB
    • userAssignedIdentities
    • vnetConfig
      • subnetId
      • containerInstanceSubnetIdZie vmProfile voor meer informatie over de vmProfile eigenschap.

Wijzigingen van API-versie 2024-02-01 introduceert een belangrijke wijziging die hoofdlettergevoeligheid afdwingt voor alle velden. Dit betekent dat het hoofdlettergebruik van letters in uw API-aanvragen exact moet overeenkomen met de verwachte indeling. Als u een API-aanvraag verzendt naar de API-versie 2024-02-01 van Azure Image Builder en verder met onjuiste hoofdletters of niet-herkende velden, wordt deze geweigerd door de service. U ontvangt een foutbericht dat aangeeft dat de aanvraag ongeldig is. Zie Belangrijke wijziging: Hoofdlettergevoeligheid voor meer informatie.

Versie 2023-07-01

Binnenkort beschikbaar

Ondersteuning voor het bijwerken van distributiedoelen in de Azure Compute Gallery.

Wijzigingen

Nieuwe errorHandling eigenschap. Deze eigenschap biedt gebruikers meer controle over hoe fouten worden verwerkt tijdens het proces voor het bouwen van afbeeldingen. Zie errorHandling voor meer informatie

Versie 2022-07-01

Verbeteringen

  • Er is ondersteuning toegevoegd voor het gebruik van de nieuwste versie van de installatiekopieën die is opgeslagen in De Azure Compute Gallery als bron voor de installatiekopieënsjabloon
  • Toegevoegd versioning ter ondersteuning van het genereren van versienummers voor installatiekopieëndistributies. Zie eigenschappen voor meer informatie : versiebeheer
  • Er is ondersteuning toegevoegd voor configuratie per regio bij distributie naar Azure Compute Gallery. Zie Distribute:targetRegions voor meer informatie
  • Nieuw validatietype Bestand toegevoegd. Zie Eigenschappen valideren voor meer informatie
  • VHD's kunnen nu worden gedistribueerd naar een aangepaste blob of container in een aangepast opslagaccount. Zie Distribueren: VHD voor meer informatie
  • Ondersteuning toegevoegd voor het gebruik van een direct gedeelde galerie-installatiekopieën als bron voor de afbeeldingssjabloon

Wijzigingen

  • replicationRegions is nu afgeschaft voor galeriedistributies. Gebruik galerie-gerepliceerde regio's voor meer informatie
  • VHD's kunnen nu worden gedistribueerd naar een aangepaste blob of container in een aangepast opslagaccount
  • targetRegions matrix is toegevoegd en alleen toegepast op 'SharedImage'-type distribueren. Zie Azure Compute Gallery voor meer informatie over targetRegions
  • Er is ondersteuning toegevoegd voor het gebruik van een direct gedeelde galerie-installatiekopieën als bron voor de afbeeldingssjabloon. Direct Shared Gallery is momenteel beschikbaar als preview-versie.
  • Triggers zijn nu beschikbaar in de openbare preview om automatische builds van installatiekopieën in te stellen. Zie AIB-triggers gebruiken voor meer informatie

Versie 2022-02-14

Verbeteringen

Versie 2021-10-01

Wijziging die fouten veroorzaken

API-versie 2021-10-01 introduceert een wijziging in het foutschema dat deel uitmaakt van elke toekomstige API-release. Als u azure VM Image Builder-automatiseringen hebt, moet u rekening houden met de nieuwe foutuitvoer wanneer u overschakelt naar API-versie 2021-10-01 of hoger. We raden u aan om, nadat u bent overgeschakeld naar de nieuwste API-versie, niet terug te keren naar een eerdere versie, omdat u uw automatisering opnieuw moet wijzigen om het eerdere foutschema te produceren. We verwachten niet dat we het foutschema in toekomstige releases opnieuw zullen wijzigen.

Foutuitvoer voor versie 2020-02-14 en eerder
{ 
  "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." 
}
Foutuitvoer voor versie 2021-10-01 en hoger
{ 
  "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." 
  }
}

Verbeteringen

  • Er is ondersteuning toegevoegd voor VM-VM's bouwen.
  • Er is ondersteuning toegevoegd voor het aanpassen van de grootte van proxy-VM's.

Versie 2020-02-14

Verbeteringen

  • Er is ondersteuning toegevoegd voor het maken van installatiekopieën uit de volgende bronnen:
    • Beheerde installatiekopie
    • Azure Compute Gallery
    • Opslagplaats voor platforminstallatiekopieën (inclusief aankoopplan voor platforminstallatiekopieën)
  • Ondersteuning toegevoegd voor de volgende aanpassingen:
    • Shell (Linux): Script of inline
    • PowerShell (Windows): Script of inline, verhoogde uitvoering, als systeem uitvoeren
    • Bestand (Linux en Windows)
    • Windows Opnieuw opstarten (Windows)
    • Windows Update (Windows): Zoekcriteria, filters en updatelimiet
  • Er is ondersteuning toegevoegd voor de volgende distributietypen:
    • VHD (virtuele harde schijf)
    • Beheerde installatiekopie
    • Azure Compute Gallery
  • Andere functies:
    • Ondersteuning toegevoegd voor klanten om hun eigen virtuele netwerk te gebruiken
    • Ondersteuning toegevoegd voor klanten voor het aanpassen van de build-VM (VM-grootte, schijfgrootte van het besturingssysteem)
    • Ondersteuning toegevoegd voor door de gebruiker toegewezen Microsoft Windows Installer (MSI) (voor stappen voor aanpassen/distribueren)
    • Ondersteuning toegevoegd voor Gen2-installatiekopieën

Preview-API's

De volgende API's zijn afgeschaft, maar worden nog steeds ondersteund:

  • Versie 2019-05-01-preview

Volgende stappen

Meer informatie over VM Image Builder.