إنشاء تطبيقات الوظائف وإدارتها في خطة Flex Consumption

توضح هذه المقالة كيفية إنشاء تطبيقات الوظائف المستضافة في خطة استهلاك Flex في Azure Functions. كما يوضح لك كيفية إدارة ميزات معينة لتطبيق مستضاف لخطة استهلاك Flex.

موارد تطبيق الوظائف خاصة ب langauge. تأكد من اختيار لغة تطوير التعليمات البرمجية المفضلة لديك في بداية المقالة.

هام

خطة Flex Consumption قيد المعاينة حاليا.

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. إذا لم تكن تملك حسابًا، فإنه يمكنكإنشاء حساب مجانًا.

• Azure CLI: يستخدم لإنشاء الموارد وإدارتها في Azure. عند استخدام Azure CLI على الكمبيوتر المحلي، تأكد من استخدام الإصدار 2.60.0 أو إصدار أحدث. يمكنك أيضا استخدام Azure Cloud Shell، الذي يحتوي على إصدار Azure CLI الصحيح.

• Visual Studio Code: يستخدم لإنشاء التطبيقات وتطويرها، وإنشاء موارد Azure، ونشر مشاريع التعليمات البرمجية إلى Azure. عند استخدام Visual Studio Code، تأكد أيضا من تثبيت أحدث ملحق Azure Functions. يمكنك أيضا تثبيت حزمة ملحق أدوات Azure.

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

  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code
  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code
  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code

  لإنشاء تطبيق في خطة استهلاك Flex جديدة أثناء توزيع Maven، يجب عليك إنشاء مشروع التطبيق المحلي ثم تحديث ملف pom.xml للمشروع. لمزيد من المعلومات، راجع إنشاء تطبيق Java Flex Consumption باستخدام Maven

  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code
  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code
  • إنشاء مشروع Azure Functions من سطر الأوامر
  • إنشاء مشروع Azure Functions باستخدام Visual Studio Code

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

إنشاء تطبيق Flex Consumption

يوضح لك هذا القسم كيفية إنشاء تطبيق دالة في خطة Flex Consumption باستخدام إما Azure CLI أو مدخل Microsoft Azure أو Visual Studio Code. للحصول على مثال لإنشاء تطبيق في خطة استهلاك Flex باستخدام قوالب Bicep/ARM، راجع مستودع Flex Consumption.

يمكنك تخطي هذا القسم إذا اخترت بدلا من ذلك إنشاء تطبيقك ونشره باستخدام Maven.

لدعم التعليمات البرمجية للدالة الخاصة بك، تحتاج إلى إنشاء ثلاثة موارد:

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

Azure CLI

1. إذا لم تكن قد فعلت ذلك بالفعل، سجل الدخول إلى Azure:

   az login
   

   az login يسجل لك الأمر الدخول إلى حساب Azure الخاص بك.

2. az functionapp list-flexconsumption-locations استخدم الأمر لمراجعة قائمة المناطق التي تدعم استهلاك Flex حاليا.

   az functionapp list-flexconsumption-locations --output table
   

3. إنشاء مجموعة موارد في إحدى المناطق المدعومة حاليا:

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   في الأمر أعلاه، استبدل <RESOURCE_GROUP> بقيمة فريدة في اشتراكك وبإحدى <REGION> المناطق المدعومة حاليا. ينشئ الأمر az group create مجموعة موارد.

4. إنشاء حساب تخزين للأغراض العامة في مجموعة الموارد والمنطقة الخاصة بك:

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   في المثال السابق، استبدل <STORAGE_NAME> باسم مناسب لك وفريد في تخزين Azure. يجب أن تحتوي الأسماء على ثلاثة إلى 24 حرفا من الأرقام والأحرف الصغيرة فقط. يحدد Standard_LRS حساب للأغراض العامة، الذي هو مدعوم من قبل الدالات. يقوم أمر إنشاء حساب التخزين azبإنشاء حساب التخزين.

   هام

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

