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

Ş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şturucu hizmeti için tüm önemli API değişikliklerini ve özellik güncelleştirmelerini içerir.

Güncelleştirmeler

Mart 2026

Uyumsuzluk Yaratabilecek Değişiklik: Sanal Ağ Varsayılan Davranışı

31 Mart 2026'nın ardından, Azure'daki yeni sanal ağlar varsayılan olarak varsayılan giden erişim bağlantısını kullanamayacak olan özel alt ağlar oluşturur. Bu değişiklik, görüntü şablonlarında (subnetId alanı veya containerInstanceSubnetId alanı) kendi alt ağlarını belirten AIB müşterilerini etkileyebilir. Derleme veya doğrulama VM'lerinin giden erişime ihtiyacı varsa, subnetId alanında belirtilen alt ağın giden erişimi etkinleştirilmiş olmalıdır. Ayrıca, containerInstanceSubnetId alanında belirtilen alt ağ, şablon referansında açıklandığı gibi giden erişim etkinleştirilmiş olmalıdır. Tüm ayrıntılar için resmi güncelleştirmeye bakın.

Emekliye Ayrılma: Azure yönetilmeyen diskler

Azure yönetilmeyen Azure disklerini kullanımdan kaldırıyor. Bu değişiklik, görüntüleri VHD olarak dağıtmak için AIB kullanan ve ardından yeni VM'ler sağlamak için bu VHD'leri kullanan AIB müşterilerinin bir alt kümesini etkiler. Yönetilmeyen disklerin kullanımdan kaldırılmasından sonra, VHD yapıtları oluşturmak için AIB'yi kullanmaya devam edebilirsiniz, ancak bu VHD'ler yeni VM'ler sağlayamaz. Tüm ayrıntılar — kapsam, zaman çizelgeleri ve önerilen hafifletme adımları da dahil olmak üzere — için resmi belgelere bakın: Azure yönetilmeyen disklerinizi 31 Mart 2026'ya kadar taşıyın

Eylül 2024

Görüntü şablonu derlemesi art arda birkaç kez başarısız olursa tetikleyiciler aracılığıyla otomatik görüntü oluşturma devre dışı bırakılır. Bu devre dışı bırakma, gereksiz derleme hatalarını önler.

Yine de görüntü şablonunu el ile oluşturabilirsiniz. El ile derleme başarılı olduktan sonra otomatik tetikleyiciler yeniden etkinleştirilir.

Bu davranış, görüntü şablonu kaynağı için hangi API sürümünü kullandığınızdan bağımsız olarak aynıdır.

Mayıs 2024

Uyumluluğu bozan değişiklik: Büyük/küçük harf duyarlılığı

21 Mayıs 2024 itibarıyla VM Görüntü Oluşturucu API'sinin 2024-02-01 ve sonraki sürümleri tüm alanlar için büyük/küçük harf duyarlılığını zorunlu kılabilir. API isteklerinizdeki harfleri büyük harfe çevirme işlemi tam olarak beklenen biçimle eşleşmelidir.

Önemli

VM Görüntü Oluşturucusu'nun mevcut bir kullanıcısıysanız, bu değişiklik mevcut kaynaklarınızı etkilemez . Büyük/küçük harf duyarlılığının uygulanması yalnızca API sürüm 2024-02-01 ve üzerini kullanan yeni oluşturulan kaynaklar için geçerlidir. Mevcut kaynaklarınız herhangi bir değişiklik olmadan beklendiği gibi çalışmaya devam ediyor.

Büyük/küçük harf duyarlılığıyla ilgili herhangi bir sorunla karşılaşırsanız, yönergeler için güncelleştirilmiş VM Görüntü OluşturucuSU API belgelerine bakın.

Daha önce VM Görüntü Oluşturucu API'si büyük/küçük harf kullanımı konusunda daha esnekti. Bundan sonra, kesinlik çok önemlidir. API çağrıları yaparken alan adları, parametreler ve değerler için doğru büyük/küçük harf kullanımını kullandığınızdan emin olun. Örneğin, bir alan adı vmBoot ise, vmBoot (ve VMBoot veya vmboot değil) kullanmanız gerekir.

