Aracılığıyla paylaş

Azure VM Görüntü Oluşturucusu'ndaki yenilikler

  • Makale

Şunlar için geçerlidir: ✔️ Linux VM'leri ✔️ Windows VM'leri ✔️ Esnek ölçek kümeleri ✔️ Tekdüzen ölçek kümeleri

Bu makale, Azure VM Görüntü Oluşturucusu (AIB) hizmeti için tüm önemli API değişikliklerini ve özellik güncelleştirmelerini içerir.

Güncelleştirmeler

Mayıs 2024

Hataya Neden Olan Değişiklik: Büyük/Küçük Harf Duyarlılığı

21 Mayıs 2024'ten itibaren Azure VM Image Builder'ın API sürümü 2024-02-01 ve sonrası tüm alanlar için büyük/küçük harf duyarlılığını zorunlu kılacak. Bu, API isteklerinizdeki harfleri büyük harfe çevirmenin tam olarak beklenen biçimle eşleşmesi gerektiği anlamına gelir.

Önemli

Mevcut Azure Image Builder Kullanıcıları için Önemli Not

Azure VM Görüntü Oluşturucusu'nun mevcut bir kullanıcısıysanız, bu değişikliğin mevcut kaynaklarınızı etkilemeyeceğinden emin olabilirsiniz. Büyük/küçük harf duyarlılığı zorlaması yalnızca API sürüm 2024-02-01 ve sonrası kullanılarak yeni oluşturulan kaynaklar için geçerlidir. Mevcut kaynaklarınız herhangi bir değişiklik olmadan beklendiği gibi çalışmaya devam edecektir.

Büyük/küçük harf duyarlılığıyla ilgili herhangi bir sorunla karşılaşırsanız kılavuz için lütfen Azure Görüntü Oluşturucusu'nun güncelleştirilmiş API belgelerine bakın.

Daha önce Azure Görüntü Oluşturucusu'nun API'si büyük/küçük harf açısından daha bağışlayıcıydı, ancak ileriye doğru duyarlık çok önemliydi. API çağrıları yaparken alan adları, parametreler ve değerler için doğru büyük/küçük harfe çevirmeyi kullandığınızdan emin olun. Örneğin, bir alan "vmBoot" olarak adlandırılıyorsa, "vmBoot" ("VMBoot" veya "vmboot" değil) kullanmanız gerekir.

Azure Image Builder'ın API sürümü 2024-02-01 ve ötesine yanlış durum veya tanınmayan alanlarla bir API isteği gönderirseniz, hizmet bunu reddeder. İsteğin geçersiz olduğunu belirten bir hata yanıtı alırsınız. Hata şuna benzer olacaktır:

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.

Hata iletisi bir "bilinmeyen alandan" bahsedecek ve sizi resmi belgelere yönlendirir: Azure Image Builder Bicep veya ARM şablonu JSON şablonu oluşturma.

Not

AZURE Image Builder'ın API Çağrıları için Swagger'larına başvurma

Azure Image Builder hizmetine çağrı yaparken her zaman Azure Image Builder'ın API belirtimleri için kesin bir gerçek kaynağı olarak hizmet veren Swagger belgelerine başvurun. Genel belgeler API sürümünden önce uygun büyük harf kullanımı ve alan adlarını içerecek şekilde güncelleştirilmiş olsa da Swagger tanımı, hizmete doğru çağrılar yaptığınızdan emin olmak için her AIB API'sine ilişkin kesin ayrıntıları içerir.

Aşağıda API sürüm 2024-02-01'deki alan adlarına uyacak şekilde yapılan belge değişikliklerinin listesi verilmiştir:

Azure Image Builder Bicep veya ARM şablonu JSON şablonu oluşturma belgelerinde:

Güncelleştirilen Alanlar:

  • birkaç bahsetmesi vmboot ile değiştirildi vmBoot
  • bir bahsetme ile imageVersionID değiştirildi imageVersionId

Alan Kaldırıldı:

  • apiVersion: Api'mizde açıkça belirtilmediğinden bu alanın isteklerinize eklenmesini önlemenizi öneririz, bu nedenle JSON şablonunuzla birlikte görüntü derlemenizde hatalara yol açabilir .

Azure VM Görüntü Oluşturucusu ağ seçenekleri belgelerinde:

Alan Güncelleştirildi:

  • bir bahsetme ile VirtualNetworkConfig değiştirildi vnetConfig

Kaldırılan Alanlar:

  • subnetName özelliğinde vnetConfig – bu alan kullanım dışıdır ve yeni alan subnetId
  • resourceGroupName özelliğinde vnetConfig – bu alan kullanım dışıdır ve yeni alan subnetId

Eski Bir Azure Image Builder API Sürümüne Sabitleme

Eski API Sürümlerine Sabitleme için Önemli Noktalar