5. أنشئ تطبيق الدالة في Azure:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   تطبيقات C# التي تعمل قيد المعالجة غير مدعومة حاليا عند التشغيل في خطة Flex Consumption.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   بالنسبة لتطبيقات Java، يتم أيضا دعم Java 11 حاليا.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   بالنسبة لتطبيقات Python، يتم أيضا دعم Python 3.10 حاليا.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   في هذا المثال، استبدل كل <RESOURCE_GROUP> من و <STORAGE_NAME> بمجموعة الموارد واسم الحساب الذي استخدمته في الخطوة السابقة، على التوالي. استبدل <APP_NAME> أيضا باسم فريد عمومي مناسب لك. <APP_NAME> هو أيضا المجال الافتراضي لخادم اسم المجال (DNS) لتطبيق الوظائف. az functionapp create يقوم الأمر بإنشاء تطبيق الوظائف في Azure.

   ينشئ هذا الأمر تطبيق وظائف يعمل في خطة Flex Consumption. إصدار وقت تشغيل اللغة المحدد المستخدم هو إصدار مدعوم حاليا في المعاينة.

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

مدخل Microsoft Azure

1. في مدخل Microsoft Azure، من القائمة أو الصفحة الرئيسية ، حدد إنشاء مورد.

2. حدد بدء الاستخدام ثم إنشاء ضمن تطبيق الوظائف.

3. ضمن تحديد خيار استضافة، اختر تحديد استهلاك> Flex.

4. في صفحة Basics، استخدم إعدادات تطبيق الوظائف على النحو المحدد في الجدول التالي:

   الإعدادات	القيمة المقترحة	‏‏الوصف
   الاشتراك	اشتراكك	الاشتراك الذي تنشئ فيه تطبيق الوظائف الجديد.
   مجموعة الموارد	myResourceGroup	اسم مجموعة الموارد الجديدة التي تقوم فيها بإنشاء تطبيق الوظائف.
   اسم تطبيق الوظائف	اسم فريد عالميًا	الاسم الذي يحدد تطبيق الوظائف الجديد. الأحرف الصالحة هي a-z (غير حساسة لحالة الأحرف)، و0-9، و-.
   المنطقة	المنطقة المفضلة	حدد منطقة قريبة منك أو قريبة من الخدمات الأخرى التي تصل دوالك إليها. لا يتم عرض المناطق غير المدعومة. لمزيد من المعلومات، راجع عرض المناطق المدعومة حاليا.
   مكدس وقت التشغيل	اللغة المفضلة	اختر أحد مكدسات وقت تشغيل اللغة المدعومة. التحرير في المدخل باستخدام Visual Studio Code للويب متاح حاليا فقط لتطبيقات Node.js وPowerShell وPython. يجب تطوير مكتبة فئة C# ووظائف Java محليا.
   ‏‏الإصدار	نسخة اللغة	اختر إصدارا معتمدا من مكدس وقت تشغيل اللغة.
   حجم المثيل	الإعداد الافتراضي	تحديد مقدار ذاكرة المثيل المخصصة لكل مثيل من تطبيقك. لمزيد من المعلومات، راجع ذاكرة المثيل.

5. اقبل الخيارات الافتراضية في علامات التبويب المتبقية، بما في ذلك السلوك الافتراضي لإنشاء حساب تخزين جديد في علامة التبويب Storage ومثيل Application Insight جديد في علامة التبويب Monitoring . يمكنك أيضا اختيار استخدام حساب تخزين موجود أو مثيل Application Insights.

6. حدد Review + create لمراجعة تكوين التطبيق الذي اخترته، ثم حدد Create لتوفير تطبيق الوظائف ونشره.

7. قم باختيار رمز Notifications في الزاوية العلوية اليمنى من المدخل وستشاهد رسالة نجح النشر.

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

Visual Studio Code

1. اضغط على F1، وفي منصة الأوامر أدخل Azure Functions: Create function app in Azure... (متقدم).

