مشاركة عبر

مرجع إعدادات التطبيق لـ Azure Functions

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

توجد عدة طرق يمكنك من خلالها إضافة إعدادات تطبيق الوظائف وتحديثها وحذفها:

تتطلب التغييرات في إعدادات تطبيق الوظائف إعادة تشغيل تطبيق الوظائف.

في هذه المقالة، يتم اقتطاع مثال سلسلة الاتصال القيم لسهولة القراءة.

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

اعتبارات إعداد التطبيق

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

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

  • في تعيين الأسماء، تعتبر التسطير السفلي المزدوج (__) والنقطتين (:) قيما محجوزة. يتم تفسير التسطير السفلي المزدوج على أنه محددات هرمية على كل من Windows وLinux. يتم تفسير النقطتين بنفس الطريقة فقط على Windows. على سبيل المثال، سيتم تفسير الإعداد AzureFunctionsWebHost__hostid=somehost_123456 على أنه كائن JSON التالي:

    "AzureFunctionsWebHost": {
    "hostid": "somehost_123456"
}

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

  • عند تشغيل الوظائف محليا، يتم تحديد إعدادات التطبيق في Values المجموعة في local.settings.json.

  • هناك خيارات أخرى لتكوين تطبيق الوظائف في ملف host.json وفي ملف local.settings.json .

  • يمكنك استخدام إعدادات التطبيق لتجاوز قيم إعداد host.json دون الحاجة إلى تغيير الملف host.json نفسه. هذا الأسلوب مفيد للسيناريوهات التي تحتاج فيها إلى تكوين إعدادات host.json معينة أو تعديلها لبيئة معينة. يتيح لك هذا الأسلوب أيضا تغيير إعدادات host.json دون الحاجة إلى إعادة نشر مشروعك. لمعرفة المزيد، راجع ⁧⁩المقالة المرجعية لـ host.json.

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

  • تتطلب بعض السيناريوهات أيضا العمل مع الإعدادات الموثقة في إعدادات موقع App Service.

  • يمكن أن يؤدي تغيير أي إعدادات تطبيق App Serviceللقراءة فقط إلى وضع تطبيق الوظائف في حالة عدم الاستجابة.

  • انتبه عند تحديث إعدادات التطبيق باستخدام واجهات برمجة تطبيقات REST، بما في ذلك قوالب ARM. نظرا لأن واجهات برمجة التطبيقات هذه تحل محل إعدادات التطبيق الموجودة، يجب تضمين كافة الإعدادات الموجودة عند إضافة أو تعديل الإعدادات باستخدام واجهات برمجة تطبيقات REST أو قوالب ARM. عندما يكون ذلك ممكنا، استخدم Azure CLI أو Azure PowerShell للعمل برمجيا مع إعدادات التطبيق. لمزيد من المعلومات، راجع العمل مع إعدادات التطبيق.

APPINSIGHTS_INSTRUMENTATIONKEY

مفتاح أدوات Application Insights. لا تستخدم كل من APPINSIGHTS_INSTRUMENTATIONKEY و APPLICATIONINSIGHTS_CONNECTION_STRING. عندما يكون ذلك ممكنا، استخدم APPLICATIONINSIGHTS_CONNECTION_STRING. عند تشغيل Application Insights في سحابة ذات سيادة، يجب عليك استخدام APPLICATIONINSIGHTS_CONNECTION_STRING. لمزيد من المعلومات، راجع كيفية تكوين المراقبة لـ Azure Functions.

Key عينة القيمة
APPINSIGHTS_INSTRUMENTATIONKEY 55555555-af77-484b-9032-64f83bb83bb

لا تستخدم كل من APPINSIGHTS_INSTRUMENTATIONKEY و APPLICATIONINSIGHTS_CONNECTION_STRING. نوصي باستخدام APPLICATIONINSIGHTS_CONNECTION_STRING.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

تمكين الوصول إلى Application Insights باستخدام مصادقة Microsoft Entra. استخدم هذا الإعداد عندما يجب الاتصال بمساحة عمل Application Insights باستخدام مصادقة Microsoft Entra. لمزيد من المعلومات، راجع مصادقة Microsoft Entra ل Application Insights.

عند استخدام APPLICATIONINSIGHTS_AUTHENTICATION_STRING، تعتمد القيمة المحددة التي قمت بتعيينها على نوع الهوية المدارة:

الهوية المدارة إعداد القيمة
System-assigned Authorization=AAD
User-assigned Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

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

Note

عند استخدام APPLICATIONINSIGHTS_AUTHENTICATION_STRING للاتصال ب Application Insights باستخدام مصادقة Microsoft Entra، يجب عليك أيضا تعطيل المصادقة المحلية ل Application Insights. يتطلب هذا التكوين مصادقة Microsoft Entra من أجل استيعاب بيانات تتبع الاستخدام في مساحة العمل الخاصة بك.

APPLICATIONINSIGHTS_CONNECTION_STRING

سلسلة الاتصال لـ Application Insights. لا تستخدم كل من APPINSIGHTS_INSTRUMENTATIONKEY و APPLICATIONINSIGHTS_CONNECTION_STRING. نوصي باستخدام APPLICATIONINSIGHTS_CONNECTION_STRING في جميع الحالات. إنه شرط في الحالات التالية:

  • عندما يتطلب تطبيق الوظائف التخصيصات المضافة المدعومة باستخدام سلسلة الاتصال
  • عند تشغيل مثيل Application Insights الخاص بك في سحابة ذات سيادة، ما يتطلب نقطة نهاية مخصصة

لمزيد من المعلومات، راجع سلاسل الاتصال.

Key عينة القيمة
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

للاتصال ب Application Insights باستخدام مصادقة Microsoft Entra، يجب عليك استخدام APPLICATIONINSIGHTS_AUTHENTICATION_STRING.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Important

كانت وكلاء Azure Functions ميزة للإصدارات 1.x إلى 3.x من وقت تشغيل Azure Functions. لمزيد من المعلومات، راجع وكلاء الوظائف.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

كانت وكلاء Azure Functions ميزة للإصدارات 1.x إلى 3.x من وقت تشغيل Azure Functions. لمزيد من المعلومات، راجع وكلاء الوظائف.

AZURE_FUNCTIONS_ENVIRONMENT

تكوين بيئة استضافة وقت التشغيل لتطبيق الوظائف عند التشغيل في Azure. تتم قراءة هذه القيمة أثناء التهيئة. يقبل وقت التشغيل هذه القيم فقط:

Value Description
Production يمثل بيئة إنتاج، مع انخفاض التسجيل وتحسينات الأداء الكامل. هذه القيمة هي القيمة الافتراضية عندما AZURE_FUNCTIONS_ENVIRONMENT لا يتم تعيينها أو تعيينها إلى قيمة غير معتمدة.
Staging يمثل بيئة مرحلية، كما هو الحال عند التشغيل في فتحة مرحلية.
Development تدعم بيئة التطوير المزيد من التسجيل المطول وتحسينات الأداء المنخفضة الأخرى. يتم تعيين AZURE_FUNCTIONS_ENVIRONMENT Azure Functions Core Tools إلى Development عند التشغيل على الكمبيوتر المحلي. لا يمكن تجاوز هذا الإعداد في ملف local.settings.json.

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