Eski bir Azure Image Builder API sürümüne sabitlemek mevcut şablonlarınızla uyumluluk sağlayabilir, ancak aşağıdaki faktörler nedeniyle önerilmez:

  • Kullanımdan Kaldırma Riski: Eski API sürümleri sonunda kullanımdan kaldırılabilir.

  • Eksik Özellikler: Eski bir API sürümüne sabitleyerek, yeni sürümlerde sunulan en son özellikleri ve geliştirmeleri kaçırabilirsiniz. Bu geliştirmeler genellikle performansı, güvenliği ve işlevselliği geliştirir.

Yeni büyük/küçük harf duyarlılığı kuralları nedeniyle görüntü şablonlarınızdaki özelliklerde değişiklik yapmaktan kaçınmak isterseniz Azure VM Görüntü Oluşturucusu API çağrılarınızı önceki bir API sürümüne sabitleme seçeneğiniz vardır. Bu, herhangi bir değişiklik yapmadan tanıdık davranışı kullanmaya devam etmenizi sağlar.

Mevcut şablonlarınızla uyumluluğu sağlamak için, görüntü şablonu oluştururken veya güncelleştirirken, hizmete çağrınıza parametresini ekleyerek api-version istenen API sürümünü (örneğin api-version=2022-07-01) belirtin. Örnek:

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

Kodunuzu Test Edin

Eski API sürümüne sabitledikten sonra kodunuzu test edin ve beklendiği gibi davrandığını doğrulayın. Mevcut şablonlarınızın düzgün çalışmaya devam ettiğinden emin olun.

Kasım 2023

Azure Image Builder, Azure Container Instances'ı aşamalı olarak kullanarak Yalıtılmış Görüntü Derlemelerini etkinleştiriyor. Dağıtımın 2024 başlarında tamamlanması bekleniyor. Mevcut görüntü şablonlarınız çalışmaya devam eder ve yeni görüntü şablonları oluşturma veya oluşturma yönteminizde herhangi bir değişiklik olmaz.

Hazırlama kaynak grubunda geçici olarak farklı bir Azure kaynakları kümesinin göründüğünü ancak bunun gerçek derlemelerinizi veya Azure Image Builder ile etkileşim kurma şeklinizi etkilemediğini gözlemleyebilirsiniz. Daha fazla bilgi için bkz . Yalıtılmış Görüntü Derlemeleri.

Önemli

Aboneliğinizin sağlayıcı için Microsoft.ContainerInstance kayıtlı olduğundan ve Azure Container Instances kaynaklarının dağıtımını engelleyen ilke olmadığından emin olun. Ayrıca Azure Container Instances kaynakları için kotanın kullanılabilir olduğundan emin olun.

Nisan 2023

Azure Görüntü Oluşturucusu için yeni portal işlevselliği eklendi. Azure portalında "Görüntü Şablonları" araması yapın ve ardından "Oluştur"a tıklayın. Ayrıca portalda özel görüntüler oluşturmaya ve doğrulamaya buradan başlayabilirsiniz.

API sürümleri

Sürüm 2024-02-01

İyileştirmeler

  • Şablon oluşturma veya güncelleştirme üzerinde görüntü derlemesini çalıştırmanızı sağlayan yeni autoRun özellik. Daha fazla bilgi için bkz . Özellikler: autoRun.
  • Azure Image Builder hizmetinin görüntü derlemesi sırasında hazırlama kaynak grubunda oluşturduğu kaynaklara etiket uygulamanıza olanak tanıyan yeni managedResourceTags özellik. Daha fazla bilgi için bkz . Özellikler: managedResourceTags.
  • Yalıtılmış Derlemeler için Azure Container Instance'ın dağıtılacağı bir alt ağ belirtmenize olanak tanıyan yeni containerInstanceSubnetId özellik. Bu alan yalnızca aynı zamanda belirtilmişse subnetId belirtilebilir ve içinde subnetIdbelirtilen alt ağ ile aynı Sanal Ağ olmalıdır. Daha fazla bilgi için bkz . Kendi Build VM alt ağınızı getirme ve kendi ACI alt ağınızı getirme.
  • Aşağıdaki alanlar dahil olmak üzere özelliği güncelleştirme vmProfile desteği eklendi:
    • vmSize
    • osDiskSizeGB
    • userAssignedIdentities
    • vnetConfig
      • subnetId
      • containerInstanceSubnetId özelliği hakkında vmProfile daha fazla bilgi için bkz . vmProfile.

API'nin 2024-02-01 sürümünde yapılan değişiklikler , tüm alanlar için büyük/küçük harf duyarlılığını zorlayan hataya neden olan bir değişiklik sağlar. Bu, API isteklerinizdeki harfleri büyük harfe çevirmenin tam olarak beklenen biçimle eşleşmesi gerektiği anlamına gelir. Azure Image Builder'ın API sürümü 2024-02-01 ve ötesine yanlış durum veya tanınmayan alanlarla bir API isteği gönderirseniz, hizmet bunu reddeder. İsteğin geçersiz olduğunu belirten bir hata yanıtı alırsınız. Daha fazla bilgi için bkz . Hataya Neden Olan Değişiklik: Büyük/Küçük Harf Duyarlılığı.