2. إذا لم تكن قد سجلت الدخول، فستتم مطالبتك بـ تسجيل الدخول إلى Azure. يمكنك أيضًا إنشاء حساب Azure مجاني. بعد تسجيل الدخول من المستعرض، انتقل إلى Visual Studio Code.

3. بعد المطالبات، قم بتوفير هذه المعلومات:

   المطالبة	التحديد
   أدخل اسماً فريداً عالمياً لFunction App الجديد.	اكتب اسماً فريداً عالمياً يحدد Function App الجديد الخاص بك، ثم حدد إدخال. الأحرف الصالحة لاسم تطبيق الوظائف هي a-z و0-9 و-.
   حدد خطة الاستضافة.	اختر استهلاك Flex (معاينة).
   حدد حزمة وقت التشغيل.	اختر أحد إصدارات مكدس اللغة المدعومة.
   حدد مجموعة موارد للموارد الجديدة.	اختر إنشاء مجموعة موارد جديدة واكتب اسم مجموعة موارد، مثل myResourceGroup، ثم حدد إدخال. يمكنك أيضًا تحديد مجموعة موارد موجودة.
   حدد موقعًا للموارد الجديدة.	حدد موقعا في منطقة مدعومة بالقرب منك أو بالقرب من الخدمات الأخرى التي تصل إليها وظائفك. لا يتم عرض المناطق غير المدعومة. لمزيد من المعلومات، راجع عرض المناطق المدعومة حاليا.
   حدد حساب التخزين.	اختر إنشاء حساب تخزين جديد وفي المطالبة أدخل اسما فريدا عالميا لحساب التخزين الجديد المستخدم من قبل تطبيق الوظائف ثم حدد Enter. يجب أن يتراوح طول أسماء حسابات التخزين بين 3 أحرف و24 حرفًا، ويمكن أن تحتوي فقط على أرقام وأحرف صغيرة. يمكنك أيضًا تحديد حساب موجود.
   حدد مورد Application Insights لتطبيقك.	اختر إنشاء مورد Application Insights جديد وفي المطالبة قم بتوفير اسم المثيل المستخدم لتخزين بيانات وقت التشغيل من وظائفك.

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

نشر مشروع التعليمات البرمجية

يمكنك تخطي هذا القسم إذا اخترت بدلا من ذلك إنشاء تطبيقك ونشره باستخدام Maven.

يمكنك اختيار نشر التعليمات البرمجية لمشروعك إلى تطبيق وظائف موجود باستخدام أدوات مختلفة:

Visual Studio Code

هام

يستبدل التوزيع إلى تطبيق وظائف موجود دائمًا محتويات هذا التطبيق في Azure.

1. في لوحة الأوامر، أدخل ثم حدد Azure Functions: Deploy to Function App.

2. حدد تطبيق الوظائف الذي أنشأته للتو. عند مطالبتك بالكتابة فوق عمليات التوزيع السابقة، حدد Deploy لنشر التعليمات البرمجية للدالة إلى مورد تطبيق الوظائف الجديد.

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

   

أدوات الذاكرة الأساسية

في مجلد المشروع الجذر، قم بتشغيل هذا func azure functionapp publish الأمر:

func azure functionapp publish <APP_NAME>

في هذا المثال، استبدل <APP_NAME> باسم تطبيقك. يظهر التوزيع الناجح نتائج مشابهة للإخراج التالي (مقتطع للتبسيط):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

إنشاء تطبيقك ونشره باستخدام Maven

يمكنك استخدام Maven لإنشاء تطبيق دالة مستضاف على Flex Consumption والموارد المطلوبة أثناء النشر عن طريق تعديل ملف pom.xml.

1. إنشاء مشروع تعليمة برمجية Java عن طريق إكمال الجزء الأول من إحدى مقالات التشغيل السريع هذه:

   • إنشاء مشروع Azure Functions من سطر الأوامر
   • إنشاء مشروع Azure Functions باستخدام Visual Studio Code

