مشاركة عبر

ما الجديد في Azure VM Image Builder (AIB)

ينطبق على: ✔️ أجهزة ظاهرية بنظام التشغيل Linux ✔️ أجهزة ظاهرية بنظام التشغيل Windows ✔️ مجموعات التوسعة المرنة ✔️ مجموعات التوسعة الموحدة

تحتوي هذه المقالة على جميع تغييرات واجهة برمجة التطبيقات الرئيسية وتحديثات الميزات لخدمة Azure VM Image Builder.

التحديثات

مارس 2026

تغيير كسر: السلوك الافتراضي للشبكة الافتراضية

بعد 31 مارس 2026، ستبدأ الشبكات الافتراضية الجديدة في Azure افتراضيا في إنشاء شبكات فرعية خاصة لم تعد قادرة على استخدام الاتصال الافتراضي الصادر الخارجي. قد يؤثر هذا التغيير على عملاء AIB الذين يحددون شبكاتهم الفرعية في قوالب الصور الخاصة بهم (باستخدام subnetId الحقل أو containerInstanceSubnetId الحقل). إذا كانت أجهزة البناء أو التحقق تحتاج إلى وصول صادر، فيجب أن يكون لدى الشبكة الفرعية subnetId المحددة في الحقل وصول صادر. أيضا، يجب أن يكون لدى الشبكة الفرعية المحددة في containerInstanceSubnetId الحقل إمكانية الوصول الصادر كما هو موضح في مرجع القالب. للتفاصيل الكاملة، راجع التحديث الرسمي.

التقاعد: أقراص Azure غير المدارة

Azure is retiring Azure unmanaged disks. يؤثر هذا التغيير على مجموعة فرعية من عملاء AIB الذين يستخدمون AIB لتوزيع الصور كأقراص VHD ثم يستخدمون تلك الأقراص لتوفير أجهزة افتراضية جديدة. بعد تقاعد الأقراص غير المدارة، ستظل قادرا على استخدام AIB لإنشاء تشويلات VHD، لكن تلك الأقراص لن تتمكن من توفير أجهزة VD جديدة. للحصول على تفاصيل كاملة — بما في ذلك النطاق، والجداول الزمنية، وخطوات التخفيف الموصى بها — راجع الوثائق الرسمية: نقل أقراص Azure غير المدارة بحلول 31 مارس 2026

سبتمبر 2024

يتم إلغاء تنشيط الإنشاء التلقائي للصور عبر المشغلات إذا فشل إنشاء قالب الصورة عدة مرات متتالية. يتجنب إلغاء التنشيط هذا حالات فشل الإنشاء غير الضرورية.

لا يزال بإمكانك إنشاء قالب الصورة يدويا. بعد نجاح الإنشاء اليدوي، تتم إعادة تنشيط المشغلات التلقائية.

هذا السلوك هو نفسه بغض النظر عن إصدار واجهة برمجة التطبيقات الذي تستخدمه لمورد قالب الصورة.

مايو 2024

تغيير كسر: حساسية الحالة

اعتبارا من 21 مايو 2024، يفرض VM Image Builder API الإصدار 2024-02-01 والإصدارات الأحدث حساسية الحالة لجميع الحقول. يجب أن تتطابق الكتابة بالأحرف الكبيرة في طلبات واجهة برمجة التطبيقات تماما مع التنسيق المتوقع.

هام

إذا كنت مستخدما موجودا ل VM Image Builder، فلن يؤثر هذا التغيير على مواردك الحالية. ينطبق فرض حساسية الحالة فقط على الموارد التي تم إنشاؤها حديثا والتي تستخدم إصدار API 2024-02-01 والإصدارات الأحدث. تستمر مواردك الحالية في العمل كما هو متوقع دون أي تغييرات.

إذا واجهت أي مشاكل تتعلق بحساسية الحالة، فراجع وثائق واجهة برمجة تطبيقات منشئ صور الجهاز الظاهري المحدثة للحصول على إرشادات.