Sürüm 2023-07-01

Çok Yakında

Azure İşlem Galerisi dağıtım hedeflerini güncelleştirme desteği.

Değişiklik

Yeni errorHandling özellik. Bu özellik, kullanıcılara görüntü oluşturma işlemi sırasında hataların nasıl işlendiği üzerinde daha fazla denetim sağlar. Daha fazla bilgi için bkz. errorHandling

Sürüm 2022-07-01

İyileştirmeler

  • Görüntü şablonunun kaynağı olarak Azure İşlem Galerisi'nde depolanan en son görüntü sürümünü kullanma desteği eklendi
  • Görüntü dağıtımları için sürüm numaraları oluşturma desteğine eklendi versioning . Daha fazla bilgi için bkz . özellikler: sürüm oluşturma
  • Azure İşlem Galerisi'ne dağıtıldığında bölge başına yapılandırma desteği eklendi. Daha fazla bilgi için bkz . Distribute:targetRegions
  • Yeni 'Dosya' doğrulama türü eklendi. Daha fazla bilgi için bkz. özellikleri doğrulama
  • VHD'ler artık özel depolama hesabındaki bir özel bloba veya kapsayıcıya dağıtılabilir. Daha fazla bilgi için bkz . Dağıtma: VHD
  • Görüntü şablonunun kaynağı olarak Doğrudan Paylaşılan Galeri görüntüsü kullanma desteği eklendi

Değişiklik

  • replicationRegions artık galeri dağıtımları için kullanım dışı bırakılmıştır. Daha fazla bilgi için gallery-replicated-regions kullanın
  • VHD'ler artık özel depolama hesabındaki bir özel bloba veya kapsayıcıya dağıtılabilir
  • targetRegions dizisi eklendi ve yalnızca "SharedImage" türüne dağıtılmış olarak uygulandı. hakkında targetRegionsdaha fazla bilgi için bkz. Azure İşlem Galerisi
  • Görüntü şablonunun kaynağı olarak Doğrudan Paylaşılan Galeri görüntüsü kullanma desteği eklendi. Doğrudan Paylaşılan Galeri şu anda önizleme aşamasındadır.
  • Tetikleyiciler artık otomatik görüntü derlemelerini ayarlamak için genel önizlemede kullanılabilir. Daha fazla bilgi için bkz . AIB tetikleyicilerini kullanma

Sürüm 2022-02-14

İyileştirmeler

Sürüm 2021-10-01

Hataya neden olan değişiklik

API sürüm 2021-10-01, gelecekteki her API sürümünün parçası olacak hata şemasında bir değişiklik sağlar. Azure VM Görüntü Oluşturucusu otomasyonlarınız varsa API 2021-10-01 veya sonraki bir sürüme geçiş yaptığınızda yeni hata çıkışına dikkat edin. En son API sürümüne geçtikten sonra önceki bir sürüme geri dönmemenizi öneririz çünkü önceki hata şemasını oluşturmak için otomasyonunuzu yeniden değiştirmeniz gerekir. Gelecek sürümlerde hata şemasını yeniden değiştirebileceğimizi tahmin etmeyeceğiz.

Sürüm 2020-02-14 ve öncesi için hata çıktısı
{ 
  "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." 
}
Sürüm 2021-10-01 ve üzeri için hata çıktısı
{ 
  "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." 
  }
}

İyileştirmeler

Sürüm 2020-02-14

İyileştirmeler

  • Aşağıdaki kaynaklardan görüntü oluşturma desteği eklendi:
    • Yönetilen görüntü
    • Azure Compute Gallery
    • Platform Görüntü Deposu (Platform Görüntüsü Satın Alma Planı dahil)
  • Aşağıdaki özelleştirmeler için destek eklendi:
    • Kabuk (Linux): Betik veya satır içi
    • PowerShell (Windows): Betik veya satır içi, yükseltilmiş çalıştır, sistem olarak çalıştır
    • Dosya (Linux ve Windows)
    • Windows Yeniden Başlatma (Windows)
    • Windows Update (Windows): Arama ölçütleri, filtreler ve güncelleştirme sınırı
  • Aşağıdaki dağıtım türleri için destek eklendi:
    • VHD (sanal sabit disk)
    • Yönetilen görüntü
    • Azure Compute Gallery
  • Diğer özellikler:
    • Müşterilerin kendi sanal ağlarını kullanmasına yönelik destek eklendi
    • Müşterilerin derleme VM'sini özelleştirmeleri için destek eklendi (VM boyutu, işletim sistemi disk boyutu)
    • Kullanıcı tarafından atanan Microsoft Windows Installer (MSI) desteği eklendi (özelleştirme/dağıtma adımları için)
    • 2. Nesil görüntüleri için destek eklendi

API'leri önizleme

Aşağıdaki API'ler kullanım dışıdır, ancak yine de desteklenir:

  • Sürüm 2019-05-01-preview

Sonraki adımlar

VM Görüntü Oluşturucusu hakkında daha fazla bilgi edinin.