هذا الإعداد غير متوفر في الإصدار 1.x من وقت تشغيل الوظائف.

AzureFunctionsJobHost__*

في الإصدار 2.x والإصدارات الأحدث من وقت تشغيل Functions، يمكن لإعدادات التطبيق تجاوز host.json الإعدادات في البيئة الحالية. يتم التعبير عن هذه التجاوزات كإعدادات التطبيق المسماة AzureFunctionsJobHost__path__to__setting. لمزيد من المعلومات، يُرجى الرجوع إلى تجاوز قيم host.json.

AzureFunctionsWebHost__hostid

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

يجب أن يفي معرف المضيف بالمتطلبات التالية:

  • يتراوح بين 1 و32 حرفا
  • تحتوي على أحرف صغيرة وأرقام والشرطات فقط
  • لا تبدأ أو تنتهي بشرطة
  • لا تحتوي على شرط متتالية

من الطرق السهلة لإنشاء معرّف استخدام GUID وإزالة الشرطات وجعله صغيراً، مثل تحويل GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 إلى القيمة 1835d7b55c984790815d072cc94c6f71.

Key عينة القيمة
AzureFunctionsWebHost__hostid myuniquefunctionappname123456789

لمزيد من المعلومات، راجع اعتبارات معرّف المضيف.

AzureWebJobsDashboard

يتم إهمال هذا الإعداد ويتم دعمه فقط عند التشغيل على الإصدار 1.x من وقت تشغيل Azure Functions.

سلسلة اتصال حساب تخزين اختيارية لتخزين السجلات وعرضها في علامة التبويب Monitor في مدخل Microsoft Azure. يجب أن يكون حساب التخزين حسابًا للأغراض العامة يدعم الكائنات الثنائية كبيرة الحجم وقوائم الانتظار والجداول. لمعرفة المزيد، راجع متطلبات حساب التخزين.

Key عينة القيمة
AzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobsDisableHomepage

تقوم قيمة true بتعطيل الصفحة المقصودة الافتراضية التي يتم عرضها لعنون URL الجذر لتطبيق الوظائف. القيمة الافتراضية هي false.

Key عينة القيمة
AzureWebJobsDisableHomepage true

عند حذف إعداد التطبيق هذا أو تعيينه إلى false، يتم عرض صفحة مشابهة للمثال التالي كاستجابة لعنوان URL <functionappname>.azurewebsites.net.

لقطة شاشة تعرض الصفحة المقصودة لتطبيق الوظائف.

AzureWebJobsDotNetReleaseCompilation

true يعني استخدام Release الوضع عند تحويل التعليمات البرمجية .NET برمجيا. false يعني استخدام وضع تتبع الأخطاء. القيمة الافتراضية هي true.

Key عينة القيمة
AzureWebJobsDotNetReleaseCompilation true

AzureWebJobsFeatureFlags

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

Key عينة القيمة
AzureWebJobsFeatureFlags feature1,feature2,EnableProxies

إذا كان تطبيقك يحتوي حاليا على هذا الإعداد، فقم بإضافة علامات جديدة إلى نهاية القائمة ذات الفواصل.

علامات الميزات المدعومة حاليا:

قيمة العلم Description
EnableProxies أعد تمكين الوكلاء على الإصدار 4.x من وقت تشغيل الوظائف أثناء التخطيط للترحيل إلى Azure API Management. لمزيد من المعلومات، راجع إعادة تمكين الوكلاء في Functions v4.x.
EnableAzureMonitorTimeIsoFormat ISO 8601 تمكين تنسيق الوقت في سجلات Azure Monitor لتطبيقات Linux التي تعمل على خطة مخصصة (App Service).

AzureWebJobsKubernetesSecretName

يشير إلى مورد Kubernetes Secrets المستخدم لتخزين المفاتيح. مدعوم فقط عند التشغيل في Kubernetes.

Key عينة القيمة
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

الاعتبارات عند استخدام مورد Kubernetes Secrets:

  • يجب عليك أيضا تعيين AzureWebJobsSecretStorageType إلى kubernetes. عندما AzureWebJobsKubernetesSecretName لا يتم تعيين، يعتبر المستودع للقراءة فقط. في هذه الحالة، يجب إنشاء القيم قبل النشر.
  • تُنشئ أدوات Azure Functions الأساسية القيم تلقائياً عند التوزيع إلى Kubernetes.
  • الأسرار غير القابلة للتغيير غير مدعومة ويؤدي استخدامها إلى حدوث أخطاء في وقت التشغيل.

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsSecretStorageKeyVaultClientId

معرّف العميل للهوية المُدارة التي عيّنها المستخدم أو تسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType إلى keyvault. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف.

Key عينة القيمة
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsSecretStorageKeyVaultClientSecret

سر معرّف العميل للهوية المُدارة التي عيّنها المستخدم أو تسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType إلى keyvault. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف.

Key عينة القيمة
AzureWebJobsSecretStorageKeyVaultClientSecret <CLIENT_SECRET>

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsSecretStorageKeyVaultName

تم إهمال هذا الإعداد وتم استخدامه فقط عند التشغيل على الإصدار 3.x من وقت تشغيل Azure Functions.

اسم مثيل مخزن المفاتيح المستخدم لتخزين المفاتيح. تم استخدام هذا الإعداد فقط في الإصدار 3.x من وقت تشغيل الوظائف، والذي لم يعد مدعوما. بالنسبة للإصدار 4.x، استخدم بدلاً من ذلك AzureWebJobsSecretStorageKeyVaultUri. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType إلى keyvault.

يجب أن يكون للمخزن نهج وصول يتوافق مع الهوية المُدارة التي يعينها النظام لمورد الاستضافة. يجب أن يمنح نهج الوصول الهوية الأذونات السرية التالية: Get وSet وList وDelete.

عند تشغيل وظائفك محليا، يتم استخدام هوية المطور. يجب أن تكون الإعدادات في ملفlocal.settings.json.

Key عينة القيمة
AzureWebJobsSecretStorageKeyVaultName <VAULT_NAME>

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsSecretStorageKeyVaultTenantId

معرف المستأجر الخاص بتسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType إلى keyvault. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف. لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

Key عينة القيمة
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

عنوان URL لمثال مخزن المفاتيح المستخدم لتخزين المفاتيح. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف. نوصي بهذا الإعداد لاستخدام مثيل key vault لتخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType إلى keyvault.

AzureWebJobsSecretStorageKeyVaultUri يجب أن تكون القيمة هي القيمة الكاملة لعنوان URI ل Vault المعروضة في علامة التبويب نظرة عامة على Key Vault، بما في ذلك https://.

يجب أن يكون للمخزن نهج وصول يتوافق مع الهوية المُدارة التي يعينها النظام لمورد الاستضافة. يجب أن يمنح نهج الوصول الهوية الأذونات السرية التالية: Get وSet وList وDelete.
عند تشغيل الوظائف محليا، يتم استخدام هوية المطور، ويجب أن تكون الإعدادات في ملفlocal.settings.json.

Key عينة القيمة
AzureWebJobsSecretStorageKeyVaultUri https://<VAULT_NAME>.vault.azure.net

Important

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

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsSecretStorageSas

عنوان URL الخاص بـ Blob Storage SAS لحساب التخزين الثاني المستخدم لتخزين المفاتيح. بشكل افتراضي، تستخدم الوظائف الحساب المعين في AzureWebJobsStorage. عند استخدام خيار التخزين السري هذا، تأكد من أن AzureWebJobsSecretStorageType لم يتم تعيينه صراحةً أو أنه مضبوط على blob. لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

Key عينة القيمة
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

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

Key Value Description
AzureWebJobsSecretStorageType blob يتم تخزين المفاتيح في حاوية تخزين Blob في الحساب المقدم من خلال الإعداد AzureWebJobsStorage. تخزين Blob هو السلوك الافتراضي عندما AzureWebJobsSecretStorageType لا يتم تعيين.
لتحديد حساب تخزين مختلف، استخدم الإعداد AzureWebJobsSecretStorageSas للإشارة إلى SAS URL لحساب التخزين الثاني.
AzureWebJobsSecretStorageType files تستمر المفاتيح في نظام الملفات. هذا السلوك هو الافتراضي ل Functions v1.x.
AzureWebJobsSecretStorageType keyvault يتم تخزين المفاتيح في مثيل مخزن مفاتيح تم تعيينه بواسطة AzureWebJobsSecretStorageKeyVaultName.
AzureWebJobsSecretStorageType kubernetes مدعوم فقط عند تشغيل وقت تشغيل الوظائف في Kubernetes. عندما AzureWebJobsKubernetesSecretName لا يتم تعيين، يعتبر المستودع للقراءة فقط. في هذه الحالة، يجب إنشاء القيم قبل النشر. تُنشئ أدوات Azure Functions الأساسية القيم تلقائياً عند التوزيع إلى Kubernetes.

لمعرفة المزيد، راجع إدارة تخزين المفاتيح.

AzureWebJobsStorage

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

Key عينة القيمة
AzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=...

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

AzureWebJobsStorage__accountName

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

Key عينة القيمة
AzureWebJobsStorage__accountName <STORAGE_ACCOUNT_NAME>

بالنسبة للسحب السيادية أو عند استخدام DNS مخصص، يجب عليك بدلا من ذلك استخدام الإعدادات الخاصة AzureWebJobsStorage__*ServiceUri بالخدمة.

AzureWebJobsStorage__blobServiceUri

عند استخدام اتصال تخزين يستند إلى الهوية، يعين URI لمستوى البيانات لخدمة blob لحساب التخزين.

Key عينة القيمة
AzureWebJobsStorage__blobServiceUri https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

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

AzureWebJobsStorage__clientId

يعين معرف العميل لهوية معينة معينة من قبل المستخدم تستخدم للحصول على رمز وصول مميز لمصادقة الهوية المدارة. يتطلب تعيين AzureWebJobsStorage__credential على managedidentity. القيمة هي معرف عميل يتوافق مع هوية معينة للتطبيق. لا يمكنك تعيين كلا AzureWebJobsStorage__managedIdentityResourceId الاثنين و AzureWebJobsStorage__clientId. عند عدم التعيين، يتم استخدام الهوية المعينة من قبل النظام.

AzureWebJobsStorage__credential

يحدد كيفية الحصول على رمز مميز للوصول للاتصال. يستخدم managedidentity لمصادقة الهوية المدارة. عند الاستخدام managedidentity، يجب أن تكون الهوية المدارة متوفرة في بيئة الاستضافة. لا تقم بتعيين AzureWebJobsStorage__credential سيناريوهات التنمية المحلية.

AzureWebJobsStorage__managedIdentityResourceId

يعين معرف المورد للهوية المعينة من قبل المستخدم المستخدمة للحصول على رمز وصول مميز لمصادقة الهوية المدارة. يتطلب تعيين AzureWebJobsStorage__credential على managedidentity. القيمة هي معرف المورد لهوية معينة للتطبيق المستخدم لمصادقة الهوية المدارة. لا يمكنك تعيين كلا AzureWebJobsStorage__managedIdentityResourceId الاثنين و AzureWebJobsStorage__clientId. عند عدم التعيين، يتم استخدام الهوية المعينة من قبل النظام.

AzureWebJobsStorage__queueServiceUri

عند استخدام اتصال تخزين يستند إلى الهوية، يعين URI لمستوى البيانات لخدمة قائمة الانتظار لحساب التخزين.

Key عينة القيمة
AzureWebJobsStorage__queueServiceUri https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net

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

AzureWebJobsStorage__tableServiceUri

عند استخدام اتصال تخزين يستند إلى الهوية، يقوم بتعيين URI لمستوى البيانات لخدمة جدول لحساب التخزين.

Key عينة القيمة
AzureWebJobsStorage__tableServiceUri https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net

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

AzureWebJobs_TypeScriptPath

المسار إلى المحول البرمجي المستخدم لـ TypeScript. يسمح لك بتجاوز الإعداد الافتراضي إذا كنت بحاجة إلى ذلك.

Key عينة القيمة
AzureWebJobs_TypeScriptPath %HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

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

DOCKER_REGISTRY_SERVER_URL

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

DOCKER_REGISTRY_SERVER_USERNAME

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

DOCKER_SHM_SIZE

يضبط حجم الذاكرة المشتركة (بالبايت) عندما يستخدم عامل Python الذاكرة المشتركة. لمعرفة المزيد، راجع الذاكرة المشتركة.

Key عينة القيمة
DOCKER_SHM_SIZE 268435456

تعين القيمة السابقة حجم ذاكرة مشترك يبلغ ~256 ميغابايت.

يتطلب تعيين FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED على 1.

ENABLE_ORYX_BUILD

يشير إلى ما إذا كان يتم استخدام نظام إنشاء Oryx أثناء النشر. ENABLE_ORYX_BUILD يجب تعيين إلى true عند القيام بنشرات البناء عن بعد إلى Linux. لمزيد من المعلومات، راجع الإنشاء عن بعد.

Key عينة القيمة
ENABLE_ORYX_BUILD true

FUNCTION_APP_EDIT_MODE

يشير إلى ما إذا كان يمكنك تحرير تطبيق الوظائف في مدخل Microsoft Azure. القيم الصالحة هي readwrite و readonly.

Key عينة القيمة
FUNCTION_APP_EDIT_MODE readonly

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

FUNCTIONS_EXTENSION_VERSION

إصدار Functions runtime الذي يستضيف تطبيق الوظائف. تعني tilde (~) ذات الإصدار الرئيسي استخدام أحدث إصدار من هذا الإصدار الرئيسي، على سبيل المثال، ~4. عند توفر إصدارات ثانوية جديدة من نفس الإصدار الرئيسي، يتم تثبيتها تلقائيا في تطبيق الوظائف.

Key عينة القيمة
FUNCTIONS_EXTENSION_VERSION ~4

قيم إصدار وقت التشغيل الرئيسية التالية مدعومة:

Value هدف وقت التشغيل Comment
~4 4.x Recommended
~1 1.x ينتهي الدعم في 14 سبتمبر 2026

تعني قيمة ~4 أن تطبيقك يعمل على الإصدار 4.x من وقت التشغيل. تُثبت قيمة ~1 التطبيق الخاص بك إلى الإصدار 1.x من runtime. لم تعد إصدارات وقت التشغيل 2.x و3.x مدعومة. لمزيد من المعلومات، راجع نظرة عامة على إصدارات وقت تشغيل Azure Functions.

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

