حزم ملحق Azure Functions

2025-06-01

توضح هذه المقالة كيفية تمكين مجموعات الملحقات للتعليمات البرمجية للدالة الخاصة بك من استخدام كافة المشغلات والروابط التي تدعمها Azure Functions. يمكنك أيضا التعرف على مستويات الدعم المختلفة والنهج لتطبيقاتك عند استخدام حزم الملحقات.

تنطبق هذه المقالة فقط على مطوري Azure Functions باستخدام لغات non-.NET. لمعرفة كيفية إضافة ملحقات الربط مباشرة إلى تطبيقات وظائف C#، راجع تسجيل ملحقات ربط وظائف Azure.

نظرة عامة

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

عند إنشاء مشروع Azure Functions من قالب non-.NET، يتم بالفعل تمكين حزم الملحقات في ملف host.json التطبيق.

تعريف مرجع مجموعة الملحقات

يمكنك تعريف مرجع حزمة ملحق في ملف مشروع host.json عن طريق إضافة extensionBundle مقطع، كما في هذا المثال:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

الخصائص التالية متوفرة في extensionBundle:

مال الوصف

id مساحة الاسم لحزم ملحقات Microsoft Azure Functions.

version نطاق إصدار الحزمة المراد تثبيتها. يقوم وقت تشغيل الوظائف دائماً باختيار الحد الأقصى للإصدار المسموح به المحدد بواسطة نطاق الإصدار أو الفاصل الزمني. على سبيل المثال، version يسمح نطاق القيمة لكافة [4.0.0, 5.0.0) إصدارات المجموعة من 4.0.0 حتى 5.0.0 ولكن ليس بما في ذلك. لمزيد من المعلومات، راجع تدوين الفاصل لتحديد نطاقات الإصدار .

مال	الوصف
`id`	مساحة الاسم لحزم ملحقات Microsoft Azure Functions.
`version`	نطاق إصدار الحزمة المراد تثبيتها. يقوم وقت تشغيل الوظائف دائماً باختيار الحد الأقصى للإصدار المسموح به المحدد بواسطة نطاق الإصدار أو الفاصل الزمني. على سبيل المثال، `version` يسمح نطاق القيمة لكافة `[4.0.0, 5.0.0)` إصدارات المجموعة من 4.0.0 حتى 5.0.0 ولكن ليس بما في ذلك. لمزيد من المعلومات، راجع تدوين الفاصل لتحديد نطاقات الإصدار .

حزم الملحقات المدعومة

يسرد هذا الجدول جميع Microsoft.Azure.Functions.ExtensionBundle إصدارات المجموعة وحالة الدعم الحالية.

إصدار المجموعة	الإصدار في host.json	حالة الدعم	تاريخ انتهاء الدعم
4.x	`[4.0.0, 5.0.0)`	نشط	لم يتم تحديده بعد
3.x	`[3.3.0, 4.0.0)`	مهملة	05/30/2026
2.x	`[2.*, 3.0.0)`	مهملة	05/30/2026
1.x	`[1.*, 2.0.0)`	مهملة	05/30/2026

يتم تعريف حزم الملحقات الافتراضية باستخدام نطاقات الإصدار. حدد إصدار الحزمة لمشاهدة ملف تعريف extensions.json المستخدم لإنشاء إصدار مجموعة الملحقات الرئيسي الحالي.

لمزيد من المعلومات، راجع نهج الدعم.

اعتبارات حزم الملحقات

ضع هذه الاعتبارات في الاعتبار عند العمل مع حزم الملحقات:

عندما يكون ذلك ممكنا، يجب تعيين version قيمة نطاق في host.json من هذا الجدول، مثل [4.0.0, 5.0.0)، بدلا من تعريف نطاق مخصص.
استخدم أحدث نطاق إصدار للحصول على الأداء الأمثل للتطبيق والوصول إلى أحدث الميزات.
في حالة عدم إمكانية استخدام مجموعة ملحقات غير محتملة، يجب عليك بدلا من ذلك تثبيت الملحقات بشكل صريح.

معاينة مجموعات الملحقات

يتم الاحتفاظ بالإصدارات التجريبية من ملحقات الربط المحددة في مجموعة ملحقات المعاينة. تسمح لك مجموعة ملحقات المعاينة (Microsoft.Azure.Functions.ExtensionBundle.Preview) بالاستفادة من ملحقات المعاينة والسلوكيات الجديدة في الملحقات الموجودة قبل الإعلان عنها ك GA.

ضع هذه الاعتبارات في الاعتبار عند اختيار استخدام حزمة ملحق غير GA:

يمكن أن تتضمن حزم المعاينة ميزات لا تزال قيد التطوير وغير جاهزة بعد لاستخدام الإنتاج. وهي مخصصة للتقييم والاختبار في البيئات غير المنتجة.
تحدث التغييرات العاجلة بين إصدارات المعاينة دون إشعار مسبق، والتي يمكن أن تتضمن تغييرات على:
- تعريفات المشغل والربط
- الملحقات المضمنة في المعاينة
- خصائص الأداء والاستقرار
قد تتطلب تحديثات الأمان ترقية الإصدارات.
يجب اختبار حزم المعاينة بالكامل في البيئات غير المنتجة وتجنب استخدام حزم المعاينة في الإنتاج. عندما يتعين عليك استخدام حزمة معاينة في الإنتاج، اتخذ هذه الاحتياطات الإضافية:
- تثبيت الحزمة الخاصة بك إلى إصدار حزمة محددة تم اختبارها بشكل جيد بدلا من نطاق. يمنع التثبيت الترقية التلقائية لإصدار الحزمة قبل أن تكون لديك فرصة للتحقق من التحديث في بيئة غير منتجة.
- انقل تطبيقك إلى استخدام إصدار حزمة GA بمجرد توفر الوظيفة في إصدار حزمة مدعوم بالكامل.
للبقاء على علم بتحديثات المجموعة، بما في ذلك الانتقال من المعاينة إلى التوفر العام، يجب عليك:
- مراقبة إصدارات إصدار حزمة المعاينة في صفحة إصدار حزم الملحقات. - الإصدارات · Azure/azure-functions-extension-bundles
- مراقبة الوثائق المرجعية الخاصة بالملحق.
- راجع إصدارات حزمة NuGet لملحقات معاينة معينة تستخدمها.
- تعقب التحديثات أو التغييرات الهامة على سجلات التغيير المنشورة على NuGet.org لكل ملحق معاينة.

نهج الدعم

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

تتبع دورة دعم حزمة ملحق GA هذه المراحل المميزة:

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

يمكنك عرض إصدارات مجموعة الملحقات وملحقاتها المضمنة في مستودع GitHub لحزم ملحق Azure Functions. تم العثور على حزم .NET الفردية على https://nuget.org.

لمعرفة المزيد حول ملحقات الربط، راجع تسجيل ملحقات ربط وظائف Azure.

مشاركة عبر