2. في مشروع تعليمة Java البرمجية، افتح ملف pom.xml وقم بإجراء هذه التغييرات لإنشاء تطبيق الوظائف في خطة Flex Consumption:

   • تغيير قيمة <properties>.<azure.functions.maven.plugin.version> إلى 1.34.0.

   • في <plugin>.<configuration> القسم الخاص ب azure-functions-maven-plugin، أضف العنصر أو ألغ تعليقه <pricingTier> كما يلي:

     <pricingTier>Flex Consumption</pricingTier>
     

3. (اختياري) قم بتخصيص خطة Flex Consumption في توزيع Maven الخاص بك عن طريق تضمين هذه العناصر أيضا في <plugin>.<configuration> القسم: .

   • <instanceSize>- تعيين حجم ذاكرة المثيل لتطبيق الوظائف. القيمة الافتراضية هي 2048.
   • <maximumInstances> - يعين أعلى قيمة للحد الأقصى لعدد المثيلات لتطبيق الوظائف.
   • <alwaysReadyInstances> - يعين عدد المثيلات الجاهزة دائما مع العناصر التابعة لمجموعات مشغلات HTTP (<http>)، ومجموعات Durable Functions (<durable>)، ومشغلات محددة أخرى (<my_function>). عند تعيين أي عدد مثيل أكبر من الصفر، يتم محاسبتك على هذه المثيلات سواء تم تنفيذ وظائفك أم لا. لمزيد من المعلومات، انظرالفواتير.

4. قبل أن تتمكن من النشر، سجل الدخول إلى اشتراك Azure باستخدام Azure CLI.

   az login
   

   az login يسجل لك الأمر الدخول إلى حساب Azure الخاص بك.

5. استخدم الأمر التالي لنشر مشروع التعليمات البرمجية الخاص بك إلى تطبيق وظائف جديد في Flex Consumption.

   mvn azure-functions:deploy
   

   يستخدم Maven الإعدادات في قالب pom.xml لإنشاء تطبيق الوظائف في خطة استهلاك Flex في Azure، جنبا إلى جنب مع الموارد المطلوبة الأخرى. إذا كانت هذه الموارد موجودة بالفعل، يتم نشر التعليمات البرمجية إلى تطبيق الوظائف الخاص بك، والكتابة فوق أي تعليمة برمجية موجودة.

تمكين تكامل الشبكة الظاهرية

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

هام

لا تدعم خطة Flex Consumption حاليا الشبكات الفرعية التي تحتوي على أسماء تحتوي على أحرف تسطير أسفل السطر (_).

لتمكين الشبكات الظاهرية عند إنشاء تطبيقك:

Azure CLI

يمكنك تمكين تكامل الشبكة الظاهرية az functionapp create عن طريق تشغيل الأمر وتضمين --vnet المعلمات و --subnet .

1. إنشاء الشبكة الظاهرية والشبكة الفرعية، إذا لم تكن قد فعلت ذلك بالفعل.

2. أكمل الخطوات من 1 إلى 4 في إنشاء تطبيق Flex Consumption لإنشاء الموارد المطلوبة من قبل تطبيقك.

3. az functionapp create قم بتشغيل الأمر ، بما في --vnet ذلك المعلمات و--subnet، كما في هذا المثال:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   <VNET_RESOURCE_ID> القيمة هي معرف المورد للشبكة الظاهرية، وهو بالتنسيق: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCER_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME>. يمكنك استخدام هذا الأمر للحصول على قائمة معرفات الشبكة الظاهرية، التي تمت تصفيتها حسب <RESOURCE_GROUP>: az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id.

مدخل Microsoft Azure

استخدم هذه الخطوات لإنشاء تطبيق الوظائف الخاص بك مع تكامل الشبكة الظاهرية وموارد Azure ذات الصلة.

1. في مدخل Microsoft Azure، من القائمة أو الصفحة الرئيسية ، حدد إنشاء مورد.

2. حدد بدء الاستخدام ثم إنشاء ضمن تطبيق الوظائف.

3. ضمن تحديد خيار استضافة، اختر تحديد استهلاك> Flex.

