إدارة تطبيق الوظائف الخاص بك

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

يتم نشر الوظائف الفردية في تطبيق وظائف ما معًا ويتم تغيير سعتها معًا. تشترك جميع الوظائف الموجودة في تطبيق الوظائف نفسه في نفس الموارد، لكل مثيل، بينما يتم تغيير سعة تطبيق الوظيفة.

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

بدء تشغيل مدخل Microsoft Azure

ملاحظة

بسبب القيود المفروضة على تحرير التعليمات البرمجية للدالة في مدخل Microsoft Azure، يجب عليك تطوير وظائفك محليا ونشر مشروع التعليمات البرمجية إلى تطبيق دالة في Azure. لمزيد من المعلومات، راجع قيود التطوير في مدخل Microsoft Azure

لعرض إعدادات التطبيق في تطبيق الوظائف، اتبع الخطوات التالية:

1. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩ باستخدام حساب Azure الخاص بك. ابحث عن تطبيق الوظائف وحدده.

2. في الجزء الأيمن من تطبيق الوظائف، قم بتوسيع الإعدادات، وحدد متغيرات البيئة، ثم حدد علامة التبويب إعدادات التطبيق.

   

العمل باستخدام إعدادات التطبيق

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

يتم تخزين هذه الإعدادات بهيئة مشفرة. لمزيد من المعلومات، راجع أمان إعدادات التطبيق.

يمكنك إدارة إعدادات التطبيق من مدخل Microsoft Azure، وباستخدام Azure CLI وAzure PowerShell. يمكنك أيضا إدارة إعدادات التطبيق من Visual Studio Code ومن Visual Studio.

مدخل Microsoft Azure

لعرض إعدادات التطبيق، راجع بدء الاستخدام في مدخل Microsoft Azure.

تحتفظ علامة التبويب إعدادات التطبيق بالإعدادات التي يستخدمها تطبيق الوظائف:

1. للاطلاع على قيم إعدادات التطبيق، حدد إظهار القيم.

2. لإضافة إعداد، حدد + إضافة، ثم أدخل الاسم والقيمة لزوج قيمة المفتاح الجديد.

   

Azure CLI

يقوم az functionapp config appsettings list الأمر بإرجاع إعدادات التطبيق الموجودة، على سبيل المثال:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

az functionapp config appsettings setالأمر بإضافة أو تحديث إعداد تطبيق. ينشئ المثال التالي إعدادًا باستخدام مفتاح مسمى CUSTOM_FUNCTION_APP_SETTINGوقيمة 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Azure PowerShell

يقوم Get-AzFunctionAppSetting cmdlet بإرجاع إعدادات التطبيق الموجودة، على سبيل المثال:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

Update-AzFunctionAppSettingالأمر بإضافة أو تحديث إعداد تطبيق. ينشئ المثال التالي إعدادًا باستخدام مفتاح مسمى CUSTOM_FUNCTION_APP_SETTINGوقيمة 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

استخدام إعدادات التطبيق

يمكن أيضًا قراءة قيم إعدادات تطبيق الدالة في التعليمات البرمجية كمتغيرات البيئة. لمزيد من المعلومات، راجع قسم متغيرات البيئة في هذه المقالات المرجعية الخاصة باللغة:

• C# مرحلة ما قبل التحويل البرمجي
• برنامج C# النصي (.csx)
• Java
• JavaScript
• بوويرشيل
• Python

عند تطوير تطبيق دالة محليا، يجب الاحتفاظ بنسخ محلية من هذه القيم في ملف مشروع local.settings.json . لمزيد من المعلومات، راجع ملف الإعدادات المحلية.

إعدادات نشر FTPS

تدعم Azure Functions نشر التعليمات البرمجية للمشروع إلى تطبيق الوظائف باستخدام FTPS. نظرا لأن أسلوب النشر هذا يتطلب منك مزامنة المشغلات، فلا يوصى به. لنقل ملفات المشروع بأمان، استخدم دائما FTPS وليس FTP.

للحصول على بيانات الاعتماد المطلوبة لنشر FTPS، استخدم إحدى الطرق التالية:

مدخل Microsoft Azure

