مشاركة عبر


تسجيل ملحقات ربط Azure Functions

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

تستخدم مشاريع مكتبة فئة .NET ملحقات الربط المثبتة في المشروع كحزم NuGet.

تسمح مجموعات الملحقات للتطبيقات non-.NET باستخدام ملحقات الربط دون الحاجة إلى التفاعل مع البنية الأساسية ل .NET.

مجموعات الملحقات

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

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

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

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

تركيب الملحقات بشكل صريح

بالنسبة لمشاريع مكتبة فئة C# المحولة برمجيا، يمكنك تثبيت حزم NuGet للملحقات التي تحتاجها كما تفعل عادة في تطبيقاتك. لمزيد من المعلومات، راجع دليل مطور Visual Studio Code أو دليل مطور Visual Studio.

تأكد من الحصول على الحزمة الصحيحة لأن مساحة الاسم تختلف اعتمادا على نموذج التنفيذ:

نموذج التنفيذ مساحة الاسم
عملية عامل معزولة Microsoft.Azure.Functions.Worker.Extensions.*
قيد التنفيذ Microsoft.Azure.WebJobs.Extensions.*

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

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

  1. قم بإزالة مرجع مجموعة الملحقات من ملف host.json .

  2. استخدم الأمر func extensions install في Azure Functions Core Tools لإنشاء الملف extensions.csproj المطلوب في جذر المشروع المحلي.

    لتطوير المدخل فقط، تحتاج إلى إنشاء ملف extensions.csproj يدويا في جذر تطبيق الوظائف في Azure. لمعرفة المزيد، راجع تثبيت الإضافات يدوياً .

  3. قم بتحرير ملف extensions.csproj عن طريق إضافة PackageReference عنصر بشكل صريح لكل ملحق ربط وإصدار محددين يتطلبهما تطبيقك.

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

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

الخطوات التالية