4. في صفحة Basics، استخدم إعدادات تطبيق الوظائف على النحو المحدد في الجدول التالي:

   الإعدادات	القيمة المقترحة	‏‏الوصف
   الاشتراك	اشتراكك	الاشتراك الذي تنشئ فيه تطبيق الوظائف الجديد.
   مجموعة الموارد	myResourceGroup	اسم مجموعة الموارد الجديدة التي تقوم فيها بإنشاء تطبيق الوظائف.
   اسم تطبيق الوظائف	اسم فريد عالميًا	الاسم الذي يحدد تطبيق الوظائف الجديد. الأحرف الصالحة هي a-z (غير حساسة لحالة الأحرف)، و0-9، و-.
   المنطقة	المنطقة المفضلة	حدد منطقة قريبة منك أو قريبة من الخدمات الأخرى التي تصل دوالك إليها. لا يتم عرض المناطق غير المدعومة. لمزيد من المعلومات، راجع عرض المناطق المدعومة حاليا.
   مكدس وقت التشغيل	اللغة المفضلة	اختر أحد مكدسات وقت تشغيل اللغة المدعومة. التحرير في المدخل باستخدام Visual Studio Code للويب متاح حاليا فقط لتطبيقات Node.js وPowerShell وPython. يجب تطوير مكتبة فئة C# ووظائف Java محليا.
   ‏‏الإصدار	نسخة اللغة	اختر إصدارا معتمدا من مكدس وقت تشغيل اللغة.
   حجم المثيل	الإعداد الافتراضي	تحديد مقدار ذاكرة المثيل المخصصة لكل مثيل من تطبيقك. لمزيد من المعلومات، راجع ذاكرة المثيل.

5. اقبل الخيارات الافتراضية في علامات التبويب المتبقية، بما في ذلك السلوك الافتراضي لإنشاء حساب تخزين جديد في علامة التبويب Storage ومثيل Application Insight جديد في علامة التبويب Monitoring . يمكنك أيضا اختيار استخدام حساب تخزين موجود أو مثيل Application Insights.

6. في علامة التبويب Networking ، قم بتعيين Enable public access to Off و Enable network injection إلى On.

7. بالنسبة للشبكة الظاهرية، حدد أو أنشئ شبكة ظاهرية موجودة في نفس منطقة تطبيقك.

8. قم بتعيين Enable VNet integration إلى On وحدد أو أنشئ شبكة فرعية.

9. حدد Review + create لمراجعة تكوين التطبيق الذي اخترته، ثم حدد Create لتوفير تطبيق الوظائف ونشره باستخدام الشبكات الظاهرية.

10. قم باختيار رمز Notifications في الزاوية العلوية اليمنى من المدخل وستشاهد رسالة نجح النشر.

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

Visual Studio Code

لا يمكنك حاليا تمكين الشبكات الظاهرية عند استخدام Visual Studio Code لإنشاء تطبيقك.

للحصول على أمثلة شاملة حول كيفية إنشاء تطبيقات في Flex Consumption مع تكامل الشبكة الظاهرية، راجع هذه الموارد:

• الاستهلاك المرن: HTTP إلى مراكز الأحداث باستخدام تكامل VNET
• استهلاك Flex: يتم تشغيله من ناقل خدمة Microsoft Azure باستخدام تكامل VNET

لتعديل أو حذف تكامل الشبكة الظاهرية في تطبيق موجود:

Azure CLI

az functionapp vnet-integration add استخدم الأمر لتمكين تكامل الشبكة الظاهرية إلى تطبيق وظائف موجود:

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

az functionapp vnet-integration remove استخدم الأمر لتعطيل تكامل الشبكة الظاهرية في تطبيقك:

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

az functionapp vnet-integration list استخدم الأمر لسرد عمليات تكامل الشبكة الظاهرية الحالية لتطبيقك:

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

مدخل Microsoft Azure

يمكنك دمج تطبيقك الحالي مع شبكة ظاهرية وشبكة فرعية موجودة في المدخل.

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

2. ضمن Outbound traffic configuration، حدد Not configured.