يمكنك الحصول على بيانات اعتماد نشر FTPS في مدخل Microsoft Azure عن طريق تنزيل ملف تعريف النشر لتطبيق الوظائف الخاص بك.

هام

يحتوي ملف تعريف النشر على بيانات اعتماد أمان مهمة. قم دائما بتأمين الملف الذي تم تنزيله على الكمبيوتر المحلي.

لتنزيل ملف تعريف النشر لتطبيق الوظائف الخاص بك:

1. في مدخل Microsoft Azure، حدد موقع صفحة تطبيق الوظائف، وقم بتوسيع Settings>Configuration في العمود الأيسر.

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

3. ارجع إلى صفحة نظرة عامة على تطبيق الوظائف، ثم حدد الحصول على ملف تعريف النشر.

   

4. قم بحفظ محتويات الملف ونسخها.

3. في الملف، حدد موقع publishProfile العنصر مع السمة publishMethod="FTP". في هذا العنصر، publishUrluserNameتحتوي السمات و و userPWD على عنوان URL الهدف وبيانات الاعتماد لنشر FTPS.

Azure CLI

قم بتشغيل أمر Azure CLI هذا الذي يقوم بإرجاع بيانات اعتماد FTPS من ملف تعريف النشر.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

في هذا المثال، استبدل <APP_NAME> باسم تطبيق الوظائف و <GROUP_NAME> بمجموعة الموارد. تحتوي الأعمدة التي تم URLusernameإرجاعها و و على password عنوان URL الهدف وبيانات الاعتماد لنشر FTPS.

Azure PowerShell

قم بتشغيل أمر Azure PowerShell هذا الذي يقوم بإرجاع بيانات اعتماد FTPS من ملف تعريف النشر.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

في هذا المثال، استبدل <APP_NAME> باسم تطبيق الوظائف و <GROUP_NAME> بمجموعة الموارد. تحتوي الأعمدة التي تم URLusernameإرجاعها و و على password عنوان URL الهدف وبيانات الاعتماد لنشر FTPS.

نوع خطة الاستضافة

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

يمكنك تحديد نوع الخطة المستخدمة من قِبل تطبيق الوظائف الخاص بك من مدخل Microsoft Azure، أو باستخدام واجهات سطر الأوامر من Azure أو واجهات برمجة التطبيقات Azure PowerShell.

تشير القيم التالية إلى نوع الخطة:

نوع الخطة	مدخل Azure	واجهة سطر الأوامر من Azure/PowerShell
استهلاك	استهلاك	Dynamic
قسط	ElasticPremium	ElasticPremium
مخصصة (App Service)	متنوع	متنوع

مدخل Microsoft Azure

1. لتحديد نوع الخطة المستخدمة من قبل تطبيق الوظائف، راجع خطة خدمة التطبيقات في صفحة نظرة عامة لتطبيق الوظائف في مدخل Microsoft Azure.

   

2. لمشاهدة مستوى التسعير، حدد اسم App Service Plan، ثم حدد Settings > Properties من الجزء الأيمن.

Azure CLI

قم بتشغيل أمر Azure CLI التالي للحصول على نوع خطة الاستضافة الخاص بك:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

في المثال السابق، استبدل <RESOURCE_GROUP> و <FUNCTION_APP_NAME> بأسماء مجموعة الموارد والتطبيقات الوظيفية، على التوالي.

Azure PowerShell

قم بتشغيل أمر Azure PowerShell التالي للحصول على نوع خطة الاستضافة الخاص بك:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

في المثال السابق، استبدل <RESOURCE_GROUP> و <FUNCTION_APP_NAME> بأسماء مجموعة الموارد والتطبيقات الوظيفية، على التوالي.

ترحيل الخطة

يمكنك ترحيل تطبيق دالة بين خطة Consumption وخطة Premium على Windows. عند الترحيل بين الخطط، ضع في اعتبارك الاعتبارات التالية:

