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

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

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

• في Azure portal
• باستخدام Azure CLI
• باستخدام Azure PowerShell

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

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

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

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

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

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

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

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

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

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

• هناك خيارات app configuration دالة أخرى في ملف host.json وفي الملف local.settings.json.

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

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

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

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

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

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

تمكين access إلى 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>

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

Note

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

APPLICATIONINSIGHTS_CONNECTION_STRING

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

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

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

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

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

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Important

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

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Important

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

AZURE_FUNCTIONS_ENVIRONMENT

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

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

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

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

AzureFunctionsJobHost__*

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

AzureFunctionsWebHost__hostid

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

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

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

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

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

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

AzureWebJobsDashboard

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

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

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 Core Tools بإنشاء القيم تلقائيا عند النشر إلى Kubernetes.
• الأسرار غير القابلة للتغيير غير مدعومة ويؤدي استخدامها إلى حدوث أخطاء في وقت التشغيل.

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

AzureWebJobsSecretStorageKeyVaultClientId

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

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

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

AzureWebJobsSecretStorageKeyVaultClientSecret

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

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

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

AzureWebJobsSecretStorageKeyVaultName

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

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

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

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

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

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

AzureWebJobsSecretStorageKeyVaultTenantId

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

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

AzureWebJobsSecretStorageKeyVaultUri

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

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

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

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

Important

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

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

AzureWebJobsSecretStorageSas

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

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

AzureWebJobsSecretStorageType

تحديد المستودع أو الموفر لاستخدامه في storage المفاتيح. يتم always encrypted المفاتيح قبل تخزينها باستخدام سر فريد لتطبيق الوظائف.

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

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

AzureWebJobsStorage

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

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

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

AzureWebJobsStorage__accountName

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

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

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

AzureWebJobsStorage__blobServiceUri

عند استخدام اتصال storage المستند إلى الهوية، يعين URI لمستوى البيانات لخدمة الكائن الثنائي كبير الحجم لحساب storage.

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

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

AzureWebJobsStorage__clientId

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

AzureWebJobsStorage__credential

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

AzureWebJobsStorage__managedIdentityResourceId

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

AzureWebJobsStorage__queueServiceUri

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

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

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

AzureWebJobsStorage__tableServiceUri

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

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

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

AzureWebJobs_TypeScriptPath

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

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

DOCKER_REGISTRY_SERVER_PASSWORD

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

DOCKER_REGISTRY_SERVER_URL

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

DOCKER_REGISTRY_SERVER_USERNAME

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

DOCKER_SHM_SIZE

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

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

يشير إلى ما إذا كان يمكنك تحرير تطبيق الوظائف في Azure portal. القيم الصالحة هي readwritereadonly.

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

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

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. راجع Updating لاستهداف .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، يمكن لتطبيق وظيفة معين دعم لغة واحدة فقط.

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 لتعيين حجم الذاكرة المشتركة. لمعرفة المزيد، راجع الذاكرة Shared.

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

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

JAVA_ENABLE_SDK_TYPES

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

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 عند التشغيل على خطة Consumption. يؤدي هذا الإعداد إلى زيادة أوقات البدء الباردة لوظائف Java التي تعمل في خطة الاستهلاك. بالنسبة لخطة Premium أو Dedicated، استخدم JAVA_OPTSبدلا من ذلك . لمزيد من المعلومات، راجع تخصيص JVM.