3. في صفحة Virtual Network Integration ، حدد Add virtual network integration.

4. حدد شبكة ظاهرية وشبكة فرعية موجودة وحدد اتصال.

Visual Studio Code

لا يمكنك حاليا تكوين الشبكات الظاهرية في Visual Studio Code.

عند اختيار شبكة فرعية، تنطبق هذه الاعتبارات:

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

تكوين إعدادات النشر

في خطة Flex Consumption، يتم الاحتفاظ بحزمة التوزيع التي تحتوي على التعليمات البرمجية لتطبيقك في حاوية Azure Blob Storage. بشكل افتراضي، تستخدم عمليات التوزيع نفس حساب التخزين (AzureWebJobsStorage) والقيمة سلسلة الاتصال المستخدمة من قبل وقت تشغيل الوظائف للحفاظ على تطبيقك. يتم تخزين سلسلة الاتصال في DEPLOYMENT_STORAGE_CONNECTION_STRING إعداد التطبيق. ومع ذلك، يمكنك بدلا من ذلك تعيين حاوية كائن ثنائي كبير الحجم في حساب تخزين منفصل كمصدر نشر للتعليمات البرمجية الخاصة بك. يمكنك أيضا تغيير أسلوب المصادقة المستخدم للوصول إلى الحاوية.

يجب أن يفي مصدر التوزيع المخصص بهذه المعايير:

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

عند تكوين مصادقة تخزين النشر، ضع هذه الاعتبارات في الاعتبار:

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

لتكوين إعدادات النشر عند إنشاء تطبيق الوظائف في خطة Flex Consumption:

Azure CLI

az functionapp create استخدم الأمر وقم بتوفير هذه الخيارات الإضافية التي تخصص تخزين النشر:

المعلمة	‏‏الوصف‬
--deployment-storage-name	اسم حساب تخزين النشر.
--deployment-storage-container-name	اسم الحاوية في الحساب لاحتواء حزمة توزيع التطبيق.
--deployment-storage-auth-type	نوع المصادقة الذي يجب استخدامه للاتصال بحساب تخزين النشر. تتضمن StorageAccountConnectionStringالقيم المقبولة و UserAssignedIdentityو.SystemAssignedIdentity
--deployment-storage-auth-value	عند استخدام StorageAccountConnectionString، يتم تعيين هذه المعلمة إلى اسم إعداد التطبيق الذي يحتوي على سلسلة الاتصال إلى حساب تخزين النشر. عند استخدام UserAssignedIdentity، يتم تعيين هذه المعلمة إلى اسم معرف المورد للهوية التي تريد استخدامها.

ينشئ هذا المثال تطبيق وظائف في خطة Flex Consumption باستخدام حساب تخزين توزيع منفصل وهوية معينة من قبل المستخدم:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

مدخل Microsoft Azure

لا يمكنك حاليا تكوين تخزين النشر عند إنشاء تطبيقك في مدخل Microsoft Azure. لتكوين تخزين النشر أثناء إنشاء التطبيق، استخدم بدلا من ذلك Azure CLI لإنشاء تطبيقك.

يمكنك استخدام المدخل لتعديل إعدادات النشر لتطبيق موجود، كما هو مفصل في القسم التالي.

Visual Studio Code

لا يمكنك حاليا تكوين تخزين النشر عند إنشاء تطبيقك في Azure باستخدام Visual Studio Code.

يمكنك أيضا تعديل تكوين تخزين التوزيع لتطبيق موجود.

Azure CLI

az functionapp deployment config set استخدم الأمر لتعديل تكوين تخزين التوزيع:

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

مدخل Microsoft Azure

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

2. ضمن موقع حزمة التطبيق، حدد حساب تخزين موجود ثم حدد حاوية فارغة موجودة في الحساب.

3. ضمن مصادقة التخزين، حدد نوع المصادقة المفضل لديك

   • إذا حددت سلسلة الاتصال، فحدد اسم إعداد التطبيق الذي يحتوي على سلسلة الاتصال لحساب تخزين النشر.

   • إذا حددت الهوية المعينة من قبل المستخدم، فحدد الهوية التي ترغب في استخدامها.