• الترحيل المباشر إلى خطة مخصصة (خدمة التطبيقات) غير مدعوم.
• الترحيل غير مدعوم على Linux.
• يجب أن تكون خطة المصدر والخطة الهدف في نفس مجموعة الموارد والمنطقة الجغرافية. لمزيد من المعلومات، راجع نقل تطبيق لخطة App Service .
• تعتمد أوامر CLI المحددة على اتجاه الترحيل.
• يحدث وقت التعطل في عمليات تنفيذ الوظائف عند ترحيل تطبيق الوظائف بين الخطط.
• يتم الاحتفاظ بالحالة والمحتوى الآخر الخاص بالتطبيق، لأن نفس مشاركة ملفات Azure يستخدمها التطبيق قبل الترحيل وبعده.

يمكنك ترحيل خطتك باستخدام هذه الأدوات:

مدخل Microsoft Azure

يمكنك استخدام مدخل Microsoft Azure للتبديل إلى خطة مختلفة.

Azure CLI

يمكنك استخدام أوامر Azure CLI لإنشاء خطة جديدة يدويا، وتبديل تطبيقك لاستخدام الخطة الجديدة، وحذف الخطة الأصلية.

Azure PowerShell

يمكنك استخدام أوامر Azure PowerShell لإنشاء خطة جديدة يدويا، وتبديل تطبيقك لاستخدام الخطة الجديدة، وحذف الخطة الأصلية.

اختر اتجاه الترحيل لتطبيقك على Windows.

الاستهلاك إلى المتميز

1. في مدخل Microsoft Azure، انتقل إلى تطبيق خطة الاستهلاك واختر تغيير خطة خدمة التطبيقات ضمن خطة خدمة التطبيقات.

2. حدد Premium ضمن Plan type، وأنشئ خطة Premium جديدة، وحدد OK.

لمزيد من المعلومات، راجع نقل تطبيق لخطة App Service .

Premium-to-Consumption

1. في مدخل Microsoft Azure، انتقل إلى تطبيق الخطة المتميزة واختر تغيير خطة خدمة التطبيقات ضمن خطة خدمة التطبيقات.

2. حدد Consumption ضمن Plan type، وأنشئ خطة استهلاك جديدة، وحدد OK.

لمزيد من المعلومات، راجع نقل تطبيق لخطة App Service .

الاستهلاك إلى المتميز

استخدم الإجراء التالي للترحيل من خطة Consumption إلى خطة Premium على Windows:

1. قم بتشغيل الأمر az functionapp create كما يلي لإنشاء خطة App Service جديدة (Elastic Premium) في نفس المنطقة ومجموعة الموارد مثل تطبيق الوظائف الحالي:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. قم بتشغيل الأمر az functionapp update كما يلي لترحيل تطبيق الوظيفة الحالي إلى خطة Premium الجديدة:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. عندما لم تعد بحاجة إلى خطة الاستهلاك المستخدمة في الأصل من قبل التطبيق، احذف خطتك الأصلية بعد التأكد من أنك قمت بالترحيل بنجاح إلى الخطة الجديدة. قم بتشغيل الأمر az functionapp plan list على النحو التالي للحصول على قائمة بجميع خطط الاستهلاك في مجموعة الموارد الخاصة بك:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

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

4. قم بتشغيل الأمر az functionapp plan delete كما يلي لحذف خطة الاستهلاك التي قمت بالترحيل منها.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Premium-to-Consumption

استخدم الإجراء التالي للترحيل من خطة Premium إلى خطة Consumption على Windows:

1. قم بتشغيل الأمر az functionapp create كما يلي لإنشاء تطبيق دالة جديد (Consumption) في نفس المنطقة ومجموعة الموارد مثل تطبيق الوظائف الحالي. ينشئ هذا الأمر أيضا خطة استهلاك جديدة يتم فيها تشغيل تطبيق الوظائف:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. قم بتشغيل الأمر az functionapp show كما يلي للحصول على اسم خطة الاستهلاك التي تم إنشاؤها باستخدام تطبيق الوظائف الجديد:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   اسم خطة الاستهلاك هو الجزء الأخير من معرف المورد المؤهل بالكامل الذي يتم إرجاعه.