FUNCTIONS_INPROC_NET8_ENABLED

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

Key عينة القيمة
FUNCTIONS_INPROC_NET8_ENABLED 1

قم بتعيين إلى 0 لتعطيل دعم .NET 8 على النموذج قيد المعالجة.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

يعد إعداد التطبيق هذا طريقة مؤقتة لتطبيقات Node.js لتمكين تغيير فاصل يسهل استكشاف أخطاء نقطة الإدخال وإصلاحها على Node.js v18 أو أقل. نوصي بشدة باستخدام true، خاصة لتطبيقات نموذج البرمجة v4، والتي تستخدم دائما ملفات نقطة الإدخال. يتجاهل السلوك بدون التغيير العاجل (false) أخطاء نقطة الإدخال ولا يسجلها في Application Insights.

بدءا من Node.js v20، لا يكون لإعداد التطبيق أي تأثير ويتم تمكين سلوك التغيير العاجل دائما.

بالنسبة Node.js v18 أو أقل، يتم استخدام إعداد التطبيق، ويعتمد السلوك الافتراضي على ما إذا حدث الخطأ قبل تسجيل دالة v4 للنموذج أو بعده:

  • إذا تم طرح الخطأ من قبل، يتطابق السلوك الافتراضي مع false. على سبيل المثال، إذا كنت تستخدم الطراز v3 أو لم يكن ملف نقطة الإدخال موجودا.
  • إذا تم طرح الخطأ بعد، يتطابق السلوك الافتراضي مع true. على سبيل المثال، إذا حاولت تسجيل وظائف نموذج v4 مكررة.
Key Value Description
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true حظر أخطاء نقطة الإدخال وتسجيلها في Application Insights.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false تجاهل أخطاء نقطة الإدخال ولا تسجلها في Application Insights.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

يتجاوز الحد الافتراضي لحجم النص الأساسي للطلبات المرسلة إلى نقاط نهاية HTTP. يتم إعطاء القيمة بالبايت، بحد أقصى افتراضي لحجم الطلب 104,857,600 بايت.

Key عينة القيمة
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Important

لم يعد هذا الإعداد مدعوما. تم توفيره في الأصل لتمكين حل بديل قصير الأجل للتطبيقات التي تستهدف وقت تشغيل v2.x. سيكونون قادرين على تشغيل بدلا من ذلك في وقت تشغيل v3.x بينما كان لا يزال مدعوما. باستثناء التطبيقات القديمة التي تعمل على الإصدار 1.x، يجب تشغيل جميع تطبيقات الوظائف على الإصدار 4.x من وقت تشغيل الوظائف: FUNCTIONS_EXTENSION_VERSION=~4. لمزيد من المعلومات، راجع نظرة عامة على إصدارات وقت تشغيل Azure Functions.

FUNCTIONS_WORKER_PROCESS_COUNT

تحديد الحد الأقصى لعدد عمليات عامل اللغة، بقيمة افتراضية 1. الحد الأقصى للقيمة المسموح به هو 10. يتم توزيع استدعاءات الوظيفة بالتساوي بين عمليات عامل اللغة. يتم إنتاج عمليات عامل اللغة كل 10 ثوان حتى يتم الوصول إلى العدد الذي تم تعيينه بواسطة FUNCTIONS_WORKER_PROCESS_COUNT . استخدام عمليات عامل متعدد اللغات يختلف عن التحجيم. ضع في اعتبارك استخدام هذا الإعداد عندما يشتمل حمل عملك على مزيج من الاستدعاءات المرتبطة بـ CPU والمرتبطة بالإدخال/الإخراج. ينطبق هذا الإعداد على جميع أوقات تشغيل اللغة، باستثناء .NET قيد التشغيل قيد المعالجة (FUNCTIONS_WORKER_RUNTIME=dotnet).

Key عينة القيمة
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

اللغة أو مكدس اللغة لوقت تشغيل العامل لتحميله في تطبيق الوظائف. تتوافق هذه القيمة مع اللغة المستخدمة في التطبيق الخاص بك، على سبيل المثال، python. بدءًا من الإصدار 2.x من Azure Functions runtime، يمكن لتطبيق وظائف معين دعم لغة واحدة فقط.

Key عينة القيمة
FUNCTIONS_WORKER_RUNTIME node

قيم صالحة:

Value حزمة اللغة/اللغة
dotnet C# (مكتبة الفئات)
C # (نص)
dotnet-isolated C# (عملية عامل معزولة)
java Java
node JavaScript
TypeScript
powershell PowerShell
python Python
custom Other

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

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

Key عينة القيمة
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED 1

مع تمكين هذا الإعداد، يمكنك استخدام إعداد DOCKER_SHM_SIZE لتعيين حجم الذاكرة المشتركة. لمعرفة المزيد، راجع الذاكرة المشتركة.

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

يشير إلى ما إذا كان يجب على عملية عامل Java إخراج بيانات تتبع الاستخدام بتنسيق القياس عن بعد المفتوح إلى نقطة نهاية Application Insights. يؤدي تعيين هذه العلامة إلى True إخبار مضيف الوظائف بالسماح لعامل Java بمعالجة دفق سجلات OpenTelemetry مباشرة، مما يمنع الإدخالات المكررة على مستوى المضيف. لمزيد من المعلومات، راجع تكوين إعدادات التطبيق.

JAVA_ENABLE_SDK_TYPES

تمكين تطبيق الوظائف من استخدام أنواع Azure SDK الأصلية في الروابط.

Note

دعم الربط إلى أنواع SDK قيد المعاينة حاليا ويقتصر على Azure Blob Storage SDK. لمزيد من المعلومات، راجع أنواع SDK في المقالة المرجعية Java.

Key عينة القيمة
JAVA_ENABLE_SDK_TYPES true

لمزيد من المعلومات، راجع أنواع SDK في المقالة المرجعية Java.

JAVA_OPTS

يستخدم لتخصيص جهاز Java الظاهري (JVM) المستخدم لتشغيل وظائف Java عند التشغيل على خطة Premium أو خطة مخصصة. عند التشغيل على خطة Consumption، استخدم languageWorkers__java__argumentsبدلا من ذلك . لمزيد من المعلومات، راجع تخصيص JVM.

languageWorkers__java__arguments

يستخدم لتخصيص جهاز Java الظاهري (JVM) المستخدم لتشغيل وظائف Java عند التشغيل على خطة الاستهلاك. يزيد هذا الإعداد من أوقات البدء الباردة لوظائف Java التي تعمل في خطة Consumption. بالنسبة لخطة Premium أو Dedicated، استخدم JAVA_OPTSبدلا من ذلك . لمزيد من المعلومات، راجع تخصيص JVM.

MDMaxBackgroundUpgradePeriod

يتحكم في فترة تحديث خلفية التبعيات المُدارة لتطبيقات وظائف PowerShell، بقيمة افتراضية 7.00:00:00 (أسبوعيًا).

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

Key عينة القيمة
MDMaxBackgroundUpgradePeriod 7.00:00:00

لمعرفة المزيد، راجع إدارة التبعية.

MDNewSnapshotCheckPeriod

تحديد عدد المرات التي يتحقق فيها كل عامل PowerShell من تثبيت ترقيات التبعية المدارة. التردد الافتراضي هو 01:00:00 (بالساعة).

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

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