4. حدد حفظ لتحديث التطبيق.

Visual Studio Code

لا يمكنك حاليا تكوين تخزين النشر لتطبيقك في Azure باستخدام Visual Studio Code.

تكوين ذاكرة المثيل

يمكن تعيين حجم ذاكرة المثيل الذي تستخدمه خطة Flex Consumption بشكل صريح عند إنشاء تطبيقك. لمزيد من المعلومات حول الأحجام المدعومة، راجع ذاكرة المثيل.

لتعيين حجم ذاكرة مثيل يختلف عن الحجم الافتراضي عند إنشاء تطبيقك:

Azure CLI

حدد المعلمة --instance-memory في الأمر الخاص بك az functionapp create . ينشئ هذا المثال تطبيق C# بحجم مثيل :4096

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

مدخل Microsoft Azure

عند إنشاء تطبيقك في خطة Flex Consumption في مدخل Microsoft Azure، يمكنك اختيار حجم ذاكرة المثيل في حقل حجم المثيل في علامة التبويب Basics. لمزيد من المعلومات، راجع إنشاء تطبيق Flex Consumption.

Visual Studio Code

لا يمكنك حاليا التحكم في حجم ذاكرة المثيل عند استخدام Visual Studio Code لإنشاء تطبيقك. يتم استخدام الحجم الافتراضي.

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

Azure CLI

يستخدم az functionapp scale config set هذا المثال الأمر لتغيير إعداد حجم ذاكرة المثيل إلى 4096 ميغابايت:

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 4096

مدخل Microsoft Azure

1. في صفحة تطبيق الوظائف في مدخل Microsoft Azure، قم بتوسيع الإعدادات في القائمة اليسرى وحدد Scale and concurrency.

2. حدد خيار ذاكرة المثيل وحدد حفظ لتحديث التطبيق.

Visual Studio Code

لا يمكنك حاليا تغيير إعداد حجم ذاكرة المثيل لتطبيقك باستخدام Visual Studio Code.

تعيين عدد المثيلات الجاهزة دائما

يمكنك تعيين عدد من المثيلات الجاهزة دائما لمجموعات التحجيم لكل وظيفة أو وظائف فردية، للحفاظ على تحميل الدالات الخاصة بك وجاهزة للتنفيذ. هناك ثلاث مجموعات خاصة، كما هو الحال في التحجيم لكل وظيفة:

• http - جميع الوظائف التي تم تشغيلها من قبل HTTP في التطبيق تتدرج معا في مثيلاتها الخاصة.
• durable - جميع الدوال التي تم تشغيلها بشكل دائم (التنسيق والنشاط والكيان) في التطبيق تتدرج معا في مثيلاتها الخاصة.
• blob - جميع الكائنات الثنائية كبيرة الحجم (شبكة الأحداث) التي تم تشغيلها في توسيع نطاق التطبيق معا في مثيلاتها الخاصة.

استخدم http، durable أو blob كاسم لإعداد زوج قيمة الاسم لتكوين أعداد جاهزة دائما لهذه المجموعات. بالنسبة لجميع الوظائف الأخرى في التطبيق، تحتاج إلى تكوين جاهزة دائما لكل وظيفة فردية باستخدام التنسيق function:<FUNCTION_NAME>=n.

Azure CLI

استخدم المعلمة --always-ready-instances az functionapp create مع الأمر لتعريف تعيين مثيل جاهز دائما واحد أو أكثر. يعين هذا المثال عدد المثيلات الجاهزة دائما لجميع الدالات التي تم تشغيلها من HTTP إلى 5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

يعين هذا المثال عدد المثيلات الجاهزة دائما لكافة دوال مشغل Durable وتعيين 3 عدد المثيلات الجاهزة دائما إلى 2 لدالة مشغل ناقل خدمة تسمى function5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

مدخل Microsoft Azure