Vm Image Builder API'sinin 2024-02-01 veya sonraki bir sürümüne yanlış büyük/küçük harf 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ıyorsunuz. Hata şu örneğe benzer:

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" bahseder ve sizi resmi belgelere yönlendirir: Azure VM Görüntü Oluşturucusu Bicep veya Azure Resource Manager JSON şablonu oluşturma.

Not

VM Görüntü Oluşturucusu hizmetine API çağrıları yaparken her zaman Swagger belgelerine başvurun. Bu belge, VM Görüntü Oluşturucu API belirtimleri için kesin bir gerçek kaynağı görevi görür. 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ı her VM Image Builder API'sine ilişkin kesin ayrıntıları içerir. Bu ayrıntılar, hizmete doğru çağrılar yaptığınızdan emin olmanıza yardımcı olur.

Aşağıdaki belge değişiklikleri API sürüm 2024-02-01'deki alan adlarına uyacak şekilde yapılmıştır.

Azure VM Görüntü Oluşturucusu Bicep veya Azure Resource Manager JSON şablonu oluşturma belgelerinde:

  • Güncelleştirilen alanlar:

    • vmboot olan birkaç ifade vmBoot ile değiştirildi.
    • Bir kez imageVersionIDimageVersionId ile değiştirildi.

  • Alan kaldırıldı:

    • apiVersion: API'de açıkça belirtilmediğinden bu alanın isteklerinize eklenmesini önlemenizi öneririz. JSON şablonunuza dahil etmeniz, görüntü derlemenizde hatalara yol açabilir.

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

  • Alan güncelleştirildi:

    • Bir kez VirtualNetworkConfigvnetConfig ile değiştirildi.

  • Kaldırılan alanlar:

    • subnetName özelliğinde vnetConfig : Bu alan kullanım dışı bırakıldı. Yeni alan şeklindedir subnetId.
    • resourceGroupName özelliğinde vnetConfig : Bu alan kullanım dışı bırakıldı. Yeni alan şeklindedir subnetId.

Eski bir VM Image Builder API sürümüne sabitleme

Yeni büyük/küçük harf duyarlılığı kuralları nedeniyle görüntü şablonlarınızdaki özelliklerde değişiklik yapmaktan kaçınmak istiyorsanız 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 sabitleme, herhangi bir değişiklik yapmadan tanıdık davranışı kullanmaya devam etmenizi sağlar.

Önemli

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

  • Eski API sürümleri sonunda kullanım dışı bırakılabilir.
  • Eski bir API sürümüne sabitleyerek, yeni sürümlerde sunulan en son özellikleri ve geliştirmeleri kaçıracaksınız. Bu geliştirmeler genellikle performansı, güvenliği ve işlevselliği geliştirir.

Görüntü şablonu oluştururken veya güncelleştirirken mevcut şablonlarınızla uyumluluğu sağlamak için, hizmete yönelik çağrınıza parametresini api-version ekleyerek istenen API sürümünü belirtin. Örneğin:

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

Kodunuzu test etme

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

VM Görüntü Oluşturucusu, Azure Container Instances aracılığıyla Yalıtılmış Görüntü Derlemelerini aşamalı olarak etkinleştiriyor. Dağıtımın 2024 başlarında bitması 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 yoktur.

Hazırlık kaynak grubunda geçici olarak görünen farklı bir Azure kaynakları kümesini gözlemleyebilirsiniz. Gerçek derlemelerinizi veya VM Görüntü Oluşturucusu ile etkileşim kurma şeklinizi etkilemez. Daha fazla bilgi için bkz. Yalıtılmış Görüntü Derlemeleri.

Yalıtılmış Görüntü Derlemelerini kullanmak için şunları yaptığınızdan emin olun:

  • Aboneliğiniz Microsoft.ContainerInstance sağlayıcısı için kayıtlıdır.
  • Azure Container Instances kaynaklarının dağıtımını engelleyen ilke yoktur.
  • Azure Container Instances kaynakları için kota kullanılabilir.

Nisan 2023