Key عينة القيمة
MDNewSnapshotCheckPeriod 01:00:00

لمعرفة المزيد، راجع إدارة التبعية.

MDMinBackgroundUpgradePeriod

الفترة الزمنية بعد إجراء فحص سابق لترقية التبعية المُدارة قبل بدء فحص ترقية آخر، مع الإعداد الافتراضي 1.00:00:00 (يومياً).

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

Key عينة القيمة
MDMinBackgroundUpgradePeriod 1.00:00:00

لمعرفة المزيد، راجع إدارة التبعية.

OTEL_EXPORTER_OTLP_ENDPOINT

يشير إلى عنوان URL الذي يتم تصدير البيانات المنسقة بتنسيق OpenTelemetry إليه للاستيعاب. لمزيد من المعلومات، راجع استخدام OpenTelemetry مع Azure Functions.

OTEL_EXPORTER_OTLP_HEADERS

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

PIP_INDEX_URL

يتيح لك هذا الإعداد تجاوز عنوان URL الأساسي لـ Python Package Index، والذي يكون https://pypi.org/simpleبشكل افتراضي. استخدم هذا الإعداد عندما تحتاج إلى تشغيل بنية بعيدة باستخدام تبعيات مخصصة. يمكن أن تكون هذه التبعيات المخصصة في مستودع فهرس حزمة متوافق مع PEP 503 (واجهة برمجة تطبيقات المستودع البسيطة) أو في دليل محلي يتبع نفس التنسيق.

Key عينة القيمة
PIP_INDEX_URL http://my.custom.package.repo/simple

لمعرفة المزيد، راجع pipوثائق--index-urlواستخدام التبعية المخصصة في مرجع مطور Python.

PIP_EXTRA_INDEX_URL

تشير قيمة هذا الإعداد إلى عنوان URL إضافي للفهرس للحزم المخصصة لتطبيقات Python، لاستخدامها بالإضافة إلى --index-url. استخدم هذا الإعداد عندما تحتاج إلى تشغيل البناء عن بعد باستخدام تبعيات مخصصة موجودة في فهرس حزمة إضافية. يجب أن تتبع نفس القواعد مثل --index-url.

Key عينة القيمة
PIP_EXTRA_INDEX_URL http://my.custom.package.repo/simple

لمعرفة المزيد، راجع pipوثائق--extra-index-urlواستخدام التبعية المخصصة في مرجع مطور Python.

PROJECT

إعداد نشر مستمر يخبر خدمة نشر Kudu بالمجلد الموجود في مستودع متصل لتحديد موقع المشروع القابل للنشر.

Key عينة القيمة
PROJECT WebProject/WebProject.csproj

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

يشير إلى ما إذا كان يجب على عملية عامل Python إخراج بيانات تتبع الاستخدام بتنسيق القياس عن بعد المفتوح إلى نقطة نهاية Application Insights. يؤدي تعيين هذه العلامة إلى True إخبار مضيف الوظائف بالسماح لعامل Python بتصدير بيانات OpenTelemetry إلى نقطة نهاية Application Insights. لمزيد من المعلومات، راجع تكوين إعدادات التطبيق.

PYTHON_ISOLATE_WORKER_DEPENDENCIES

التكوين خاص بتطبيقات وظائف Python. وهو يحدد أولوية ترتيب تحميل الوحدة. تُعيّن هذه القيمة افتراضيًا إلى 0.

Key Value Description
PYTHON_ISOLATE_WORKER_DEPENDENCIES 0 تحديد أولويات تحميل مكتبات Python من تبعيات عامل Python الداخلية، وهو السلوك الافتراضي. قد يتم تظليل المكتبات غير التابعة ل Microsoft المعرفة في requirements.txt.
PYTHON_ISOLATE_WORKER_DEPENDENCIES 1 تحديد أولويات تحميل مكتبات Python من حزمة التطبيق الداخلية في requirements.txt. تمنع هذه القيمة مكتباتك من الاصطدام بمكتبات عامل Python الداخلية.

PYTHON_ENABLE_DEBUG_LOGGING

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

عند تصحيح أخطاء وظائف Python، تأكد أيضا من تعيين مستوى تسجيل تصحيح الأخطاء أو التتبع في ملف host.json، حسب الحاجة. لمعرفة المزيد، راجع كيفية تكوين مراقبة لـAzure Functions.

PYTHON_ENABLE_OPENTELEMETRY

يشير إلى ما إذا كان يجب على عملية عامل Python تصدير بيانات تتبع الاستخدام إلى نقطة نهاية القياس عن بعد المفتوحة. يؤدي تعيين هذه العلامة إلى True إخبار مضيف الوظائف بالسماح لعامل Python بتصدير بيانات OpenTelemetry إلى OTEL_EXPORTER_OTLP_ENDPOINT التي تم تكوينها. لمزيد من المعلومات، راجع تكوين إعدادات التطبيق.

PYTHON_ENABLE_WORKER_EXTENSIONS

التكوين خاص بتطبيقات وظائف Python. تعيين هذه القيمة للسماح 1 للعامل بالتحميل في ملحقات عامل Python المحددة في requirements.txt. فهو يمكن تطبيق الوظائف من الوصول إلى الميزات الجديدة التي توفرها حزم الشركاء. كما يمكنه تغيير سلوك تحميل الوظيفة والاستدعاء في تطبيقك. تأكد من أن الملحق الذي تختاره جدير بالثقة حيث تتحمل خطر استخدامه. لا تقدم Azure Functions أي ضمانات صريحة لأي ملحقات. لمعرفة كيفية استخدام ملحق، تفضل بزيارة الصفحة اليدوية للملحق أو مستند readme. بشكل افتراضي، يتم تعيين هذه القيمة إلى 0.

Key Value Description
PYTHON_ENABLE_WORKER_EXTENSIONS 0 تعطيل أي ملحق عامل Python.
PYTHON_ENABLE_WORKER_EXTENSIONS 1 السماح لعامل Python بتحميل الملحقات من requirements.txt.

PYTHON_THREADPOOL_THREAD_COUNT

يحدد الحد الأقصى لعدد مؤشرات الترابط التي سيستخدمها عامل لغة Python لتشغيل استدعاءات الدالة، بقيمة افتراضية 1 لإصدار Python 3.8 وما دونه. لإصدار Python 3.9 وما فوق، يتم تعيين القيمة إلى None. لا يضمن هذا الإعداد عدد مؤشرات الترابط التي سيتم تعيينها أثناء عمليات التنفيذ. يسمح الإعداد لـ Python بتوسيع عدد مؤشرات الترابط إلى القيمة المحددة. ينطبق الإعداد فقط على تطبيقات وظائف Python. بالإضافة إلى ذلك، ينطبق الإعداد على استدعاء الوظائف المتزامنة وليس لـ coroutines.

Key عينة القيمة القيمة القصوى
PYTHON_THREADPOOL_THREAD_COUNT 2 32

SCALE_CONTROLLER_LOGGING_ENABLED

هذا الإعداد قيد المعاينة حاليًا.

يتحكم هذا الإعداد في تسجيل الدخول من وحدة تحكم في مقياس Azure Functions. لمزيد من المعلومات، راجع سجلات وحدة التحكم في المقياس.