لا يمكنك حاليا تحديد مثيلات جاهزة دائما عند إنشاء تطبيقك في مدخل Microsoft Azure. لتحديد المثيلات الجاهزة دائما أثناء إنشاء التطبيق، استخدم بدلا من ذلك Azure CLI لإنشاء تطبيقك.

يمكنك استخدام المدخل لتعديل مثيلات جاهزة دائما على تطبيق موجود، كما هو مفصل في القسم التالي.

Visual Studio Code

لا يمكنك حاليا تحديد مثيلات جاهزة دائما عند إنشاء تطبيقك في Azure باستخدام Visual Studio Code.

يمكنك أيضا تعديل المثيلات الجاهزة دائما على تطبيق موجود عن طريق إضافة تعيينات المثيل أو إزالتها أو عن طريق تغيير عدد تعيينات المثيلات الموجودة.

Azure CLI

يستخدم az functionapp scale config always-ready set هذا المثال الأمر لتغيير عدد المثيلات الجاهزة دائما لمجموعة مشغلات HTTP إلى 10:

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

لإزالة المثيلات الجاهزة دائما، استخدم az functionapp scale config always-ready delete الأمر ، كما في هذا المثال الذي يزيل جميع المثيلات الجاهزة دائما من كل من مجموعة مشغلات HTTP وأيضا دالة تسمى hello_world:

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http function:hello_world

مدخل Microsoft Azure

1. في صفحة تطبيق الوظائف في مدخل Microsoft Azure، قم بتوسيع الإعدادات في القائمة اليسرى وحدد Scale and concurrency.

2. ضمن النوع الأدنى http للمثيل الجاهز دائما ، blobأو ، durableأو اسم دالة معين باستخدام التنسيق function:<FUNCTION_NAME>=n في المشغل واكتب عدد المثيلات الجاهزة دائما.

3. حدد حفظ لتحديث التطبيق.

Visual Studio Code

لا يمكنك حاليا تعديل المثيلات الجاهزة دائما باستخدام Visual Studio Code.

تعيين حدود تزامن HTTP

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

إليك كيفية تعيين حدود تزامن HTTP لتطبيق موجود:

Azure CLI

az functionapp scale config set استخدم الأمر لتعيين حدود تزامن HTTP معينة لتطبيقك، بغض النظر عن حجم المثيل.

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

يعين هذا المثال مستوى تزامن مشغل HTTP إلى 10. بعد تعيين قيمة تزامن HTTP على وجه التحديد، يتم الاحتفاظ بهذه القيمة على الرغم من أي تغييرات في إعداد حجم مثيل التطبيق.

مدخل Microsoft Azure

1. في صفحة تطبيق الوظائف في مدخل Microsoft Azure، قم بتوسيع الإعدادات في القائمة اليسرى وحدد Scale and concurrency.

2. ضمن التزامن لكل مثيل ، حدد تعيين يدويا واكتب حدا معينا.

3. حدد حفظ لتحديث التطبيق.

Visual Studio Code

لا يمكنك حاليا تعيين حدود تزامن HTTP باستخدام Visual Studio Code.

عرض المناطق المدعومة حاليا

أثناء المعاينة، يمكنك فقط التشغيل على خطة استهلاك Flex فقط في مناطق محددة. لعرض قائمة المناطق التي تدعم حاليا خطط استهلاك Flex:

1. إذا لم تكن قد فعلت ذلك بالفعل، سجل الدخول إلى Azure:

   az login
   

   az login يسجل لك الأمر الدخول إلى حساب Azure الخاص بك.

2. az functionapp list-flexconsumption-locations استخدم الأمر لمراجعة قائمة المناطق التي تدعم استهلاك Flex حاليا.

   az functionapp list-flexconsumption-locations --output table
   

عند إنشاء تطبيق في مدخل Microsoft Azure أو باستخدام Visual Studio Code، تتم تصفية المناطق غير المدعومة حاليا من قائمة المنطقة.

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

• استضافة خطة استهلاك Azure Functions Flex
• خيارات استضافة وظائف Azure