3. قم بتشغيل الأمر az functionapp update كما يلي لترحيل تطبيق الوظائف الحالي إلى خطة الاستهلاك الجديدة:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. قم بتشغيل الأمر az functionapp delete كما يلي لحذف تطبيق الوظائف الذي أنشأته في الخطوة 1، حيث تحتاج فقط إلى الخطة التي تم إنشاؤها لتشغيل تطبيق الوظائف الحالي:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. عندما لم تعد بحاجة إلى خطة Premium المستخدمة في الأصل من قبل التطبيق، احذف خطتك الأصلية بعد التأكد من أنك قمت بالترحيل بنجاح إلى الخطة الجديدة. حتى يتم حذف الخطة المميزة، يستمر تحصيل الرسوم منك. قم بتشغيل الأمر az functionapp plan list كما يلي للحصول على قائمة بجميع خطط Premium في مجموعة الموارد الخاصة بك:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. قم بتشغيل الأمر az functionapp plan delete كما يلي لحذف خطة Premium التي قمت بالترحيل منها:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

الاستهلاك إلى المتميز

استخدم الإجراء التالي للترحيل من خطة Consumption إلى خطة Premium على Windows:

1. قم بتشغيل الأمر New-AzFunctionAppPlan كما يلي لإنشاء خطة App Service جديدة (Elastic Premium) في نفس المنطقة ومجموعة الموارد مثل تطبيق الوظائف الحالي:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. قم بتشغيل الأمر Update-AzFunctionApp كما يلي لترحيل تطبيق الوظائف الحالي إلى خطة Premium الجديدة:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. عندما لم تعد بحاجة إلى خطة الاستهلاك المستخدمة في الأصل من قبل التطبيق، يمكنك تشغيل الأمر Remove-AzFunctionAppPlan كما يلي لحذف خطة الاستهلاك التي قمت بالترحيل منها:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Premium-to-Consumption

استخدم الإجراء التالي للترحيل من خطة Premium إلى خطة Consumption على Windows:

1. قم بتشغيل الأمر New-AzFunctionApp كما يلي لإنشاء تطبيق وظائف جديد (الاستهلاك) في نفس المنطقة ومجموعة الموارد مثل تطبيق الوظائف الحالي. ينشئ هذا الأمر أيضا خطة استهلاك جديدة يتم فيها تشغيل تطبيق الوظائف:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. قم بتشغيل الأمر Get-AzFunctionApp كما يلي للحصول على اسم خطة الاستهلاك التي تم إنشاؤها باستخدام تطبيق الوظائف الجديد:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. قم بتشغيل الأمر Update-AzFunctionApp كما يلي لترحيل تطبيق الوظائف الحالي إلى خطة الاستهلاك الجديدة:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. عندما لم تعد بحاجة إلى خطة الاستهلاك المستخدمة في الأصل من قبل التطبيق، يمكنك تشغيل الأمر Remove-AzFunctionAppPlan كما يلي لحذف خطة الاستهلاك التي قمت بالترحيل منها:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

قيود التطوير في مدخل Microsoft Azure

يعرض الجدول التالي أنظمة التشغيل واللغات التي تدعم التحرير في المدخل:

اللغة	استهلاك Windows	Windows Premium	الـ Windows المخصص	استهلاك Linux	Linux Premium	الـ Linux المخصص
C#‎
Java
JavaScript (Node.js)	✔	✔	✔		✔	✔
Python				✔	✔	✔
PowerShell	✔	✔	✔
TypeScript (Node.js)

ضع في اعتبارك هذه القيود عند تطوير وظائفك في مدخل Microsoft Azure:

• يتم دعم التحرير في المدخل فقط للوظائف التي تم إنشاؤها أو آخر تعديل في مدخل Microsoft Azure.
• يتم دعم التحرير في المدخل فقط لوظائف JavaScript وPowerShell وPython وC# Script.
• التحرير في المدخل غير مدعوم حاليا من قبل خطة Flex Consumption.
• عند نشر التعليمات البرمجية إلى تطبيق دالة من خارج مدخل Microsoft Azure، لم يعد بإمكانك تحرير أي من التعليمات البرمجية لتطبيق الوظائف هذا في المدخل. في هذه الحالة، ما عليك سوى الاستمرار في استخدام التطوير المحلي.
• بالنسبة إلى Python، التطوير باستخدام الوحدات النمطية المخصصة غير مدعوم حاليا في المدخل. لإضافة وحدات نمطية مخصصة إلى تطبيق الوظائف، يجب عليك تطوير تطبيقك محليا.
• بالنسبة إلى وظائف C# المحولة برمجيا ووظائف Java، يمكنك إنشاء تطبيق الوظائف والموارد ذات الصلة في المدخل. ومع ذلك، يجب إنشاء مشروع التعليمات البرمجية للوظائف محليا ثم نشره إلى Azure.

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