VM Görüntü Oluşturucusu için yeni portal işlevselliği eklendi. Azure portalında Görüntü Şablonları'nı arayın ve oluştur'u seçin. Portalın içinde özel görüntüler oluşturmaya ve doğrulamaya başlamak için bu şablon yapılandırmasını da kullanabilirsiniz.

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ırmak için yeni autoRun özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz . Özellikler: autoRun.

  • Vm Görüntü Oluşturucu hizmetinin görüntü derlemesi sırasında hazırlama kaynak grubunda oluşturduğu kaynaklara etiket uygulamak için yeni managedResourceTags özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz . Özellikler: managedResourceTags.

  • Yalıtılmış Görüntü Derlemeleri için Azure Container Instances'ın dağıtılacağı bir alt ağ belirtmek için yeni containerInstanceSubnetId özelliğini kullanabilirsiniz. Bu alanı yalnızca subnetId belirttiğinizde belirtebilirsiniz. Bu alan, içinde subnetIdbelirtilen alt ağ ile aynı sanal ağda olmalıdır. Daha fazla bilgi için kendi derleme VM alt ağınızı ve kendi Container Instances alt ağınızı getirme bölümüne bakın.

  • Bu sürüm, vmProfile özelliğini güncellemeyi destekler ve aşağıdaki alanları içerir:

    • vmSize
    • osDiskSizeGB
    • userAssignedIdentities
    • vnetConfig
      • subnetId
      • containerInstanceSubnetId

    özelliği hakkında vmProfile daha fazla bilgi için bkz. vmProfile.

Değişiklikler

API sürümü 2024-02-01, tüm alanlar için büyük/küçük harf hassasiyetini zorunlu kılan ve işleyişi değiştiren önemli bir yenilik getiriyor. API isteklerinizdeki harfleri büyük harfe çevirme işlemi tam olarak beklenen biçimle eşleşmelidir. VM Image Builder API'sinin 2024-02-01 veya sonraki bir sürümüne hatalı bir 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ıyorsunuz. Daha fazla bilgi için bu makaledeki Önemli değişiklik: Büyük/küçük harf duyarlılığı bölümüne bakın.

Sürüm 2023-07-01

Değişiklikler

Yeni errorHandling özellik, 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

  • Bu sürüm, görüntü şablonunun kaynağı olarak Azure İşlem Galerisi'nde depolanan en son görüntü sürümünü kullanma desteği ekler.
  • Bu sürüm, versioning'yi görüntü dağıtımları için sürüm numaralarının oluşturulmasını sağlamak üzere ekler. Daha fazla bilgi için bkz . Özellikler: versioning.
  • Bu sürüm, Azure İşlem Galerisi'ne dağıtırken bölge başına yapılandırma desteği ekler. Daha fazla bilgi için bkz . Distribute: targetRegions.
  • Bu sürüm yeni File bir doğrulama türü ekler. Daha fazla bilgi için bkz . Özellikler: validate.
  • Artık sanal sabit diskleri (VHD) özel bir depolama hesabındaki özel bloba veya kapsayıcıya dağıtabilirsiniz. Daha fazla bilgi için bkz . Dağıtma: VHD.
  • Bu sürüm, görüntü şablonunun kaynağı olarak doğrudan paylaşılan galeri görüntüsü kullanma desteği ekler.

Değişiklikler

Sürüm 2022-02-14

İyileştirmeler

Sürüm 2021-10-01

Uyum bozan 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şturucu otomasyonlarınız varsa, API sürümünden 2021-10-01 veya sonrasına 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. Geri dönerseniz, önceki hata şemasını oluşturmak için otomasyonunuzu yeniden değiştirmeniz gerekir. Hata şemasının gelecek sürümlerde yeniden değişmesini beklemiyoruz.

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 Hesaplama Galerisi
    • Platform Görüntü Deposu (Platform Görüntü 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, yetkili modda çalıştır, sistem hesabıyla ç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
    • Yönetilen görüntü
    • Azure Hesaplama Galerisi
  • 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 yönetilen kimlikler için destek eklendi (özelleştirme/dağıtma adımları için).
  • 2. Nesil görüntüler için destek eklendi.

Önizleme API'si

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

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

İlgili içerik

  • Last updated on