في السابق، كانت واجهة برمجة تطبيقات منشئ صور الجهاز الظاهري أكثر تسامحا من حيث الحالة. من الآن فصاعدا، الدقة أمر بالغ الأهمية. عند إجراء استدعاءات API، تأكد من استخدام الكتابة بالأحرف الكبيرة الصحيحة لأسماء الحقول والمعلمات والقيم. على سبيل المثال، إذا تمت تسمية vmBootحقل ، فيجب عليك استخدام vmBoot (ليس VMBoot أو vmboot).

إذا أرسلت طلب API إلى VM Image Builder API الإصدار 2024-02-01 أو أحدث مع حالة غير صحيحة أو حقول غير معروف، ترفضها الخدمة. تتلقى استجابة خطأ تشير إلى أن الطلب غير صالح. يبدو الخطأ مشابها لهذا المثال:

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.

تشير رسالة الخطأ إلى "حقل غير معروف" وتوجهك إلى الوثائق الرسمية: إنشاء قالب Bicep منشئ صور Azure VM أو Azure Resource Manager JSON.

إشعار

عند إجراء استدعاءات API إلى خدمة VM Image Builder، ارجع دائما إلى وثائق Swagger. تعمل هذه الوثائق كمصدر نهائي للحقيقة لمواصفات واجهة برمجة تطبيقات VM Image Builder. على الرغم من تحديث الوثائق العامة لتضمين الكتابة بالأحرف الكبيرة المناسبة وأسماء الحقول قبل إصدار واجهة برمجة التطبيقات، يحتوي تعريف Swagger على تفاصيل دقيقة حول كل واجهة برمجة تطبيقات منشئ صور الجهاز الظاهري. تساعد هذه التفاصيل في التأكد من إجراء مكالمات إلى الخدمة بشكل صحيح.

تم إجراء تغييرات الوثائق التالية لمطابقة أسماء الحقول في إصدار واجهة برمجة التطبيقات 2024-02-01.

في وثائق قالب Create an Azure VM Image Builder Bicep أو Azure Resource Manager JSON :

  • تم تحديث الحقول:

    • استبدلت العديد من إشارات ب vmbootvmBoot.
    • تم استبدال إشارة واحدة من imageVersionID ب imageVersionId.

  • تمت إزالة الحقل:

    • apiVersion: نوصي بتجنب تضمين هذا الحقل في طلباتك لأنه غير محدد بشكل صريح في واجهة برمجة التطبيقات. قد يؤدي تضمينه في قالب JSON إلى حدوث أخطاء في إنشاء الصورة.

في وثائق خيارات شبكة Azure VM Image Builder:

  • تم تحديث الحقل:

    • تم استبدال إشارة واحدة من VirtualNetworkConfig ب vnetConfig.

  • تمت إزالة الحقول:

    • subnetName في الخاصية vnetConfig : هذا الحقل مهمل. الحقل الجديد هو subnetId.
    • resourceGroupName في الخاصية vnetConfig : هذا الحقل مهمل. الحقل الجديد هو subnetId.

التثبيت إلى إصدار أقدم من واجهة برمجة تطبيقات منشئ صور الجهاز الظاهري

إذا كنت ترغب في تجنب إجراء تغييرات على الخصائص في قوالب الصور بسبب قواعد حساسية حالة الأحرف الجديدة، فلديك خيار تثبيت استدعاءات واجهة برمجة تطبيقات Azure VM Image Builder بإصدار واجهة برمجة تطبيقات سابق. يسمح لك هذا التثبيت بالاستمرار في استخدام السلوك المألوف دون أي تعديلات.

هام

يمكن أن يوفر التثبيت إلى إصدار أقدم من واجهة برمجة تطبيقات منشئ صور الجهاز الظاهري التوافق مع القوالب الموجودة، ولكننا لا نوصي بذلك بسبب العوامل التالية:

  • قد يتم إهمال إصدارات واجهة برمجة التطبيقات القديمة في النهاية.
  • من خلال التثبيت إلى إصدار واجهة برمجة تطبيقات أقدم، تفوتك أحدث الميزات والتحسينات المقدمة في الإصدارات الأحدث. غالبا ما تحسن هذه التحسينات الأداء والأمان والوظائف.