Key عينة القيمة
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

يتم توفير قيمة هذا المفتاح بالتنسيق <DESTINATION>:<VERBOSITY>، والذي يتم تعريفه كما يلي:

Property Description
<DESTINATION> الوجهة التي يتم إرسال السجلات إليها. القيم الصالحة هي AppInsights و Blob.
عند استخدام AppInsights، تأكد من تمكين Application Insights في تطبيق وظيفتك.
عند تعيين الوجهة على Blob، يتم إنشاء السجلات في حاوية تخزين البيانات الثنائية الكبيرة المسماة azure-functions-scale-controller في حساب التخزين الافتراضي الذي تم تعيينه في إعداد التطبيق AzureWebJobsStorage.
<VERBOSITY> يحدد مستوى التسجيل. القيم المعتمدة هي None و Warning و Verbose.
عند ضبطه على Verbose، يسجل مراقب المقياس سببًا لكل تغيير في عدد العمال، ومعلومات حول المحفزات التي تدخل في تلك القرارات. تتضمن السجلات المطولة تحذيرات التشغيل والتجزئة المستخدمة بواسطة المشغلات قبل وبعد تشغيل وحدة التحكم في الميزان.

Tip

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

SCM_DO_BUILD_DURING_DEPLOYMENT

يتحكم في سلوك الإنشاء عن بعد أثناء النشر. عند SCM_DO_BUILD_DURING_DEPLOYMENT تعيين إلى true، يتم إنشاء المشروع عن بعد أثناء النشر.

Key عينة القيمة
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

يتحكم في المهلة، بالثواني، عند الاتصال بسجلات الدفق. القيمة الافتراضية هي 7200 (ساعتان).

Key عينة القيمة
SCM_LOGSTREAM_TIMEOUT 1800

تعين قيمة العينة 1800 السابقة مهلة 30 دقيقة. لمزيد من المعلومات، راجع تمكين سجلات تنفيذ الدفق في Azure Functions.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

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

Key عينة القيمة
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=...

هذا الإعداد مطلوب لكل من تطبيقات خطة الاستهلاك وخطة Elastic Premium. وهو غير مطلوب لتطبيقات الخطة المخصصة، والتي لا تتوسع الوظائف ديناميكيا.

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

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

لا تدعم Azure Files استخدام الهوية المدارة عند الوصول إلى مشاركة الملف. لمزيد من المعلومات، راجع سيناريوهات المصادقة المدعومة من Azure Files.

WEBSITE_CONTENTOVERVNET

Important

WEBSITE_CONTENTOVERVNET هو إعداد تطبيق قديم تم استبداله بخاصية موقع vnetContentShareEnabled .

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

Key عينة القيمة
WEBSITE_CONTENTOVERVNET 1

هذا الإعداد مطلوب لتوسيع الطابع المتقاطع في خطط Elastic PremiumوDedicated (خدمة التطبيقات) (القياسية والأعلى) عندما يكون حساب التخزين مقيدا ب VNet. بدون هذا الإعداد، يمكن لتطبيق الوظيفة التكبير ضمن طابع واحد فقط (حوالي 1-20 حالة). غير مدعوم عند التشغيل على خطة استهلاك.

Note

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

WEBSITE_CONTENTSHARE

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

Key عينة القيمة
WEBSITE_CONTENTSHARE functionapp091999e2

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

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

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

تنطبق الاعتبارات التالية عند استخدام قالب Azure Resource Manager (ARM) أو ملف Bicep لإنشاء تطبيق دالة أثناء النشر:

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

WEBSITE_DNS_SERVER

تعيين خادم DNS المستخدم من قبل تطبيق عند حل عناوين IP. غالبًا ما يكون هذا الإعداد مطلوبًا عند استخدام وظائف معينة للشبكات، مثل مناطق Azure DNS الخاصة ونقاط النهاية الخاصة.

Key عينة القيمة
WEBSITE_DNS_SERVER 168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

يتحكم في ما إذا كان ترميز Brotli يُستخدم للضغط بدلًا من ضغط gzip الافتراضي. عندما WEBSITE_ENABLE_BROTLI_ENCODING يتم تعيين إلى 1، يتم استخدام ترميز Brotli. وإلا، يتم استخدام ترميز gzip.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

تعطيل التخزين المؤقت عند نشر تطبيقات الوظائف باستخدام قوالب Azure Resource Manager (ARM).

Key عينة القيمة
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

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

Important

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

Key عينة القيمة
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 5

WEBSITE_NODE_DEFAULT_VERSION

Windows فقط. تعيين إصدار Node.js لاستخدامه عند تشغيل تطبيق الوظائف على Windows. يجب استخدام التلده (~) لجعل وقت التشغيل يستخدم أحدث إصدار متوفر من الإصدار الرئيسي المستهدف. على سبيل المثال، عند التعيين إلى ~18، يتم استخدام أحدث إصدار من Node.js 18. عندما يتم استهداف إصدار رئيسي باستخدام تيلدا، لا يتعين عليك تحديث الإصدار الثانوي يدويًا.

Key عينة القيمة
WEBSITE_NODE_DEFAULT_VERSION ~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

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

Key عينة القيمة
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

أضف WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS بقيمة لكافة 0 الفتحات للتأكد من أن إعدادات التشخيص القديمة لا تحظر عمليات التبديل الخاصة بك. يمكنك أيضا إضافة هذا الإعداد والقيمة إلى فتحة الإنتاج فقط كإعداد فتحة نشر (ملصقة).

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

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

Key عينة القيمة
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS 0

WEBSITE_RUN_FROM_PACKAGE

تمكين تطبيق الوظائف من التشغيل من ملف حزمة، والذي يمكن تحميله محليا أو نشره في عنوان URL خارجي.

Key عينة القيمة
WEBSITE_RUN_FROM_PACKAGE 1

القيم الصالحة هي إما عنوان URL الذي يتم حله إلى موقع ملف حزمة نشر خارجي، أو 1. عند التعيين إلى 1، يجب أن تكون الحزمة في d:\home\data\SitePackages المجلد. عند استخدام نشر zip مع WEBSITE_RUN_FROM_PACKAGE تمكين، يتم تحميل الحزمة تلقائيا إلى هذا الموقع. لمزيدٍ من المعلومات، راجع تشغيل الوظائف الخاصة بك من ملف حزمة.

عند استخدام WEBSITE_RUN_FROM_PACKAGE=<URL>، يجب أن يتم حل عنوان URL إلى موقع ملف الحزمة في موقع تخزين يمكن الوصول إليه، مثل حاوية Azure Blob Storage. يجب أن تكون الحاوية خاصة لمنع الوصول غير المصرح به، الأمر الذي يتطلب منك استخدام إما توقيع وصول مشترك (SAS) في عنوان URL أو مصادقة معرف Microsoft Entra للسماح بالوصول. يوصى باستخدام معرف Microsoft Entra مع الهويات المدارة.

هذا مثال على الإعداد WEBSITE_RUN_FROM_PACKAGE إلى عنوان URL لحزمة توزيع في حاوية تخزين مدونة Azure:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip

عند استخدام SAS، يمكنك إلحاق الرمز المميز بعنوان URL كمعلمة استعلام.

