مرجع إعدادات التطبيق لـ 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.
مفتاح | عينة القيمة |
---|---|
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
، تعتمد القيمة المحددة التي قمت بتعيينها على نوع الهوية المدارة:
الهوية المُدارة | إعداد القيمة |
---|---|
المعين من نظام | Authorization=AAD |
المستخدم المعين | Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID> |
يتم تطبيق متطلبات المصادقة هذه على الاتصالات من مضيف الوظائف ومصحح أخطاء اللقطة وملف التعريف وأي عوامل خاصة باللغة. لاستخدام هذا الإعداد، يجب أن تكون الهوية المدارة متاحة بالفعل لتطبيق الوظائف، مع دور معين مكافئ ل Monitoring Metrics Publisher.
إشعار
عند استخدام 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 الخاص بك في سحابة ذات سيادة، ما يتطلب نقطة نهاية مخصصة
لمزيد من المعلومات، راجع سلاسل الاتصال.
مفتاح | عينة القيمة |
---|---|
APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
للاتصال ب Application Insights باستخدام مصادقة Microsoft Entra، يجب عليك استخدام APPLICATIONINSIGHTS_AUTHENTICATION_STRING
.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL
هام
وكلاء Azure Functions هي ميزة قديمة للإصدارات من 1.x إلى 3.x من وقت تشغيل Azure Functions. لمزيد من المعلومات حول الدعم القديم في الإصدار 4.x، راجع وكلاء الوظائف.
بشكل افتراضي، يستخدم Functions proxies اختصارًا لإرسال استدعاءات API من الوكلاء مباشرة إلى وظائف في نفس تطبيق الوظائف. يتم استخدام هذا الاختصار بدلًا من إنشاء طلب HTTP جديد. يسمح لك هذا الإعداد بتعطيل سلوك الاختصار هذا.
مفتاح | قيمة | الوصف |
---|---|---|
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | true |
لن يتم إرسال الاستدعاءات التي تتضمن عنوان URL الخلفي الذي يشير إلى وظيفة في تطبيق الوظائف المحلي مباشرة إلى الوظيفة. بدلًا من ذلك، يتم توجيه الطلبات مرة أخرى إلى الواجهة الأمامية HTTP لتطبيق الوظائف. |
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | false |
يتم إعادة توجيه الاستدعاءات التي تتضمن عنوان URL الخلفي الذي يشير إلى وظيفة في تطبيق الوظائف المحلي مباشرة إلى الوظيفة. false هي القيمة الافتراضية. |
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
هام
وكلاء Azure Functions هي ميزة قديمة للإصدارات من 1.x إلى 3.x من وقت تشغيل Azure Functions. لمزيد من المعلومات حول الدعم القديم في الإصدار 4.x، راجع وكلاء الوظائف.
يتحكم هذا الإعداد في ما إذا كان يتم فك ترميز الأحرف %2F
كشرط مائل في معلمات المسار عند إدراجها في عنوان URL الخلفي.
مفتاح | قيمة | الوصف |
---|---|---|
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | true |
يتم فك ترميز معلمات التوجيه بشرطة مائلة تم ترميزها. |
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | false |
يتم تمرير كافة معلمات المسار دون تغيير، وهو السلوك الافتراضي. |
على سبيل المثال، ضع في اعتبارك الملف proxies.js لتطبيق الوظائف في myfunction.com
المجال.
{
"$schema": "http://json.schemastore.org/proxies",
"proxies": {
"root": {
"matchCondition": {
"route": "/{*all}"
},
"backendUri": "example.com/{all}"
}
}
}
عندما AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
يتم تعيين true
، يحل URL example.com/api%2ftest
إلى example.com/api/test
. بشكل افتراضي، يبقى URL دون تغيير كـ example.com/test%2fapi
. لمزيد من المعلومات، راجع Functions proxies.
AZURE_FUNCTIONS_ENVIRONMENT
تكوين بيئة استضافة وقت التشغيل لتطبيق الوظائف عند التشغيل في Azure. تتم قراءة هذه القيمة أثناء التهيئة، ويتم احترام هذه القيم فقط بواسطة وقت التشغيل:
استخدم هذا الإعداد بدلا من ASPNETCORE_ENVIRONMENT
عندما تحتاج إلى تغيير بيئة وقت التشغيل في Azure إلى شيء آخر غير Production
. لمزيد من المعلومات، راجع فئة بدء التشغيل المستندة إلى البيئة والأساليب.
هذا الإعداد غير متوفر في الإصدار 1.x من وقت تشغيل الوظائف.
AzureFunctionsJobHost__*
في الإصدار 2.x والإصدارات الأحدث من Functions runtime، يمكن أن تتجاوز إعدادات التطبيق إعدادات host.json في البيئة الحالية. يتم التعبير عن هذه التجاوزات كإعدادات التطبيق المسماة AzureFunctionsJobHost__path__to__setting
. لمزيد من المعلومات، يُرجى الرجوع إلى تجاوز قيم host.json.
AzureFunctionsWebHost__hostid
يضبط معرف المضيف لتطبيق وظيفة معين، والذي يجب أن يكون معرفاً فريداً. يتجاوز هذا الإعداد قيمة معرف المضيف التي تم إنشاؤها تلقائياً لتطبيقك. استخدم هذا الإعداد فقط عندما تحتاج إلى منع تضارب معرف المضيف بين تطبيقات الوظائف التي تشترك في نفس حساب التخزين.
يجب أن يفي معرف المضيف بالمتطلبات التالية:
- يتراوح بين 1 و32 حرفا
- تحتوي على أحرف صغيرة وأرقام والشرطات فقط
- لا تبدأ أو تنتهي بشرطة
- لا تحتوي على شرط متتالية
من الطرق السهلة لإنشاء معرّف استخدام GUID وإزالة الشرطات وجعله صغيراً، مثل تحويل GUID 1835D7B5-5C98-4790-815D-072CC94C6F71
إلى القيمة 1835d7b55c984790815d072cc94c6f71
.
مفتاح | عينة القيمة |
---|---|
AzureFunctionsWebHost__hostid | myuniquefunctionappname123456789 |
لمزيد من المعلومات، راجع اعتبارات معرّف المضيف.
AzureWebJobsDashboard
يتم إهمال هذا الإعداد ويتم دعمه فقط عند التشغيل على الإصدار 1.x من وقت تشغيل Azure Functions.
سلسلة اتصال حساب تخزين اختياري لتخزين السجلات وعرضها في علامة التبويب مراقبة في المدخل. يجب أن يكون حساب التخزين حسابًا للأغراض العامة يدعم الكائنات الثنائية كبيرة الحجم وقوائم الانتظار والجداول. لمعرفة المزيد، راجع متطلبات حساب التخزين.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=... |
AzureWebJobsDisableHomepage
تقوم قيمة true
بتعطيل الصفحة المقصودة الافتراضية التي يتم عرضها لعنون URL الجذر لتطبيق الوظائف. القيمة الافتراضية هي false
.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsDisableHomepage | true |
عند حذف إعداد التطبيق هذا أو تعيينه إلى false
، يتم عرض صفحة مشابهة للمثال التالي كاستجابة لعنوان URL <functionappname>.azurewebsites.net
.
AzureWebJobsDotNetReleaseCompilation
true
يعني استخدام Release
الوضع عند التحويل البرمجي للتعليمات البرمجية .NET؛ false
يعني استخدام وضع تتبع الأخطاء. القيمة الافتراضية هي true
.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsDotNetReleaseCompilation | true |
AzureWebJobsFeatureFlags
قائمة بميزات بيتا مفصولة بفواصل لتمكينها. ميزات بيتا التي تم تمكينها بواسطة هذه العلامات ليست جاهزة للإنتاج، ولكن يمكن تمكينها للاستخدام التجريبي قبل أن تنتقل مباشرة.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsFeatureFlags | feature1,feature2,EnableProxies |
أضف EnableProxies
إلى هذه القائمة لإعادة تمكين الوكلاء على الإصدار 4.x من وقت تشغيل الوظائف أثناء التخطيط للترحيل إلى Azure API Management. لمزيد من المعلومات، راجع إعادة تمكين الوكلاء في Functions v4.x.
AzureWebJobsKubernetesSecretName
يشير إلى مورد Kubernetes Secrets المستخدم لتخزين المفاتيح. مدعوم فقط عند التشغيل في Kubernetes. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى kubernetes
. عندما AzureWebJobsKubernetesSecretName
لا يتم تعيين، يعتبر المستودع للقراءة فقط. في هذه الحالة، يجب إنشاء القيم قبل النشر. تُنشئ أدوات Azure Functions الأساسية القيم تلقائياً عند التوزيع إلى Kubernetes.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsKubernetesSecretName | <SECRETS_RESOURCE> |
لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
AzureWebJobsSecretStorageKeyVaultClientId
معرّف العميل للهوية المُدارة التي عيّنها المستخدم أو تسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى keyvault
. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageKeyVaultClientId | <CLIENT_ID> |
لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
AzureWebJobsSecretStorageKeyVaultClientSecret
سر معرّف العميل للهوية المُدارة التي عيّنها المستخدم أو تسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى keyvault
. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageKeyVaultClientSecret | <CLIENT_SECRET> |
لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
AzureWebJobsSecretStorageKeyVaultName
تم إهمال هذا الإعداد وتم استخدامه فقط عند التشغيل على الإصدار 3.x من وقت تشغيل Azure Functions.
اسم مثيل مخزن المفاتيح المستخدم لتخزين المفاتيح. تم استخدام هذا الإعداد فقط في الإصدار 3.x من وقت تشغيل الوظائف، والذي لم يعد مدعوما. بالنسبة للإصدار 4.x، استخدم بدلاً من ذلك AzureWebJobsSecretStorageKeyVaultUri
. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى keyvault
.
يجب أن يكون للمخزن نهج وصول يتوافق مع الهوية المُدارة التي يعينها النظام لمورد الاستضافة. يجب أن يمنح نهج الوصول الهوية الأذونات السرية التالية: Get
وSet
وList
وDelete
.
عند تشغيل الوظائف محليا، يتم استخدام هوية المطور، ويجب أن تكون الإعدادات في ملف local.settings.json.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageKeyVaultName | <VAULT_NAME> |
لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
AzureWebJobsSecretStorageKeyVaultTenantId
معرف المستأجر الخاص بتسجيل التطبيق المستخدم للوصول إلى المخزن حيث يتم تخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى keyvault
. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف. لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageKeyVaultTenantId | <TENANT_ID> |
AzureWebJobsSecretStorageKeyVaultUri
عنوان URL لمثال مخزن المفاتيح المستخدم لتخزين المفاتيح. مدعوم في الإصدار 4.x والإصدارات الأحدث من وقت تشغيل الوظائف. هذا هو الإعداد الموصى به لاستخدام مثيل مخزن المفاتيح لتخزين المفاتيح. يتطلب هذا الإعداد تعيين AzureWebJobsSecretStorageType
إلى keyvault
.
يجب أن تكون القيمة AzureWebJobsSecretStorageKeyVaultUri
هي القيمة الكاملة لـ Vault URI المعروضة في علامة التبويب Key Vault overview، بما في ذلك https://
.
يجب أن يكون للمخزن نهج وصول يتوافق مع الهوية المُدارة التي يعينها النظام لمورد الاستضافة. يجب أن يمنح نهج الوصول الهوية الأذونات السرية التالية: Get
وSet
وList
وDelete
.
عند تشغيل الوظائف محليا، يتم استخدام هوية المطور، ويجب أن تكون الإعدادات في ملف local.settings.json.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageKeyVaultUri | https://<VAULT_NAME>.vault.azure.net |
لمعرفة المزيد، راجع استخدام مراجع Key Vault لـ Azure Functions.
AzureWebJobsSecretStorageSas
عنوان URL الخاص بـ Blob Storage SAS لحساب التخزين الثاني المستخدم لتخزين المفاتيح. بشكل افتراضي، تستخدم الوظائف الحساب المعين في AzureWebJobsStorage
. عند استخدام خيار التخزين السري هذا، تأكد من أن AzureWebJobsSecretStorageType
لم يتم تعيينه صراحةً أو أنه مضبوط على blob
. لمعرفة المزيد، راجع إدارة تخزين المفاتيح.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsSecretStorageSas | <BLOB_SAS_URL> |
AzureWebJobsSecretStorageType
تحديد المستودع أو الموفر لاستخدامه لتخزين المفتاح. يتم دائماً تشفير المفاتيح قبل تخزينها باستخدام سر فريد لتطبيق وظيفتك.
مفتاح | قيمة | الوصف |
---|---|---|
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 إدارة المفاتيح وإدارة مشغل المؤقت ونقاط التحقق لمراكز الأحداث. يجب أن يكون حساب التخزين حسابًا للأغراض العامة يدعم الكائنات الثنائية كبيرة الحجم وقوائم الانتظار والجداول. لمزيد من المعلومات، راجع متطلبات حساب التخزين.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=... |
بدلا من سلسلة الاتصال، يمكنك استخدام اتصال يستند إلى الهوية لحساب التخزين هذا. لمزيد من المعلومات، راجع الاتصال بالتخزين المضيف بهوية.
AzureWebJobsStorage__accountName
عند استخدام اتصال تخزين يستند إلى الهوية، يعين اسم حساب حساب التخزين بدلا من استخدام سلسلة الاتصال في AzureWebJobsStorage
. يعد بناء الجملة هذا فريدا من AzureWebJobsStorage
نوعه ولا يمكن استخدامه للاتصالات الأخرى المستندة إلى الهوية.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsStorage__accountName | <STORAGE_ACCOUNT_NAME> |
بالنسبة للسحب السيادية أو عند استخدام DNS مخصص، يجب عليك بدلا من ذلك استخدام الإعدادات الخاصة AzureWebJobsStorage__*ServiceUri
بالخدمة.
AzureWebJobsStorage__blobServiceUri
عند استخدام اتصال تخزين يستند إلى الهوية، يعين URI لمستوى البيانات لخدمة blob لحساب التخزين.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsStorage__blobServiceUri | https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net |
استخدم هذا الإعداد بدلا من AzureWebJobsStorage__accountName
السحب السيادية أو عند استخدام DNS مخصص. لمزيد من المعلومات، راجع الاتصال بالتخزين المضيف بهوية.
AzureWebJobsStorage__queueServiceUri
عند استخدام اتصال تخزين يستند إلى الهوية، يعين URI لمستوى البيانات لخدمة قائمة الانتظار لحساب التخزين.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsStorage__queueServiceUri | https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net |
استخدم هذا الإعداد بدلا من AzureWebJobsStorage__accountName
السحب السيادية أو عند استخدام DNS مخصص. لمزيد من المعلومات، راجع الاتصال بالتخزين المضيف بهوية.
AzureWebJobsStorage__tableServiceUri
عند استخدام اتصال تخزين يستند إلى الهوية، يقوم بتعيين URI لمستوى البيانات لخدمة جدول لحساب التخزين.
مفتاح | عينة القيمة |
---|---|
AzureWebJobsStorage__tableServiceUri | https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net |
استخدم هذا الإعداد بدلا من AzureWebJobsStorage__accountName
السحب السيادية أو عند استخدام DNS مخصص. لمزيد من المعلومات، راجع الاتصال بالتخزين المضيف بهوية.
AzureWebJobs_TypeScriptPath
المسار إلى المحول البرمجي المستخدم لـ TypeScript. يسمح لك بتجاوز الإعداد الافتراضي إذا كنت بحاجة إلى ذلك.
مفتاح | عينة القيمة |
---|---|
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 الذاكرة المشتركة. لمعرفة المزيد، راجع الذاكرة المشتركة.
مفتاح | عينة القيمة |
---|---|
DOCKER_SHM_SIZE | 268435456 |
تعيّن القيمة أعلاه حجم ذاكرة مشتركة يبلغ 256 ميغابايت تقريباً.
يتطلب تعيين FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
على 1
.
ENABLE_ORYX_BUILD
يشير إلى ما إذا كان يتم استخدام نظام إنشاء Oryx أثناء النشر. ENABLE_ORYX_BUILD
يجب تعيين إلى true
عند القيام بنشرات البناء عن بعد إلى Linux. لمزيد من المعلومات، راجع Remote build.
مفتاح | عينة القيمة |
---|---|
ENABLE_ORYX_BUILD | true |
FUNCTION_APP_EDIT_MODE
يشير إلى ما إذا كنت قادرا على تحرير تطبيق الوظائف في مدخل Microsoft Azure. القيم الصالحة هي readwrite
و readonly
.
مفتاح | عينة القيمة |
---|---|
FUNCTION_APP_EDIT_MODE | readonly |
يتم تعيين القيمة حسب وقت التشغيل استنادا إلى مكدس اللغة وحالة التوزيع لتطبيق الوظائف. لمزيد من المعلومات، راجع قيود التطوير في مدخل Microsoft Azure.
FUNCTIONS_EXTENSION_VERSION
إصدار Functions runtime الذي يستضيف تطبيق الوظائف. tilde (~
) مع الإصدار الرئيسي يعني استخدام أحدث إصدار من هذا الإصدار الرئيسي (على سبيل المثال، ~4
). عند توفر إصدارات ثانوية جديدة من نفس الإصدار الرئيسي، يتم تثبيتها تلقائيا في تطبيق الوظائف.
مفتاح | عينة القيمة |
---|---|
FUNCTIONS_EXTENSION_VERSION | ~4 |
قيم إصدار وقت التشغيل الرئيسية التالية مدعومة:
القيمة | هدف وقت التشغيل | تعليق |
---|---|---|
~4 |
4.x | مستحسن |
~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 للحصول على إرشادات كاملة، بما في ذلك قيم التكوين المطلوبة الأخرى.
مفتاح | عينة القيمة |
---|---|
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 للنموذج أو بعده:
- إذا تم طرح الخطأ من قبل (على سبيل المثال إذا كنت تستخدم الطراز v3 أو لم يكن ملف نقطة الإدخال موجودا)، يتطابق السلوك الافتراضي مع
false
. - إذا تم طرح الخطأ بعد (على سبيل المثال، إذا حاولت تسجيل وظائف v4 للنموذج المكرر)، يتطابق السلوك الافتراضي مع
true
.
مفتاح | قيمة | الوصف |
---|---|---|
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 بايت.
مفتاح | عينة القيمة |
---|---|
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT | 250000000 |
FUNCTIONS_V2_COMPATIBILITY_MODE
هام
لم يعد هذا الإعداد مدعوما. تم توفيره في الأصل لتمكين حل بديل قصير الأجل للتطبيقات التي تستهدف وقت تشغيل 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
).
مفتاح | عينة القيمة |
---|---|
FUNCTIONS_WORKER_PROCESS_COUNT | 2 |
FUNCTIONS_WORKER_RUNTIME
اللغة أو مكدس اللغة لوقت تشغيل العامل لتحميله في تطبيق الوظائف. وهذا يتوافق مع اللغة المستخدمة في التطبيق الخاص بك (على سبيل المثال، python
). بدءًا من الإصدار 2.x من Azure Functions runtime، يمكن لتطبيق وظائف معين دعم لغة واحدة فقط.
مفتاح | عينة القيمة |
---|---|
FUNCTIONS_WORKER_RUNTIME | node |
القيم الصالحة:
القيمة | مكدس اللغة/اللغة |
---|---|
dotnet |
C# (مكتبة الفئات) C# (البرنامج النصي) |
dotnet-isolated |
C# (عملية عامل معزولة) |
java |
Java |
node |
JavaScript TypeScript |
powershell |
بوويرشيل |
python |
Python |
custom |
آخر |
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
يتيح هذا الإعداد لعامل Python استخدام الذاكرة المشتركة لتحسين المعدل نقل. قم بتمكين الذاكرة المشتركة عندما يصل تطبيق وظيفة Python إلى ازدحام في الذاكرة.
مفتاح | عينة القيمة |
---|---|
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED | 1 |
مع تمكين هذا الإعداد، يمكنك استخدام إعداد DOCKER_SHM_SIZE لتعيين حجم الذاكرة المشتركة. لمعرفة المزيد، راجع الذاكرة المشتركة.
JAVA_OPTS
يستخدم لتخصيص جهاز Java الظاهري (JVM) المستخدم لتشغيل وظائف Java عند التشغيل على خطة Premium أو خطة مخصصة. عند التشغيل على خطة Consumption، استخدم languageWorkers__java__arguments
بدلا من ذلك . لمزيد من المعلومات، راجع تخصيص JVM.
languageWorkers__java__arguments
يستخدم لتخصيص جهاز Java الظاهري (JVM) المستخدم لتشغيل وظائف Java عند التشغيل على خطة Consumption. يزيد هذا الإعداد من أوقات البدء الباردة لوظائف Java التي تعمل في خطة Consumption. بالنسبة لخطة Premium أو Dedicated، استخدم JAVA_OPTS
بدلا من ذلك . لمزيد من المعلومات، راجع تخصيص JVM.
MDMaxBackgroundUpgradePeriod
يتحكم في فترة تحديث خلفية التبعيات المُدارة لتطبيقات وظائف PowerShell، بقيمة افتراضية 7.00:00:00
(أسبوعيًا).
تبدأ كل عملية عامل في PowerShell في التحقق من ترقيات الوحدة في معرض PowerShell عند بدء العملية MDMaxBackgroundUpgradePeriod
وبعد ذلك. عندما يتوفر إصدار وحدة جديد في معرض PowerShell، يتم تثبيته على نظام الملفات وإتاحته لعمال PowerShell. يتيح تقليل هذه القيمة لتطبيق وظيفتك الحصول على إصدارات أحدث من الوحدة في وقت أقرب، ولكنه يزيد أيضًا من استخدام موارد التطبيق (إدخال/إخراج الشبكة وCPU والتخزين). تؤدي زيادة هذه القيمة إلى تقليل استخدام موارد التطبيق، ولكن يمكن أن تؤخر أيضا تقديم إصدارات وحدة نمطية جديدة إلى تطبيقك.
مفتاح | عينة القيمة |
---|---|
MDMaxBackgroundUpgradePeriod | 7.00:00:00 |
لمزيد من المعلومات، راجع إدارة التبعيات.
MDNewSnapshotCheckPeriod
تحديد عدد المرات التي يتحقق فيها كل عامل PowerShell من تثبيت ترقيات التبعيات المدارة. التردد الافتراضي هو 01:00:00
(بالساعة).
بعد تثبيت إصدارات الوحدة الجديدة على نظام الملفات، يجب إعادة تشغيل كل عملية عامل PowerShell. تؤثر إعادة تشغيل العمال في PowerShell على توفر التطبيق حيث يمكنها مقاطعة تنفيذ الوظيفة الحالي. حتى تتم إعادة تشغيل جميع عمليات عامل PowerShell، يمكن استدعاءات الوظائف استخدام إصدارات الوحدة النمطية القديمة أو الجديدة. تكتمل إعادة تشغيل جميع عمال PowerShell في MDNewSnapshotCheckPeriod
.
في كل MDNewSnapshotCheckPeriod
، يتحقق عامل PowerShell ما إذا كان قد تم تثبيت ترقيات التبعية المدارة أم لا. عند تثبيت الترقيات، يتم بدء إعادة التشغيل. زيادة هذه القيمة يقلل من تكرار الانقطاعات بسبب عمليات إعادة تشغيل. ومع ذلك، قد تزيد الزيادة أيضا من الوقت الذي يمكن خلاله استدعاءات الدالة استخدام إصدارات الوحدة النمطية القديمة أو الجديدة، بشكل غير محدد.
مفتاح | عينة القيمة |
---|---|
MDNewSnapshotCheckPeriod | 01:00:00 |
لمزيد من المعلومات، راجع إدارة التبعيات.
MDMinBackgroundUpgradePeriod
الفترة الزمنية بعد إجراء فحص سابق لترقية التبعية المُدارة قبل بدء فحص ترقية آخر، مع الإعداد الافتراضي 1.00:00:00
(يومياً).
لتجنب ترقيات الوحدة المفرطة عند إعادة تشغيل العامل بشكل متكرر، لا يتم إجراء التحقق من ترقيات الوحدة عندما يكون أي عامل قد بدأ بالفعل هذا التحقق في MDMinBackgroundUpgradePeriod
الأخير.
مفتاح | عينة القيمة |
---|---|
MDMinBackgroundUpgradePeriod | 1.00:00:00 |
لمزيد من المعلومات، راجع إدارة التبعيات.
PIP_INDEX_URL
يتيح لك هذا الإعداد تجاوز عنوان URL الأساسي لـ Python Package Index، والذي يكون https://pypi.org/simple
بشكل افتراضي. استخدم هذا الإعداد عندما تحتاج إلى تشغيل بنية بعيدة باستخدام تبعيات مخصصة. يمكن أن تكون هذه التبعيات المخصصة في مستودع فهرس حزمة متوافق مع PEP 503 (واجهة برمجة تطبيقات المستودع البسيطة) أو في دليل محلي يتبع نفس التنسيق.
مفتاح | عينة القيمة |
---|---|
PIP_INDEX_URL | http://my.custom.package.repo/simple |
لمعرفة المزيد، راجع pip
وثائق--index-url
واستخدام التبعية المخصصة في مرجع مطور Python.
PIP_EXTRA_INDEX_URL
تشير قيمة هذا الإعداد إلى عنوان URL إضافي للفهرس للحزم المخصصة لتطبيقات Python، لاستخدامها بالإضافة إلى --index-url
. استخدم هذا الإعداد عندما تحتاج إلى تشغيل البناء عن بعد باستخدام تبعيات مخصصة موجودة في فهرس حزمة إضافية. يجب أن تتبع نفس القواعد مثل --index-url
.
مفتاح | عينة القيمة |
---|---|
PIP_EXTRA_INDEX_URL | http://my.custom.package.repo/simple |
لمعرفة المزيد، راجع pip
وثائق--extra-index-url
واستخدام التبعية المخصصة في مرجع مطور Python.
مشروع
إعداد نشر مستمر يخبر خدمة توزيع Kudu بالمجلد في مستودع متصل لتحديد موقع المشروع القابل للتوزيع.
مفتاح | عينة القيمة |
---|---|
مشروع | WebProject/WebProject.csproj |
PYTHON_ISOLATE_WORKER_DEPENDENCIES
التكوين خاص بتطبيقات وظائف Python. وهو يحدد أولوية ترتيب تحميل الوحدة. تُعيّن هذه القيمة افتراضيًا إلى 0
.
مفتاح | قيمة | الوصف |
---|---|---|
PYTHON_ISOLATE_WORKER_DEPENDENCIES | 0 |
تحديد أولويات تحميل مكتبات Python من تبعيات عامل Python الداخلية، وهو السلوك الافتراضي. قد يتم تظليل مكتبات الجهات الخارجية المعرفة في 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_WORKER_EXTENSIONS
التكوين خاص بتطبيقات وظائف Python. يسمح تعيين هذا 1
للعامل بالتحميل في ملحقات عامل Python المُعرفة في requirements.txt. فهو يمكن تطبيق الوظائف الخاص بك من الوصول إلى الميزات الجديدة التي توفرها حزم الجهات الخارجية. كما يمكنه تغيير سلوك تحميل الوظيفة والاستدعاء في تطبيقك. تأكد من أن الملحق الذي تختاره جدير بالثقة حيث تتحمل خطر استخدامه. لا تقدم Azure Functions أي ضمانات صريحة لأي ملحقات. لمعرفة كيفية استخدام ملحق، تفضل بزيارة الصفحة اليدوية للملحق أو مستند readme. بشكل افتراضي، يتم تعيين هذه القيمة إلى 0
.
مفتاح | قيمة | الوصف |
---|---|---|
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.
مفتاح | عينة القيمة | أقصى قيمة |
---|---|---|
PYTHON_THREADPOOL_THREAD_COUNT | 2 | 32 |
SCALE_CONTROLLER_LOGGING_ENABLED
هذا الإعداد قيد المعاينة حاليًا.
يتحكم هذا الإعداد في تسجيل الدخول من وحدة تحكم في مقياس Azure Functions. لمزيد من المعلومات، راجع سجلات وحدة التحكم في المقياس.
مفتاح | عينة القيمة |
---|---|
SCALE_CONTROLLER_LOGGING_ENABLED | AppInsights:Verbose |
يتم توفير قيمة هذا المفتاح بالتنسيق <DESTINATION>:<VERBOSITY>
، والذي يتم تعريفه كما يلي:
الخاصية | الوصف |
---|---|
<DESTINATION> |
الوجهة التي يتم إرسال السجلات إليها. القيم الصالحة هي AppInsights و Blob .عند استخدام AppInsights ، تأكد من تمكين Application Insights في تطبيق وظيفتك.عند تعيين الوجهة على Blob ، يتم إنشاء السجلات في حاوية تخزين البيانات الثنائية الكبيرة المسماة azure-functions-scale-controller في حساب التخزين الافتراضي الذي تم تعيينه في إعداد التطبيق AzureWebJobsStorage . |
<VERBOSITY> |
يحدد مستوى التسجيل. القيم المعتمدة هي None و Warning و Verbose .عند ضبطه على Verbose ، يسجل مراقب المقياس سببًا لكل تغيير في عدد العمال، ومعلومات حول المحفزات التي تدخل في تلك القرارات. تتضمن السجلات المطولة تحذيرات التشغيل والتجزئة المستخدمة بواسطة المشغلات قبل وبعد تشغيل وحدة التحكم في الميزان. |
تلميح
ضع في اعتبارك أنه أثناء ترك تسجيل وحدة التحكم في الميزان ممكّناً، فإنه يؤثر على التكاليف المحتملة لمراقبة تطبيق وظيفتك. ضع في اعتبارك تمكين التسجيل حتى تقوم بجمع بيانات كافية لفهم كيفية تصرف وحدة تحكم المقياس، ثم تعطيلها.
SCM_DO_BUILD_DURING_DEPLOYMENT
يتحكم في سلوك الإنشاء عن بعد أثناء النشر. عند SCM_DO_BUILD_DURING_DEPLOYMENT
تعيين إلى true
، يتم إنشاء المشروع عن بعد أثناء النشر.
مفتاح | عينة القيمة |
---|---|
SCM_DO_BUILD_DURING_DEPLOYMENT | true |
SCM_LOGSTREAM_TIMEOUT
يتحكم في المهلة، بالثواني، عند الاتصال بسجلات الدفق. القيمة الافتراضية هي 7200 (ساعتان).
مفتاح | عينة القيمة |
---|---|
SCM_LOGSTREAM_TIMEOUT | 1800 |
تحدد قيمة العينة أعلاه 1800
مهلة 30 دقيقة. لمزيد من المعلومات، راجع تمكين سجلات تنفيذ الدفق في Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
سلسلة الاتصال لحساب التخزين حيث يتم تخزين تعليمة برمجية تطبيق الوظيفة والتكوين في خطط تحجيم مدفوعة بالأحداث. لمزيد من المعلومات، راجع إعداد اتصال حساب التخزين.
مفتاح | عينة القيمة |
---|---|
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING | DefaultEndpointsProtocol=https;AccountName=... |
هذا الإعداد مطلوب لتطبيقات خطة Consumption و Elastic Premium التي تعمل على كل من Windows و Linux. إنه ليس مطلوباً لتطبيقات الخطط المخصصة، والتي لا يتم تحجيمها ديناميكياً بواسطة الوظائف.
قد يؤدي تغيير هذا الإعداد أو إزالته إلى عدم بدء تشغيل تطبيق الوظائف. لمعرفة المزيد، راجع مقالة استكشاف الأخطاء وإصلاحها هذه.
لا تدعم Azure Files استخدام الهوية المدارة عند الوصول إلى مشاركة الملف. لمزيد من المعلومات، راجع سيناريوهات المصادقة المدعومة من Azure Files.
WEBSITE_CONTENTOVERVNET
هام
WEBSITE_CONTENTOVERVNET هو إعداد تطبيق قديم تم استبداله بخاصية موقع vnetContentShareEnabled .
تمكن قيمة 1
تطبيق الوظائف من تغيير الحجم عندما يكون حساب التخزين الخاص بك مقيدًا بشبكة ظاهرية. يجب تمكين هذا الإعداد عند تقييد حساب التخزين الخاص بك إلى شبكة ظاهرية. مطلوب فقط عند استخدام WEBSITE_CONTENTSHARE
و WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. لمعرفة المزيد، راجع تقييد حساب التخزين الخاص بك بشبكة ظاهرية.
مفتاح | عينة القيمة |
---|---|
WEBSITE_CONTENTOVERVNET | 1 |
إعداد التطبيق هذا مطلوب على خطط Elastic Premium و Dedicated (App Service) (قياسية وأعلى). غير مدعوم عند التشغيل على خطة Consumption.
إشعار
يجب أن تهتم بشكل خاص عند التوجيه إلى مشاركة المحتوى في حساب تخزين مشترك بواسطة تطبيقات وظائف متعددة في نفس الخطة. لمزيد من المعلومات، راجع التوجيه المتناسق من خلال الشبكات الظاهرية في مقالة اعتبارات التخزين.
WEBSITE_CONTENTSHARE
اسم مشاركة الملف الذي تستخدمه Functions لتخزين التعليمات البرمجية لتطبيق الوظائف وملفات التكوين. هذا المحتوى مطلوب بواسطة خطط التحجيم المستندة إلى الحدث. يستخدم مع WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. الافتراضي هو سلسلة فريدة تم إنشاؤها بواسطة وقت التشغيل، والتي تبدأ باسم تطبيق الدالة. لمزيد من المعلومات، راجع إعداد اتصال حساب التخزين.
مفتاح | عينة القيمة |
---|---|
WEBSITE_CONTENTSHARE | functionapp091999e2 |
هذا الإعداد مطلوب لتطبيقات الاستهلاك والخطة المميزة على كل من نظامي التشغيل Windows وLinux. إنه ليس مطلوباً لتطبيقات الخطط المخصصة، والتي لا يتم تحجيمها ديناميكياً بواسطة الوظائف.
يتم إنشاء المشاركة عند إنشاء تطبيق الوظائف. قد يؤدي تغيير هذا الإعداد أو إزالته إلى عدم بدء تشغيل تطبيق الوظائف. لمعرفة المزيد، راجع مقالة استكشاف الأخطاء وإصلاحها هذه.
تنطبق الاعتبارات التالية عند استخدام قالب Azure Resource Manager (ARM) أو ملف Bicep لإنشاء تطبيق دالة أثناء النشر:
- عندما لا تحدد قيمة
WEBSITE_CONTENTSHARE
لتطبيق الوظيفة الرئيسية أو أي تطبيقات في الفتحات، يتم إنشاء قيم مشاركة فريدة من أجلك. لا يعد الإعدادWEBSITE_CONTENTSHARE
هو الأسلوب الموصى به لنشر قالب ARM. - هناك سيناريوهات حيث يجب تعيين
WEBSITE_CONTENTSHARE
القيمة إلى قيمة معرفة مسبقا، مثل عند استخدام حساب تخزين آمن في شبكة ظاهرية. في هذه الحالة، يجب عليك تعيين اسم مشاركة فريد لتطبيق الوظيفة الرئيسية والتطبيق لكل فتحة توزيع. في حالة حساب تخزين مؤمن بواسطة شبكة ظاهرية، يجب عليك أيضا إنشاء المشاركة نفسها كجزء من النشر التلقائي. لمزيد من المعلومات، راجع عمليات النشر الآمنة. - لا تجعل
WEBSITE_CONTENTSHARE
إعداداً للفتحة. - عند تحديد
WEBSITE_CONTENTSHARE
، يجب أن تتبع القيمة هذا التوجيه لأسماء المشاركة.
WEBSITE_DNS_SERVER
تعيين خادم DNS المستخدم من قبل تطبيق عند حل عناوين IP. غالبًا ما يكون هذا الإعداد مطلوبًا عند استخدام وظائف معينة للشبكات، مثل مناطق Azure DNS الخاصة ونقاط النهاية الخاصة.
مفتاح | عينة القيمة |
---|---|
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).
مفتاح | عينة القيمة |
---|---|
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED | 0 |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
الحد الأقصى لعدد المثيلات التي يمكن للتطبيق توسيعها. الإعداد الافتراضي ليس له حدود.
هام
هذا الإعداد قيد المعاينة. تمت إضافة خاصية تطبيق لتوسيع الحد الأقصى للوظيفة وهي الطريقة الموصى بها للحد من التوسيع.
مفتاح | عينة القيمة |
---|---|
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT | 5 |
WEBSITE_NODE_DEFAULT_VERSION
نظام تشغيل Windows فقط.
تعيين إصدار Node.js لاستخدامه عند تشغيل تطبيق الوظائف على Windows. يجب استخدام التيلدا (~) لجعل runtime يستخدم أحدث إصدار متوفر من الإصدار الرئيسي المستهدف. على سبيل المثال، عند التعيين إلى ~18
، يتم استخدام أحدث إصدار من Node.js 18. عندما يتم استهداف إصدار رئيسي باستخدام تيلدا، لا يتعين عليك تحديث الإصدار الثانوي يدويًا.
مفتاح | عينة القيمة |
---|---|
WEBSITE_NODE_DEFAULT_VERSION | ~18 |
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
عند إجراء تبديل فتحة على تطبيق وظائف يعمل على خطة Premium، يمكن أن تفشل المبادلة عندما يكون حساب التخزين المخصص المستخدم من قبل التطبيق مقيدا بالشبكة. يحدث هذا الفشل بسبب ميزة تسجيل تطبيق قديمة، والتي تتم مشاركتها من قبل كل من Functions وApp Service. يتجاوز هذا الإعداد ميزة التسجيل القديمة ويسمح بحدوث التبديل.
مفتاح | عينة القيمة |
---|---|
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS | 0 |
أضف WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
بقيمة لكافة 0
الفتحات للتأكد من أن إعدادات التشخيص القديمة لا تحظر عمليات التبديل الخاصة بك. يمكنك أيضا إضافة هذا الإعداد والقيمة إلى فتحة الإنتاج فقط كإعداد فتحة نشر (ملصقة).
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS
بشكل افتراضي، تكون إعدادات الإصدار لتطبيقات الوظائف خاصة بكل فتحة. يتم استخدام هذا الإعداد عند ترقية الوظائف باستخدام خانات التوزيع. هذا يمنع السلوك غير المتوقع بسبب تغيير الإصدارات بعد المبادلة. قم بالتعيين على 0
في الإنتاج وفي الفتحة للتأكد من تبديل جميع إعدادات الإصدار أيضاً. لمزيد من المعلومات، راجع الترقية باستخدام الفتحات.
مفتاح | عينة القيمة |
---|---|
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS | 0 |
WEBSITE_RUN_FROM_PACKAGE
تمكين تطبيق الوظائف من التشغيل من ملف حزمة، والذي يمكن تحميله محليا أو نشره في عنوان URL خارجي.
مفتاح | عينة القيمة |
---|---|
WEBSITE_RUN_FROM_PACKAGE | 1 |
القيم الصالحة هي إما عنوان URL الذي يتم حله إلى موقع ملف حزمة نشر خارجي، أو 1
. عند التعيين إلى 1
، يجب أن تكون الحزمة في d:\home\data\SitePackages
المجلد. عند استخدام نشر zip مع WEBSITE_RUN_FROM_PACKAGE
تمكين، يتم تحميل الحزمة تلقائيا إلى هذا الموقع. في المعاينة، تم تسمية هذا الإعداد WEBSITE_RUN_FROM_ZIP
. لمزيدٍ من المعلومات، راجع تشغيل الوظائف الخاصة بك من ملف حزمة.
عند النشر من عنوان URL لحزمة خارجية، يجب عليك أيضا مزامنة المشغلات يدويا. لمزيد من المعلومات، راجع تشغيل المزامنة.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION
تحتوي إعدادات WEBSITE_CONTENTAZUREFILECONNECTIONSTRING WEBSITE_CONTENTSHARE على فحوصات تحقق إضافية للتأكد من إمكانية بدء تشغيل التطبيق بشكل صحيح. فشل إنشاء إعدادات التطبيق عندما لا يمكن لتطبيق الوظائف استدعاء حساب التخزين المتلقي للمعلومات أو Key Vault بشكل صحيح بسبب قيود الشبكة أو عوامل الحد الأخرى. عند تعيين WEBSITE_SKIP_CONTENTSHARE_VALIDATION إلى 1
، يتم تخطي فحص التحقق من الصحة؛ وإلا يتم تعيين القيمة افتراضيا إلى 0
ويتم التحقق من الصحة.
مفتاح | عينة القيمة |
---|---|
WEBSITE_SKIP_CONTENTSHARE_VALIDATION | 1 |
إذا تم تخطي التحقق من الصحة ولم يكن سلسلة الاتصال أو مشاركة المحتوى صالحا، فلن يتمكن التطبيق من البدء بشكل صحيح. في هذه الحالة، ترجع الدالات أخطاء HTTP 500. لمزيد من المعلومات، راجع استكشاف الأخطاء وإصلاحها: "وقت تشغيل وظائف Azure غير قابل للوصول"
WEBSITE_SLOT_NAME
قراءة فقط. اسم فتحة التوزيع الحالية. اسم خانة الإنتاج هو Production
.
مفتاح | عينة القيمة |
---|---|
WEBSITE_SLOT_NAME | Production |
WEBSITE_TIME_ZONE
يسمح لك بتعيين المنطقة الزمنية لتطبيق الوظائف.
مفتاح | نظام التشغيل | عينة القيمة |
---|---|---|
WEBSITE_TIME_ZONE | Windows | Eastern Standard Time |
WEBSITE_TIME_ZONE | Linux | America/New_York |
المنطقة الزمنية الافتراضية المستخدمة مع تعبيرات CRON هي التوقيت العالمي (UTC). للحصول على تعبير CRON الخاص بك استناداً إلى منطقة زمنية أخرى، قم بإنشاء إعداد تطبيق لتطبيق وظيفتك باسم WEBSITE_TIME_ZONE
.
تعتمد قيمة هذا الإعداد على نظام التشغيل والخطة التي يعمل عليها تطبيق وظيفتك.
نظام التشغيل | الخطة | القيمة |
---|---|---|
Windows | الكل | عيّن القيمة على اسم المنطقة الزمنية المطلوبة كما هو محدد في السطر الثاني من كل زوج من الأزواج المعطاة بواسطة أمر Windows tzutil.exe /L |
Linux | متميز مخصصة |
قم بتعيين القيمة على اسم المنطقة الزمنية المطلوبة كما هو موضح في قاعدة بيانات tz. |
إشعار
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
لتعطيل تحسين البداية الباردة في خطة الاستهلاك.
مفتاح | عينة القيمة |
---|---|
WEBSITE_USE_PLACEHOLDER | 1 |
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED
يشير إلى ما إذا كان يجب استخدام تحسين بدء التشغيل البارد المحدد عند تشغيل وظائف عملية عامل .NET المعزولة على خطة الاستهلاك. قم بتعيين إلى 0
لتعطيل تحسين البداية الباردة في خطة الاستهلاك.
مفتاح | عينة القيمة |
---|---|
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED | 1 |
WEBSITE_VNET_ROUTE_ALL
هام
WEBSITE_VNET_ROUTE_ALL هو إعداد تطبيق قديم تم استبداله بإعداد موقع vnetRouteAllEnabled .
يشير إلى ما إذا كان يتم توجيه جميع نسب استخدام الشبكة الصادرة من التطبيق عبر الشبكة الظاهرية. تشير قيمة الإعداد إلى 1
أن جميع حركة مرور التطبيق يتم توجيهها عبر الشبكة الظاهرية. ستحتاج إلى هذا الإعداد عند تكوين تكامل الشبكة الظاهرية الإقليمية في خطط الاستضافة المرنة المتميزة والمخصصة. كما يتم استخدامه عند استخدام بوابة NAT لشبكة ظاهرية لتعريف عنوان IP الصادر الثابت.
مفتاح | عينة القيمة |
---|---|
WEBSITE_VNET_ROUTE_ALL | 1 |
WEBSITES_ENABLE_APP_SERVICE_STORAGE
يشير إلى ما إذا كان /home
الدليل مشتركا عبر مثيلات ذات مقياس، بقيمة افتراضية هي true
. يجب تعيين هذا إلى false
عند نشر تطبيق الوظائف في حاوية.
إعدادات موقع App Service
يجب الاحتفاظ ببعض التكوينات على مستوى App Service كإعدادات موقع، مثل إصدارات اللغة. تتم إدارة هذه الإعدادات في المدخل، أو باستخدام واجهات برمجة تطبيقات REST، أو باستخدام Azure CLI أو Azure PowerShell. فيما يلي إعدادات الموقع التي قد تكون مطلوبة، اعتمادا على لغة وقت التشغيل ونظام التشغيل والإصدارات:
AcrUseManagedIdentityCreds
يشير إلى ما إذا كان يتم الحصول على الصورة من مثيل Azure Container Registry باستخدام مصادقة الهوية المدارة. تتطلب قيمة true
استخدام الهوية المدارة، والتي يوصى بها عبر بيانات اعتماد المصادقة المخزنة كأفضل ممارسة أمان.
AcrUserManagedIdentityID
يشير إلى الهوية المدارة لاستخدامها عند الحصول على الصورة من مثيل Azure Container Registry. يتطلب تعيين AcrUseManagedIdentityCreds
إلى true
. هذه هي القيم الصالحة:
قيمة | الوصف |
---|---|
system |
يتم استخدام الهوية المدارة المعينة من قبل النظام لتطبيق الوظائف. |
<USER_IDENTITY_RESOURCE_ID> |
معرف المورد المؤهل بالكامل للهوية المدارة المعينة من قبل المستخدم. |
يجب إضافة الهوية التي تحددها إلى ACRPull
الدور في سجل الحاوية. لمزيد من المعلومات، راجع إنشاء وتكوين تطبيق دالة على Azure باستخدام الصورة.
alwaysOn
في تطبيق الوظائف الذي يعمل في خطة مخصصة (خدمة التطبيقات)، يتعطل وقت تشغيل الوظائف بعد بضع دقائق من عدم النشاط، حيث تقوم النقطة التي تطلب فقط إلى مشغل HTTP تنبيه تطبيق الوظائف الخاص بك. للتأكد من تشغيل الوظائف التي تم تشغيلها بدون HTTP بشكل صحيح، بما في ذلك وظائف مشغل المؤقت، قم بتمكين Always On لتطبيق الوظائف عن طريق تعيين alwaysOn
إعداد الموقع إلى قيمة true
.
functionsRuntimeAdminIsolationEnabled
تحديد ما إذا كان يمكن الوصول إلى نقاط نهاية المسؤول المضمنة (/admin
) في تطبيق الوظائف. عند التعيين إلى false
(الافتراضي)، يسمح التطبيق للطلبات بنقاط النهاية ضمن /admin
عندما تقدم هذه الطلبات مفتاحا رئيسيا في الطلب. عندما true
، /admin
لا يمكن الوصول إلى نقاط النهاية، حتى باستخدام مفتاح رئيسي.
لا يمكن تعيين هذه الخاصية للتطبيقات التي تعمل على Linux Consumption SKU، ولا يمكن تعيينها للتطبيقات التي تعمل على الإصدار 1.x من Azure Functions. إذا كنت تستخدم الإصدار 1.x، فيجب عليك أولا الترحيل إلى الإصدار 4.x.
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.
هام
عند إنشاء الحاويات الخاصة بك، يطلب منك الاحتفاظ بالصورة الأساسية للحاوية الخاصة بك محدثة إلى أحدث صورة أساسية مدعومة. الصور الأساسية المدعومة ل Azure Functions خاصة باللغة ويتم العثور عليها في مستودعات الصور الأساسية ل Azure Functions.
يلتزم فريق الوظائف بنشر التحديثات الشهرية لهذه الصور الأساسية. تتضمن التحديثات العادية آخر تحديثات الإصدار الثانوي وإصلاحات الأمان لكل من وقت تشغيل الوظائف واللغات. يجب تحديث الحاوية بانتظام من أحدث صورة أساسية وإعادة نشر الإصدار المحدث من الحاوية الخاصة بك.
netFrameworkVersion
تعيين الإصدار المحدد من .NET لوظائف C#. لمزيد من المعلومات، راجع تحديث تطبيق الوظائف في Azure.
powerShellVersion
تعيين الإصدار المحدد من PowerShell الذي تعمل عليه وظائفك. لمزيد من المعلومات، راجع تغيير إصدار PowerShell.
عند التشغيل محليا، يمكنك بدلا من ذلك استخدام FUNCTIONS_WORKER_RUNTIME_VERSION
الإعداد في ملف local.settings.json.
vnetContentShareEnabled
تستخدم التطبيقات التي تعمل في خطة Premium مشاركة ملف لتخزين المحتوى. يتم تخزين اسم مشاركة المحتوى هذه في WEBSITE_CONTENTSHARE
إعداد التطبيق ويتم تخزين سلسلة الاتصال في WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. لتوجيه نسبة استخدام الشبكة بين تطبيق الوظائف ومشاركة المحتوى من خلال شبكة ظاهرية، يجب عليك أيضا تعيين vnetContentShareEnabled
إلى true
. يعد تمكين خاصية الموقع هذه مطلبا عند تقييد حساب التخزين الخاص بك بشبكة ظاهرية في خطط الاستضافة المرنة المتميزة والمخصصة.
إشعار
يجب أن تهتم بشكل خاص عند التوجيه إلى مشاركة المحتوى في حساب تخزين مشترك بواسطة تطبيقات وظائف متعددة في نفس الخطة. لمزيد من المعلومات، راجع التوجيه المتناسق من خلال الشبكات الظاهرية في مقالة اعتبارات التخزين.
تحل خاصية الموقع هذه محل الإعداد القديم WEBSITE_CONTENTOVERVNET
.
vnetImagePullEnabled
تدعم الوظائف تطبيقات الوظائف التي تعمل في حاويات Linux. للاتصال والسحب من سجل حاوية داخل شبكة ظاهرية، يجب تعيين vnetImagePullEnabled
إلى true
. يتم دعم خاصية الموقع هذه في خطط الاستضافة المرنة المتميزة والمخصصة. لا تعتمد خطة Flex Consumption على خصائص الموقع أو إعدادات التطبيق لتكوين الشبكات. لمزيد من المعلومات، راجع إهمال خطة استهلاك Flex.
vnetRouteAllEnabled
يشير إلى ما إذا كان يتم توجيه جميع نسب استخدام الشبكة الصادرة من التطبيق عبر الشبكة الظاهرية. تشير قيمة الإعداد إلى true
أن جميع حركة مرور التطبيق يتم توجيهها عبر الشبكة الظاهرية. استخدم هذا الإعداد عند تكوين تكامل الشبكة الظاهرية الإقليمية في خطط Elastic Premium و Dedicated. كما يتم استخدامه عند استخدام بوابة NAT لشبكة ظاهرية لتعريف عنوان IP الصادر الثابت. لمزيد من المعلومات، راجع تكوين توجيه التطبيق.
يحل إعداد الموقع هذا محل إعداد WEBSITE_VNET_ROUTE_ALL القديم.
إهمال خطة الاستهلاك المرن
في خطة Flex Consumption، يتم إهمال خصائص الموقع وإعدادات التطبيق هذه ولا يجب استخدامها عند إنشاء موارد تطبيق الوظائف:
الإعداد/الخاصية | السبب |
---|---|
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 |
غير صالح |
الخطوات التالية
تعرف على كيفية تحديث إعدادات التطبيق