لضمان التوافق مع القوالب الموجودة عند إنشاء قالب صورة أو تحديثه، حدد إصدار واجهة برمجة التطبيقات المطلوب عن طريق تضمين المعلمة api-version في استدعائك للخدمة. على سبيل المثال:

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

اختبار التعليمات البرمجية الخاصة بك

بعد تثبيت إصدار API الأقدم، اختبر التعليمات البرمجية الخاصة بك للتحقق من أنها تتصرف كما هو متوقع. تأكد من أن القوالب الموجودة تستمر في العمل بشكل صحيح.

نوفمبر 2023

يقوم VM Image Builder بتمكين إصدارات الصور المعزولة عبر مثيلات حاوية Azure بطريقة مرحلي. ومن المتوقع أن ينتهي الإطلاق بحلول أوائل عام 2024. تستمر قوالب الصور الموجودة في العمل، ولا يوجد أي تغيير في الطريقة التي تنشئ بها قوالب صور جديدة أو تنشئها.

قد تلاحظ مجموعة مختلفة من موارد Azure العابرة التي تظهر مؤقتا في مجموعة الموارد المرحلية. لا يؤثر ذلك على البنيات الفعلية أو الطريقة التي تتفاعل بها مع VM Image Builder. لمزيد من المعلومات، راجع إنشاءات الصور المعزولة.

لاستخدام Isolated Image Builds، تأكد مما يلي:

  • تم تسجيل اشتراكك للموفر Microsoft.ContainerInstance .
  • لا توجد نهج تمنع نشر موارد مثيلات حاوية Azure.
  • تتوفر الحصة النسبية لموارد مثيلات حاوية Azure.

أبريل 2023

تمت إضافة وظيفة مدخل جديدة ل VM Image Builder. ابحث عن قوالب الصور في مدخل Microsoft Azure، ثم حدد إنشاء. يمكنك أيضا استخدام تكوين القالب هذا للبدء في إنشاء الصور المخصصة والتحقق من صحتها داخل المدخل.

إصدارات واجهة برمجة التطبيقات

الإصدار 2024-02-01

التحسينات

  • يمكنك استخدام الخاصية الجديدة autoRun لتشغيل إنشاء الصورة على إنشاء القالب أو تحديثه. لمزيد من المعلومات، راجع الخصائص: autoRun.

  • يمكنك استخدام الخاصية الجديدة managedResourceTags لتطبيق العلامات على الموارد التي تنشئها خدمة VM Image Builder في مجموعة موارد التقسيم المرحلي أثناء إنشاء الصورة. لمزيد من المعلومات، راجع الخصائص: managedResourceTags.

  • يمكنك استخدام الخاصية الجديدة containerInstanceSubnetId لتحديد شبكة فرعية سيتم نشر مثيلات حاوية Azure عليها لإنشاءات الصور المعزولة. يمكنك تحديد هذا الحقل فقط إذا قمت بتحديد subnetId. يجب أن يكون هذا الحقل على نفس الشبكة الظاهرية مثل الشبكة الفرعية المحددة في subnetId. لمزيد من المعلومات، راجع إحضار الشبكة الفرعية للجهاز الظاهري للبناء الخاص بك وإحضار الشبكة الفرعية لمثيلات الحاوية الخاصة بك.

  • يضيف هذا الإصدار دعما لتحديث الخاصية vmProfile ، بما في ذلك الحقول التالية:

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

    لمزيد من المعلومات حول الخاصية vmProfile ، راجع vmProfile.

التغييرات

يقدم إصدار واجهة برمجة التطبيقات 2024-02-01 تغييرا فاصلا يفرض حساسية الحالة لجميع الحقول. يجب أن تتطابق الكتابة بالأحرف الكبيرة في طلبات واجهة برمجة التطبيقات تماما مع التنسيق المتوقع. إذا أرسلت طلب API إلى VM Image Builder API الإصدار 2024-02-01 أو أحدث بحالة غير صحيحة أو حقول غير معروف، ترفضها الخدمة. تتلقى استجابة خطأ تشير إلى أن الطلب غير صالح. لمزيد من المعلومات، راجع كسر التغيير: حساسية الحالة في هذه المقالة.