عند نشر حزمة من Azure Blob Storage باستخدام هوية مدارة معينة من قبل المستخدم، يجب عليك أيضا التعيين WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID إلى معرف المورد للهوية المدارة المعينة من قبل المستخدم. عند النشر من عنوان URL لحزمة خارجية، يجب عليك أيضا مزامنة المشغلات يدويا. لمزيد من المعلومات، راجع مزامنة المشغل.

WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID

يشير إلى معرف المورد لهوية مدارة معينة من قبل المستخدم يتم استخدامها عند الوصول إلى حزمة توزيع من حاوية Azure Blob Storage خارجية مؤمنة باستخدام معرف Microsoft Entra. يتطلب هذا الإعداد تعيين WEBSITE_RUN_FROM_PACKAGE ذلك إلى عنوان URL لحزمة النشر في حاوية خاصة.

الإعداد WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned هو نفسه حذف الإعداد، وفي هذه الحالة يتم استخدام الهوية المدارة المعينة من قبل النظام للتطبيق.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

تحتوي إعدادات WEBSITE_CONTENTAZUREFILECONNECTIONSTRING و WEBSITE_CONTENTSHARE على فحوصات تحقق إضافية للتأكد من إمكانية بدء تشغيل التطبيق بشكل صحيح. فشل إنشاء إعدادات التطبيق عندما لا يمكن لتطبيق الوظائف استدعاء حساب التخزين المتلقي للمعلومات أو Key Vault بشكل صحيح بسبب قيود الشبكة أو عوامل الحد الأخرى. عند تعيين WEBSITE_SKIP_CONTENTSHARE_VALIDATION إلى 1، يتم تخطي التحقق من الصحة. وإلا، يتم تعيين القيمة افتراضيا إلى 0 ويتم التحقق من الصحة.

Key عينة القيمة
WEBSITE_SKIP_CONTENTSHARE_VALIDATION 1

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

WEBSITE_SLOT_NAME

Read-only. اسم فتحة التوزيع الحالية. اسم خانة الإنتاج هو Production.

Key عينة القيمة
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

يسمح لك بتعيين المنطقة الزمنية لتطبيق الوظائف.

Key OS عينة القيمة
WEBSITE_TIME_ZONE Windows Eastern Standard Time
WEBSITE_TIME_ZONE Linux America/New_York

المنطقة الزمنية الافتراضية المستخدمة مع تعبيرات CRON هي التوقيت العالمي (UTC). للحصول على تعبير CRON الخاص بك استناداً إلى منطقة زمنية أخرى، قم بإنشاء إعداد تطبيق لتطبيق وظيفتك باسم WEBSITE_TIME_ZONE.

تعتمد قيمة هذا الإعداد على نظام التشغيل والخطة التي يعمل عليها تطبيق وظيفتك.

نظام التشغيل Plan Value
Windows All عيّن القيمة على اسم المنطقة الزمنية المطلوبة كما هو محدد في السطر الثاني من كل زوج من الأزواج المعطاة بواسطة أمر Windows tzutil.exe /L
Linux Premium
Dedicated		 قم بتعيين القيمة إلى اسم المنطقة الزمنية المطلوبة كما هو موضح في قاعدة بيانات tz

Note

WEBSITE_TIME_ZONEوهي TZ غير مدعومة حاليا عند التشغيل على Linux في خطة الاستهلاك أو الاستهلاك المرنة. في هذه الحالة، يمكن للإعداد WEBSITE_TIME_ZONE أو TZ إنشاء مشكلات متعلقة ب SSL والتسبب في توقف المقاييس عن العمل لتطبيقك.

على سبيل المثال، يستخدم Eastern Time في الولايات المتحدة (يتم تمثيله بواسطة Eastern Standard Time (Windows) أو America/New_York (Linux)) حالياً UTC-05:00 خلال التوقيت القياسي وUTC-04:00 خلال التوقيت الصيفي. لتشغيل مؤقت يعمل في الساعة 10:00 صباحاً بالتوقيت الشرقي كل يوم، أنشئ إعداد تطبيق لتطبيق وظيفتك باسم WEBSITE_TIME_ZONE، واضبط القيمة على Eastern Standard Time (Windows) أو America/New_York (Linux)، ثم استخدم تعبير NCRONTAB التالي:

"0 0 10 * * *"

عند استخدام WEBSITE_TIME_ZONE، يتم ضبط الوقت لتغييرات الوقت في المنطقة الزمنية المحددة، بما في ذلك التوقيت الصيفي والتغييرات في التوقيت القياسي.

WEBSITE_USE_PLACEHOLDER

يشير إلى ما إذا كان سيتم استخدام تحسين بدء التشغيل البارد المحدد عند التشغيل على خطة الاستهلاك. قم بتعيين إلى 0 لتعطيل تحسين البداية الباردة في خطة الاستهلاك.

Key عينة القيمة
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

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

Key عينة القيمة
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Important

WEBSITE_VNET_ROUTE_ALL هو إعداد تطبيق قديم تم استبداله بإعداد موقع vnetRouteAllEnabled .

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

Key عينة القيمة
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

يشير إلى ما إذا كان /home الدليل مشتركا عبر مثيلات ذات مقياس، بقيمة افتراضية هي true. يجب تعيين هذه القيمة إلى false عند نشر تطبيق الوظائف في حاوية.

إعدادات موقع App Service

يجب الاحتفاظ ببعض التكوينات على مستوى App Service كإعدادات موقع، مثل إصدارات اللغة. تتم إدارة هذه الإعدادات في مدخل Microsoft Azure، أو باستخدام واجهات برمجة تطبيقات REST، أو باستخدام Azure CLI أو Azure PowerShell. فيما يلي إعدادات الموقع التي قد تكون مطلوبة، اعتمادا على لغة وقت التشغيل ونظام التشغيل والإصدارات.

AcrUseManagedIdentityCreds

يشير إلى ما إذا كان يتم الحصول على الصورة من مثيل Azure Container Registry باستخدام مصادقة الهوية المدارة. تتطلب قيمة true استخدام الهوية المدارة. نوصي بهذا الأسلوب عبر بيانات اعتماد المصادقة المخزنة كأفضل ممارسة أمان.

AcrUserManagedIdentityID

يشير إلى الهوية المدارة لاستخدامها عند الحصول على الصورة من مثيل Azure Container Registry. يتطلب تعيين AcrUseManagedIdentityCreds إلى true. هذه القيم صالحة:

Value Description
system يتم استخدام الهوية المدارة المعينة من قبل النظام لتطبيق الوظائف.
<USER_IDENTITY_RESOURCE_ID> معرف المورد المؤهل بالكامل للهوية المدارة المعينة من قبل المستخدم.

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

alwaysOn

في تطبيق الوظائف الذي يعمل في خطة مخصصة (خدمة التطبيقات)، يتعطل وقت تشغيل الوظائف بعد بضع دقائق من عدم النشاط، حيث تقوم النقطة التي تطلب فقط إلى مشغل HTTP تنبيه تطبيق الوظائف الخاص بك. للتأكد من تشغيل الوظائف التي تم تشغيلها بدون HTTP بشكل صحيح، بما في ذلك وظائف مشغل المؤقت، قم بتمكين Always On لتطبيق الوظائف عن طريق تعيين alwaysOn إعداد الموقع إلى قيمة true.

functionsRuntimeAdminIsolationEnabled