MDMaxBackgroundUpgradePeriod

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

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

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 (https://pypi.org/simple) عند تشغيل بنية بعيدة. لأن هذا الإعداد يستبدل مؤشر الحزمة، قد ترى سلوكا غير متوقع عند الاستعادة. استخدم هذا الإعداد فقط عندما تحتاج إلى استخدام مجموعة كاملة من التبعيات المخصصة. عندما يكون ذلك ممكنا، يجب عليك بدلا من ذلك استخدام PIP_EXTRA_URL، الذي يسمح لك بالرجوع إلى فهرس حزمة إضافي. لمزيد من المعلومات، راجع تبعيات مخصصة في مقالة إنشاء Python.

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

يمكن أن تكون هذه التبعيات المخصصة في مستودع فهرس حزمة متوافق مع PEP 503 (واجهة برمجة تطبيقات المستودع البسيطة) أو في دليل محلي يتبع نفس التنسيق. لمزيد من المعلومات، راجع pip الوثائق الخاصة ب --index-url.

PIP_EXTRA_INDEX_URL

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

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

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

PROJECT

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

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

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY

يشير إلى ما إذا كان يجب على عملية عامل Python إخراج بيانات تتبع الاستخدام بتنسيق Open Telemetry إلى نقطة نهاية Application Insights. يؤدي تعيين هذه العلامة إلى True إلى إعلام مضيف الوظائف بالسماح لعملية عامل Python بتصدير بيانات القياس المفتوح إلى نقطة نهاية 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. فهو يمكن تطبيق الوظائف من access الميزات الجديدة التي توفرها حزم الشركاء. كما يمكنه تغيير سلوك تحميل الوظيفة والاستدعاء في تطبيقك. تأكد من أن الملحق الذي تختاره جدير بالثقة حيث تتحمل خطر استخدامه. لا يقدم 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>	الوجهة التي يتم إرسال السجلات إليها. القيم الصالحة هي AppInsightsBlob. عند استخدام AppInsights، تأكد من تمكين Application Insights في تطبيق وظيفتك. عند تعيين الوجهة إلى Blob، يتم إنشاء السجلات في حاوية كائن ثنائي كبير الحجم تسمى azure-functions-scale-controller في حساب storage الافتراضي المعين في إعداد التطبيق AzureWebJobsStorage.
<VERBOSITY>	يحدد مستوى التسجيل. القيم المعتمدة هي None و Warning و Verbose. عند ضبطه على Verbose، يسجل مراقب المقياس سببًا لكل تغيير في عدد العمال، ومعلومات حول المحفزات التي تدخل في تلك القرارات. تتضمن السجلات المطولة تحذيرات التشغيل والتجزئة المستخدمة بواسطة المشغلات قبل وبعد تشغيل وحدة التحكم في الميزان.

Tip

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

SCM_DO_BUILD_DURING_DEPLOYMENT

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

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

SCM_LOGSTREAM_TIMEOUT

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

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

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

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Connection string لحساب storage حيث يتم تخزين التعليمات البرمجية والتكوين لتطبيق الوظائف في خطط التحجيم المستندة إلى الحدث. لمزيد من المعلومات، راجع إعداد اتصال حساب Storage.

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

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

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

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

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

يمكنك استخدام مرجع KeyVault لإعداد الاتصال هذا. ومع ذلك، يلزم تكوين إضافي لإنشاء تطبيق دالة وتوسيع نطاقه ديناميكيا في خطة Premium أو Consumption عند الاحتفاظ storage connection string في KeyVault. لمزيد من المعلومات، راجع Considerations للتركيب Azure Files.

WEBSITE_CONTENTOVERVNET

Important

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

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

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

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

Note

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

WEBSITE_CONTENTSHARE

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

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

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

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

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

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

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

WEBSITE_DNS_SERVER

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

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

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

Important

هذا الإعداد قيد المعاينة. توجد الآن خاصية app لدالة max scale out الآن. نوصي بهذه الخاصية للحد من التوسع.

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

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

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 إلى موقع ملف الحزمة في موقع storage يمكن الوصول إليه، مثل حاوية Azure Blob Storage. يجب أن تكون الحاوية خاصة لمنع access غير المصرح به، ما يتطلب منك استخدام توقيع access مشترك (SAS) في عنوان URL أو مصادقة Microsoft Entra ID للسماح access. يوصى باستخدام Microsoft Entra ID مع الهويات المدارة.

هذا مثال على إعداد WEBSITE_RUN_FROM_PACKAGE إلى عنوان URL لحزمة نشر في حاوية Storage مدونة 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 ID. يتطلب هذا الإعداد تعيين WEBSITE_RUN_FROM_PACKAGE ذلك إلى عنوان URL لحزمة النشر في حاوية خاصة.

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

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

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

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

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

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
ويندوز	All	قم بتعيين القيمة إلى اسم المنطقة الزمنية المطلوبة كما هو محدد في السطر الثاني من كل زوج تم تعيينه بواسطة الأمر Windows tzutil.exe /L
ينكس	Premium Dedicated	قم بتعيين القيمة إلى اسم المنطقة الزمنية المطلوبة كما هو موضح في قاعدة بيانات tz

Note

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

على سبيل المثال، يستخدم التوقيت الشرقي في الولايات المتحدة (ممثلا 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

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

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

WEBSITE_VNET_ROUTE_ALL

Important

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

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

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

WEBSITES_ENABLE_APP_SERVICE_STORAGE

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

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

يجب الاحتفاظ ببعض التكوينات على مستوى App Service كإعدادات الموقع، مثل إصدارات اللغة. تتم إدارة هذه الإعدادات في Azure portal أو باستخدام واجهات برمجة تطبيقات 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

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

functionsRuntimeAdminIsolationEnabled

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

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

linuxFxVersion

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

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

قيم linuxFxVersion صالحة

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

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 Functions خاصة باللغة. راجع الصورة الأساسية Azure Functions repos.

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

netFrameworkVersion

تعيين الإصدار المحدد من .NET لوظائف C#. لمزيد من المعلومات، راجع Update your function app in Azure.

powerShellVersion

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

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

vnetContentShareEnabled

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

Note

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

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

vnetImagePullEnabled

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

vnetRouteAllEnabled

يشير إلى ما إذا كان يتم توجيه جميع نسبة استخدام الشبكة الصادرة من التطبيق عبر virtual network. تشير قيمة الإعداد true إلى توجيه جميع حركة مرور التطبيق عبر virtual network. استخدم هذا الإعداد عند تكوين تكامل virtual network Regional في خطط Elastic Premium و Dedicated. يتم استخدامه أيضا عند استخدام بوابة NAT virtual network لتعريف عنوان 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 من virtual network المتكاملة في 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.dnsConfiguration.dnsServers'	يتم توريث DNS من virtual network المتكاملة في خطة استهلاك Flex.
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	غير صالح

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

• تعرف على كيفية تحديث إعدادات التطبيق
• راجع إعدادات التكوين في ملف host.json
• انظر إلى إعدادات التطبيق الأخرى لتطبيقات App Service