الإصدار 2023-07-01

التغييرات

تمنحك الخاصية الجديدة errorHandling مزيدا من التحكم في كيفية معالجة الأخطاء أثناء عملية إنشاء الصور. لمزيد من المعلومات، راجع errorHandling.

الإصدار 2022-07-01

التحسينات

  • يضيف هذا الإصدار دعما لاستخدام أحدث إصدار صورة مخزن في Azure Compute Gallery كمصدر لقالب الصورة.
  • يضيف versioning هذا الإصدار لدعم إنشاء أرقام الإصدار لتوزيعات الصور. لمزيد من المعلومات، راجع الخصائص: versioning.
  • يضيف هذا الإصدار دعما للتكوين لكل منطقة عند التوزيع إلى معرض حوسبة Azure. لمزيد من المعلومات، راجع توزيع: targetRegions.
  • يضيف هذا الإصدار نوع التحقق من الصحة الجديد File . لمزيد من المعلومات، راجع الخصائص: validate.
  • يمكنك الآن توزيع الأقراص الثابتة الظاهرية (VHDs) على كائن ثنائي كبير الحجم مخصص أو حاوية في حساب تخزين مخصص. لمزيد من المعلومات، راجع توزيع: VHD.
  • يضيف هذا الإصدار دعما لاستخدام صورة معرض مشترك مباشر كمصدر لقالب الصورة.

التغييرات

إصدار 2022-02-14

التحسينات

إصدار 2021-10-01

كسر التغيير

يقدم إصدار API 2021-10-01 تغييرًا في مخطط الأخطاء والذي سيكون جزءًا من كل إصدار مستقبلي لواجهة برمجة التطبيقات. إذا كان لديك أي عمليات تشغيل تلقائية لـ Azure VM Image Builder، فكن على دراية بمخرجات الخطأ الجديدة عند التبديل إلى إصدار API 2021-10-01 أو أحدث.

نوصي، بعد التبديل إلى أحدث إصدار من واجهة برمجة التطبيقات، بعدم العودة إلى إصدار سابق. إذا قمت بالرجوع، يتعين عليك تغيير التنفيذ التلقائي مرة أخرى لإنتاج مخطط الخطأ السابق. لا نتوقع أن يتغير مخطط الخطأ مرة أخرى في الإصدارات المستقبلية.

إخراج الخطأ للإصدار 2020-02-14 والإصدارات السابقة
{ 
  "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." 
}
إخراج الخطأ للإصدار 2021-10-01 والإصدارات الأحدث
{ 
  "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." 
  }
}

التحسينات

إصدار 2020-02-14

التحسينات

  • دعم إضافي لإنشاء الصور من المصادر التالية:
    • صورة مُدارة
    • معرض Azure Compute
    • مستودع صور النظام الأساسي (بما في ذلك خطة شراء صورة النظام الأساسي)
  • دعم إضافي للتخصيصات التالية:
    • Shell (Linux) - برنامج نصي أو مُضمن
    • PowerShell (Windows) - برنامج نصي أو مُضمن، تشغيل غير مقيد، تشغيل كنظام
    • ملف (Linux وWindows)
    • إعادة تشغيل Windows (Windows)
    • تحديث Windows (Windows): معايير البحث وعوامل التصفية وحدود التحديث
  • تمت إضافة دعم أنواع التوزيع التالية:
    • VHD
    • صورة مُدارة
    • معرض Azure Compute
  • دعم إضافي للعملاء لاستخدام شبكتهم الظاهرية الخاصة.
  • دعم إضافي للعملاء لتخصيص الجهاز الظاهري للبناء (حجم الجهاز الظاهري وحجم قرص نظام التشغيل).
  • دعم إضافي للهويات المدارة المعينة من قبل المستخدم (لتخصيص/توزيع الخطوات).
  • دعم إضافي لصور الجيل 2.

معاينة واجهة برمجة التطبيقات

تم إهمال واجهة برمجة التطبيقات التالية ولكن لا تزال مدعومة:

  • الإصدار 2019-05-01- لمعاينة

المحتوى ذو الصلة

  • Last updated on