تحديد ما إذا كان يمكن الوصول إلى نقاط نهاية المسؤول المضمنة (/admin) في تطبيق الوظائف. عند التعيين إلى false (الافتراضي)، يسمح التطبيق بالطلبات إلى نقاط النهاية ضمن /admin عندما تقدم هذه الطلبات مفتاحا رئيسيا في الطلب. عندما true، /admin لا يمكن الوصول إلى نقاط النهاية، حتى باستخدام مفتاح رئيسي.

لا يمكن تعيين هذه الخاصية للتطبيقات التي تعمل على Linux في خطة الاستهلاك. لا يمكن تعيينه للتطبيقات التي تعمل على الإصدار 1.x من Azure Functions. إذا كنت تستخدم الإصدار 1.x، فيجب عليك أولا الترحيل إلى الإصدار 4.x.

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

linuxFxVersion

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

يتم تعيين هذه القيمة لك عند إنشاء تطبيق وظائف Linux. قد تحتاج إلى تعيينه لقالب ARM وتوزيع Bicep وفي سيناريوهات ترقية معينة.

قيم linuxFxVersion صالحة

يمكنك استخدام أمر Azure CLI التالي لمشاهدة جدول القيم الحالية linuxFxVersion ، بواسطة إصدار وقت تشغيل Functions المدعوم:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

يتطلب منك الأمر السابق الترقية إلى الإصدار 2.40 من Azure CLI.

صور مخصصة

عند إنشاء حاوية Linux المخصصة الخاصة بك وصيانتها لتطبيق الوظائف الخاص بك، linuxFxVersion تكون القيمة بدلا من ذلك بالتنسيق DOCKER|<IMAGE_URI>، كما في المثال التالي:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

يشير هذا المثال إلى مصدر التسجيل للحاوية المنشورة. لمزيد من المعلومات، راجع العمل مع الحاويات وAzure Functions.

Important

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

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

netFrameworkVersion

تعيين الإصدار المحدد من .NET لوظائف C#. لمزيد من المعلومات، راجع تحديث تطبيق الوظائف في Azure.

powerShellVersion

تعيين الإصدار المحدد من PowerShell الذي تعمل عليه وظائفك. لمزيد من المعلومات، راجع تغيير إصدار PowerShell.

عند التشغيل محليا، يمكنك بدلا من ذلك استخدام FUNCTIONS_WORKER_RUNTIME_VERSION الإعداد في ملف local.settings.json.

vnetContentShareEnabled

تستخدم التطبيقات التي تعمل في خطة Premium مشاركة ملف لتخزين المحتوى. يتم تخزين اسم مشاركة المحتوى هذه في WEBSITE_CONTENTSHARE إعداد التطبيق ويتم تخزين سلسلة الاتصال في WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. لتوجيه نسبة استخدام الشبكة بين تطبيق الوظائف ومشاركة المحتوى من خلال شبكة ظاهرية، يجب عليك أيضا تعيين vnetContentShareEnabled إلى true. تفعيل خاصية هذا الموقع مطلوب لتحديد الطابع المتقاطع عند تقييد حساب التخزين الخاص بك بشبكة افتراضية في خطتي Elastic Premium وDedicated Hosting. بدون هذا الإعداد، يمكن لتطبيق الوظيفة التكبير ضمن طابع واحد فقط (حوالي 1-20 حالة).

Note

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

تحل خاصية الموقع هذه محل الإعداد القديم WEBSITE_CONTENTOVERVNET .

vnetImagePullEnabled

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

vnetRouteAllEnabled

يشير إلى ما إذا كان يتم توجيه جميع نسب استخدام الشبكة الصادرة من التطبيق عبر الشبكة الظاهرية. تشير قيمة الإعداد إلى true أن جميع حركة مرور التطبيق يتم توجيهها عبر الشبكة الظاهرية. استخدم هذا الإعداد عند تكوين تكامل الشبكة الظاهرية الإقليمية في خطط Elastic Premium و Dedicated. كما يتم استخدامه عند استخدام بوابة NAT لشبكة ظاهرية لتعريف عنوان IP الصادر الثابت. لمزيد من المعلومات، راجع تكوين توجيه التطبيق.

يحل إعداد الموقع هذا محل إعداد WEBSITE_VNET_ROUTE_ALL القديمة.

إهمال خطة الاستهلاك المرن

في خطة Flex Consumption، يتم إهمال خصائص الموقع وإعدادات التطبيق هذه ولا يجب استخدامها عند إنشاء موارد تطبيق الوظائف:

Setting/property Reason
ENABLE_ORYX_BUILD تم استبداله بالمعلمة remoteBuild عند النشر في Flex Consumption
FUNCTIONS_EXTENSION_VERSION يتم تعيين إعداد التطبيق بواسطة الخلفية. يمكن تجاهل قيمة ~1.
FUNCTIONS_WORKER_RUNTIME تم استبداله ب name في properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION تم استبداله ب version في properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY تم استبداله بقسم مشغل المقياس والتزامن
FUNCTIONS_WORKER_PROCESS_COUNT الإعداد غير صحيح
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED الإعداد غير صحيح
SCM_DO_BUILD_DURING_DEPLOYMENT تم استبداله بالمعلمة remoteBuild عند النشر في Flex Consumption
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING تم استبداله بقسم نشر functionAppConfig
WEBSITE_CONTENTOVERVNET غير مستخدم للشبكات في Flex Consumption
WEBSITE_CONTENTSHARE تم استبداله بقسم نشر functionAppConfig
WEBSITE_DNS_SERVER يتم توريث DNS من الشبكة الظاهرية المتكاملة في Flex
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT تم استبداله ب maximumInstanceCount في properties.functionAppConfig.scaleAndConcurrency
WEBSITE_NODE_DEFAULT_VERSION تم استبداله ب version في properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE غير مستخدمة في عمليات التوزيع في Flex Consumption
WEBSITE_SKIP_CONTENTSHARE_VALIDATION لا يتم استخدام مشاركة المحتوى في Flex Consumption
WEBSITE_VNET_ROUTE_ALL غير مستخدم للشبكات في Flex Consumption
properties.alwaysOn غير صالح
properties.containerSize تمت إعادة تسميتها باسم instanceMemoryMB
properties.ftpsState FTPS غير مدعوم
properties.isReserved غير صالح
properties.IsXenon غير صالح
properties.javaVersion تم استبداله ب version في properties.functionAppConfig.runtime
properties.LinuxFxVersion تم استبداله ب properties.functionAppConfig.runtime
properties.netFrameworkVersion تم استبداله ب version في properties.functionAppConfig.runtime
properties.powerShellVersion تم استبداله ب version في properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit تمت إعادة تسميتها باسم maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount تمت إعادة تسميتها باسم alwaysReadyInstances
properties.use32BitWorkerProcess 32 بت غير مدعوم
properties.vnetBackupRestoreEnabled غير مستخدم للشبكات في Flex Consumption
properties.vnetContentShareEnabled غير مستخدم للشبكات في Flex Consumption
properties.vnetImagePullEnabled غير مستخدم للشبكات في Flex Consumption
properties.vnetRouteAllEnabled غير مستخدم للشبكات في Flex Consumption
properties.windowsFxVersion غير صالح

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

  • Last updated on