تثبيت الملحقات يدويا

يمكن أن تتضمن دوال مكتبة الفئة C# حزم NuGet لملحقات الربط مباشرة في مشروع مكتبة الفئة. بالنسبة للغات non-.NET الأخرى والبرنامج النصي C#، يجب استخدام حزم الملحقات. إذا كان يجب تثبيت الملحقات يدويا، يمكنك القيام بذلك باستخدام Azure Functions Core Tools محليا. إذا لم تتمكن من استخدام حزم الملحقات وكنت قادرا فقط على العمل في المدخل، فأنت بحاجة إلى استخدام أدوات متقدمة (Kudu) لإنشاء ملف extensions.csproj يدويا مباشرة في الموقع. تأكد أولا من إزالة extensionBundle العنصر من ملف host.json .

تعمل هذه العملية نفسها مع أي ملف آخر تحتاج إلى إضافته إلى تطبيقك.

هام

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

يتيح لك محرر الوظائف المضمن في مدخل Microsoft Azure تحديث التعليمات البرمجية للدالة وملفات التكوين مباشرة في المدخل:

1. حدد تطبيق الوظائف، ثم ضمن Functions، حدد Functions.

2. اختر دالتك وحدد اختبار + تعليمة برمجية ضمن مطور.

3. اختر الملف لتحريره وحدد حفظ عند الانتهاء.

يجب إنشاء الملفات الموجودة في جذر التطبيق، مثل function.proj أو extensions.csproj وتحريرها باستخدام Advanced Tools (Kudu):

1. حدد تطبيق الوظائف، وقم بتوسيع أدوات التطوير، ثم حدد أدوات متقدمة>Go.

2. إذا طلب منك ذلك، فسجل الدخول إلى موقع إدارة التحكم بالمصادر (SCM) باستخدام بيانات اعتماد Azure.

3. من قائمة وحدة تحكم تتبع الأخطاء، اختر CMD.

4. انتقل إلى .\site\wwwroot، وحدد زر زائد (+) في الأعلى، وحدد ملف جديد.

5. امنح الملف اسما، مثل extensions.csproj، ثم اضغط على مفتاح الإدخال Enter.

6. حدد زر التحرير بجوار الملف الجديد، وأضف التعليمات البرمجية أو حدثها في الملف، ثم حدد حفظ.

7. بالنسبة لملف مشروع مثل extensions.csproj، قم بتشغيل الأمر التالي لإعادة إنشاء مشروع الملحقات:

   dotnet build extensions.csproj
   

ميزات النظام الأساسي

تعمل تطبيقات الوظائف في النظام الأساسي ل Azure App Service، والذي يحافظ عليها. على هذا النحو، تتمتع تطبيقات الوظائف الخاصة بك بالوصول إلى معظم ميزات النظام الأساسي لاستضافة الويب الأساسي في Azure. عند استخدام مدخل Microsoft Azure، فإن الجزء الأيمن هو المكان الذي يمكنك فيه الوصول إلى العديد من ميزات النظام الأساسي ل App Service التي يمكنك استخدامها في تطبيقات الوظائف.

تشير المصفوفة التالية إلى دعم ميزة مدخل Microsoft Azure من خلال خطة الاستضافة ونظام التشغيل:

ميزة	خطة الاستهلاك	خطة استهلاك Flex	الخطة المتميزة	الخطة المخصصة
أدوات متقدمة (Kudu)	نوافذ: ✔ Linux: X	X	✔	✔
محرر App Service	نوافذ: ✔ Linux: X	X	نوافذ: ✔ Linux: X	نوافذ: ✔ Linux: X
النسخ الاحتياطي	X	X	X	✔
عزى	Windows: سطر الأوامر Linux: X	X	Windows: سطر الأوامر Linux: SSH	Windows: سطر الأوامر Linux: SSH

