مشاركة عبر


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

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

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

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

Extension bundles

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

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

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

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

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

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

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

Execution model Namespace
عملية عامل معزولة Microsoft.Azure.Functions.Worker.Extensions.*
In-process Microsoft.Azure.WebJobs.Extensions.*

توفر Azure Functions حزم ملحقات لمشاريع 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.

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