تسجيل ملحقات ربط Azure Functions
بدءًا من Azure Functions الإصدار 2.x، يتضمن functions runtime فقط مشغلات HTTP والمؤقت بشكل افتراضي. تتوفر المشغلات والروابط الأخرى كحزم منفصلة.
تستخدم تطبيقات وظائف مكتبة الفئات .NET الروابط المثبتة في المشروع كحزم NuGet. تسمح حزم الملحق للتطبيقات غير المرتبطة بوظائف NET. باستخدام نفس الارتباطات دون الحاجة إلى التعامل مع بنية NET. الأساسية.
يشير الجدول التالي إلى متى وكيف تقوم بتسجيل الروابط.
| بيئة التطوير | التسجيل في Functions الإصدار 1.x |
التسجيل في Functions الإصدار 2.x أو أحدث |
|---|---|---|
| مدخل Azure | تلقائي | تلقائي* |
| لغات Non-.NET | تلقائي | استخدام مجموعات الملحقات (موصى بها) أو تثبيت الملحقات بشكل صريح |
| مكتبة الفئات C# باستخدام Visual Studio | استخدام أدوات NuGet | استخدام أدوات NuGet |
| مكتبة الفئات C# باستخدام Visual Studio Code | غير متوفر | استخدام .NET Core CLI استخدام حزمة تطوير C# |
* يستخدم المدخل حزم الملحقات، بما في ذلك البرنامج النصي C#.
مجموعات الملحقات
بشكل افتراضي، توفر مجموعات الملحقات دعما ملزما للوظائف بهذه اللغات:
- Java
- JavaScript
- PowerShell
- Python
- البرنامج النصي C#
- أخرى (معالجات مخصصة)
في حالات نادرة حيث لا يمكن استخدام حزم الملحقات، يمكنك تثبيت ملحقات الربط بشكل صريح مع مشروع تطبيق الوظائف. حزم الملحق مدعومة للإصدار 2.x والإصدار الأحدث من وقت تشغيل الوظائف.
حزم الملحقات هي طريقة لإضافة مجموعة محددة مسبقا من ملحقات الربط المتوافقة إلى تطبيق الوظائف. يتم إصدار مجموعات الملحقات. يحتوي كل إصدار على مجموعة محددة من ملحقات الربط التي تم التحقق من أنها تعمل معًا. حدد إصدار المجموعة استنادًا إلى الملحقات التي تحتاج إليها في تطبيقك.
عند إنشاء مشروع بخلاف وظائف NET. من الأدوات أو في المدخل، يتم تمكين حزم الملحقات بالفعل في ملف host.json للتطبيق.
يتم تحديد مرجع حزمة الملحقات بواسطة القسم extensionBundle في host.json على النحو التالي:
{
"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 ولكن ليس بما في ذلك. لمزيد من المعلومات، راجع تدوين الفاصل لتحديد نطاقات الإصدار . |
يسرد الجدول التالي نطاقات الإصدار المتوفرة حاليا من حزم Microsoft.Azure.Functions.ExtensionBundle الافتراضية والارتباطات إلى الملحقات التي تتضمنها.
| إصدار المجموعة | الإصدار في host.json | ملحقات مضمنة |
|---|---|---|
| 1.x | [1.*, 2.0.0) |
راجع extensions.json المستخدمة لإنشاء الحزمة. |
| 2.x | [2.*, 3.0.0) |
راجع extensions.json المستخدمة لإنشاء الحزمة. |
| 3.x | [3.3.0, 4.0.0) |
راجع extensions.json المستخدمة لإنشاء الحزمة. |
| 4.x | [4.0.0, 5.0.0) |
راجع extensions.json المستخدمة لإنشاء الحزمة. |
إشعار
على الرغم من أن host.json يدعم النطاقات المخصصة ل version، يجب استخدام قيمة نطاق إصدار من هذا الجدول، مثل [4.0.0, 5.0.0). للحصول على قائمة كاملة بإصدارات مجموعة الملحقات وإصدارات الملحقات في كل إصدار، راجع صفحة إصدار حزم الملحقات.
تركيب الملحقات بشكل صريح
بالنسبة لمشاريع مكتبة فئة C# المحولة برمجيا (عملية عامل قيد المعالجة ومعزولة)، يمكنك تثبيت حزم NuGet للملحقات التي تحتاجها كما تفعل عادة. للحصول على أمثلة، راجع دليل مطور Visual Studio Code أو دليل مطور Visual Studio . راجع صفحة إصدار حزم الملحقات لمراجعة مجموعات إصدارات الملحقات المتوافقة مع التحقق منها.
أو غير لغات .NET وC#، عندما لا تتمكن من استخدام حزم الملحقات، تحتاج إلى تثبيت ملحقات الربط المطلوبة يدوياً في مشروعك المحلي. أسهل طريقة هي استخدام أدوات Azure Functions الأساسية. لمزيد من المعلومات، راجع تثبيت ملحقات func.
لتطوير المدخل فقط، تحتاج إلى إنشاء ملف extension.csproj يدوياً في جذر تطبيق وظيفتك. لمعرفة المزيد، راجع تثبيت الإضافات يدوياً .