تركز بقية هذه المقالة على الميزات التالية في المدخل والمفيد لتطبيقات الدوال الخاصة بك:

• محرر App Service
• عزى
• أدوات متقدمة (Kudu)
• خيارات النشر
• CORS
• المصادقة

لمزيد من المعلومات حول كيفية العمل باستخدام إعدادات App Service، راجع تكوين إعدادات App Service في Azure.

محرر App Service

محرر App Service هو محرر متقدم داخل المدخل يمكنك استخدامه لتعديل ملفات تكوين JSON وملفات التعليمات البرمجية على حدٍ سواء. يؤدي اختيار هذا الخيار إلى تشغيل علامة تبويب مستعرض منفصلة تحتوي على محرر أساسي. يمكنك هذا المحرر من التكامل مع مستودع Git وتشغيل التعليمات البرمجية وتصحيحها وتعديل إعدادات تطبيق الوظائف. يوفر هذا المحرر بيئة تطوير محسنة للوظائف الخاصة بك مقارنة مع محرر الوظائف المضمن.

نوصيك بالتفكير في تطوير وظائفك على الكمبيوتر المحلي الخاص بك. عند التطوير محليا والنشر إلى Azure، تكون ملفات المشروع للقراءة فقط في مدخل Microsoft Azure. وللحصول على مزيد من المعلومات، انظر التعليمات البرمجية لخدمة وظائف Azure Functions واختبارها محليًا.

وحدة تحكم

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

عند التطوير محليًا، نوصي باستخدام أدوات الوظائف الأساسية من Azure و واجهة سطر الأوامر من Azure.

أدوات متقدمة (Kudu)

توفر الأدوات المتقدمة الخاصة بـ App Service (المعروفة أيضًا باسم Kudu) الوصول إلى الميزات الإدارية المتقدمة لتطبيق الوظائف الخاص بك. من Kudu، يمكنك إدارة معلومات النظام، إعدادات التطبيق، متغيرات البيئة، ملحقات الموقع، عناوين HTTP، ومتغيرات الخادم. يمكنك أيضا تشغيل Kudu عن طريق الاستعراض إلى نقطة نهاية SCM لتطبيق الوظائف الخاص بك، على سبيل المثال: https://<myfunctionapp>.scm.azurewebsites.net/.

مركز التوزيع

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

مشاركة الموارد عبر المنشأ

لمنع تنفيذ التعليمات البرمجية الضارة على العميل، تمنع المستعرضات الحديثة الطلبات الواردة من تطبيقات الويب إلى الموارد التي تعمل في مجال منفصل. تتيح مشاركة الموارد عبر المنشأ (CORS)Access-Control-Allow-Origin لعنوان ما الإعلان عن أي الأصول المسموح لها باستدعاء نقاط النهاية على تطبيق الوظائف الخاص بك.

مدخل Microsoft Azure

عند تكوين قائمة الأصول المسموح بها لتطبيق الوظائف الخاص بك، تتم إضافة العنوان Access-Control-Allow-Origin تلقائيًا إلى كافة الاستجابات من نقاط نهاية HTTP في تطبيق الوظائف الخاص بك.

إذا كان هناك إدخال مجال آخر، يتم تجاهل حرف البدل (*).

Azure CLI

استخدم الأمر az functionapp cors add لإضافة مجال إلى قائمة الأصول المسموح بها. يضيف المثال التالي المجال contoso.com:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

استخدم الأمر az functionapp cors show لسرد الأصول الحالية المسموح بها.

Azure PowerShell

لا يمكنك حاليا تحديث إعدادات CORS باستخدام Azure PowerShell.

المصادقة

عندما تستخدم الوظائف مشغل HTTP، يمكنك طلب أن تتم مصادقة الاستدعاءات أولاً. تدعم App Service مصادقة Microsoft Entra وتسجيل الدخول مع موفري الخدمات الاجتماعية، مثل Facebook وMicrosoft وX. للحصول على معلومات حول تكوين موفري مصادقة محددين، راجع نظرة عامة على مصادقة Azure App Service.

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

• تكوين تطبيق App Service
• التوزيع المستمر على Azure Functions