متغيرات البيئة وإعدادات التطبيق في Azure App Service

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

بيئة التطبيق

ترتبط متغيرات البيئة التالية ببيئة التطبيق بشكل عام.

اسم الإعداد الوصف مثال
WEBSITE_SITE_NAME غير قابلة للتعديل. اسم التطبيق.
WEBSITE_RESOURCE_GROUP غير قابلة للتعديل. اسم مجموعة موارد Azure الذي يحتوي على مورد التطبيق.
WEBSITE_OWNER_NAME غير قابلة للتعديل. يحتوي على معرف اشتراك Azure الذي يمتلك التطبيق ومجموعة الموارد ومساحة الويب.
REGION_NAME غير قابلة للتعديل. اسم المنطقة للتطبيق.
WEBSITE_PLATFORM_VERSION غير قابلة للتعديل. إصدار النظام الأساسي لخدمة التطبيق.
HOME غير قابلة للتعديل. المسار إلى الدليل الرئيسي (على سبيل المثال، D:\home على سبيل Windows).
SERVER_PORT غير قابلة للتعديل. المنفذ الذي يجب أن يستمع إليه التطبيق.
WEBSITE_WARMUP_PATH مسار نسبي إلى ping لتسخين التطبيق، بدءا من شرطة مائلة. الافتراضي هو /، الذي يدقق مسار الجذر. يمكن اختبار المسار المحدد بواسطة عميل غير مصادق عليه، مثل Azure Traffic Manager، حتى إذا تم تعيين مصادقة خدمة التطبيقات لرفض العملاء غير المصادق عليهم. (ملاحظة: لا يغير إعداد التطبيق هذا المسار المستخدم بواسطة AlwaysOn.)
WEBSITE_COMPUTE_MODE غير قابلة للتعديل. يحدد ما إذا كان التطبيق يعمل على جهاز ظاهري مخصص () أو مشترك (DedicatedShared) .
WEBSITE_SKU غير قابلة للتعديل. رمز SKU للتطبيق. القيم المحتملة هي Free، ، ، SharedBasicو Standard.
SITE_BITNESS غير قابلة للتعديل. إظهار ما إذا كان التطبيق 32 بت () أو 64 بت (x86AMD64).
WEBSITE_HOSTNAME غير قابلة للتعديل. اسم المضيف الأساسي للتطبيق. لا يتم حساب أسماء المضيفين المخصصة هنا.
WEBSITE_VOLUME_TYPE غير قابلة للتعديل. يعرض نوع وحدة التخزين قيد الاستخدام حاليا.
WEBSITE_NPM_DEFAULT_VERSION إصدار npm الافتراضي الذي يستخدمه التطبيق.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT غير قابلة للتعديل. الحد من الطلبات المتزامنة ل websocket. بالنسبة للطبقة القياسية وما فوقها، تكون القيمة هي -1، ولكن لا يزال هناك حد لكل جهاز ظاهري استنادا إلى حجم الجهاز الظاهري (راجع الحدود العددية عبر الجهاز الظاهري).
WEBSITE_PRIVATE_EXTENSIONS اضبط على 0 تعطيل استخدام إضافات المواقع الخاصة.
WEBSITE_TIME_ZONE بشكل افتراضي، تكون المنطقة الزمنية للتطبيق هي التوقيت العالمي المنسق دائما. يمكنك تغييره إلى أي من القيم الصالحة المسردة في المنطقة الزمنية. إذا لم يتم التعرف على القيمة المحددة، استخدام التوقيت العالمي المنسق. Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG في حالة تجاوز فشل وحدة التخزين أو إعادة تكوينها، يتم تحويل تطبيقك إلى وحدة تخزين احتياطية. يمنع الإعداد الافتراضي لعملية 1 العامل من إعادة التدوير عند تغيير البنية الأساسية للتخزين. إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation (WCF)، فقم بتعطيله عن طريق تعيينه إلى 0. الإعداد خاص بالفتحة، لذا يجب عليك تعيينه في جميع الفتحات.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED بشكل افتراضي، يتم "الشفاء التلقائي" لمثيل الجهاز الظاهري بشكل استباقي عندما يستخدم أكثر من 90٪ من الذاكرة المخصصة لأكثر من 30 ثانية، أو عندما يستغرق 80٪ من إجمالي الطلبات في الدقيقتين الأخيرتين وقتا أطول من 200 ثانية. إذا قام مثيل VM بتشغيل إحدى هذه القواعد، فإن عملية الاسترداد هي إعادة تشغيل متداخلة للمثيل. قم بالتعيين لتعطيل false سلوك الاسترداد هذا. الافتراضي هو true. لمزيد من المعلومات، راجع الشفاء التلقائي الاستباقي.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED عندما تتعطل عملية w3wp.exe على مثيل VM من تطبيقك بسبب استثناء لم تتم معالجته لأكثر من ثلاث مرات خلال 24 ساعة، يتم إرفاق عملية مصحح الأخطاء بعملية العامل الرئيسية على هذا المثيل، وتقوم بتجميع تفريغ ذاكرة عند تعطل عملية العامل مرة أخرى. ثم يتم تحليل تفريغ الذاكرة هذا ويتم تسجيل مكدس المكالمات الخاص بمؤشر الترابط الذي تسبب في العطل في سجلات App Service. قم بالتعيين لتعطيل false سلوك المراقبة التلقائية هذا. الافتراضي هو true. لمزيد من المعلومات، راجع مراقبة الأعطال الاستباقية.
WEBSITE_DAAS_STORAGE_SASURI أثناء مراقبة الأعطال (استباقية أو يدوية)، يتم حذف مقالب الذاكرة بشكل افتراضي. لحفظ تفريغ الذاكرة في حاوية نقطة تخزين، حدد SAS URI.
WEBSITE_CRASHMONITORING_ENABLED اضبط على true تمكين مراقبة الأعطال يدويا. يجب عليك أيضا تعيين WEBSITE_DAAS_STORAGE_SASURI و WEBSITE_CRASHMONITORING_SETTINGS. الافتراضي هو false. لا يكون لهذا الإعداد أي تأثير إذا تم تمكين تصحيح الأخطاء عن بعد. أيضا، إذا تم تعيين هذا الإعداد إلى true، يتم تعطيل مراقبة الأعطال الاستباقية .
WEBSITE_CRASHMONITORING_SETTINGS JSON بالتنسيق التالي:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. مطلوب لتكوين مراقبة الأعطال إذا WEBSITE_CRASHMONITORING_ENABLED تم تحديده. لتسجيل مكدس المكالمات فقط دون حفظ تفريغ الأعطال في حساب التخزين، أضف ,"UseStorageAccount":"false" JSON.
REMOTEDEBUGGINGVERSION إصدار تصحيح الأخطاء عن بعد.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING بشكل افتراضي، تقوم خدمة التطبيقات بإنشاء مساحة تخزين مشتركة لك عند إنشاء التطبيق. لاستخدام حساب تخزين مخصص بدلا من ذلك، اضبط على سلسلة الاتصال الخاصة بحساب التخزين. بالنسبة للوظائف، راجع مرجع إعدادات التطبيق للوظائف. DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE عند استخدام تحديد حساب تخزين مخصص مع WEBSITE_CONTENTAZUREFILECONNECTIONSTRING، تقوم خدمة التطبيقات بإنشاء مشاركة ملف في حساب التخزين هذا لتطبيقك. لاستخدام اسم مخصص، قم بتعيين هذا المتغير إلى الاسم الذي تريده. في حالة عدم وجود مشاركة ملف بالاسم المحدد، تقوم App Service بإنشائها نيابة عنك. myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED غير قابلة للتعديل. يوضح ما إذا كان التشغيل دائما ممكنا () أم لا (10).
WEBSITE_SCM_SEPARATE_STATUS غير قابلة للتعديل. إظهار ما إذا كان تطبيق Kudu قيد التشغيل في عملية منفصلة () أم لا (10).

بادئات متغيرة

يعرض الجدول التالي بادئات متغيرات البيئة التي تستخدمها App Service لأغراض مختلفة.

اسم الإعداد الوصف
APPSETTING_ يشير إلى أن العميل يقوم بتعيين متغير كإعداد تطبيق في تكوين التطبيق. يتم حقنه في تطبيق .NET كإعداد تطبيق.
MAINSITE_ يشير إلى متغير خاص بالتطبيق نفسه.
SCMSITE_ يشير إلى متغير خاص بتطبيق Kudu.
SQLCONNSTR_ يشير إلى سلسلة اتصال SQL Server في تكوين التطبيق. يتم حقنه في تطبيق .NET كسلسلة اتصال.
SQLAZURECONNSTR_ يشير إلى سلسلة اتصال قاعدة بيانات Azure SQL في تكوين التطبيق. يتم حقنه في تطبيق .NET كسلسلة اتصال.
POSTGRESQLCONNSTR_ يشير إلى سلسلة اتصال PostgreSQL في تكوين التطبيق. يتم حقنه في تطبيق .NET كسلسلة اتصال.
CUSTOMCONNSTR_ يشير إلى سلسلة اتصال مخصصة في تكوين التطبيق. يتم حقنه في تطبيق .NET كسلسلة اتصال.
MYSQLCONNSTR_ يشير إلى سلسلة اتصال قاعدة بيانات Azure SQL في تكوين التطبيق. يتم حقنه في تطبيق .NET كسلسلة اتصال.
AZUREFILESSTORAGE_ سلسلة اتصال بمشاركة مخصصة لحاوية مخصصة في ملفات Azure.
AZUREBLOBSTORAGE_ سلسلة اتصال بحساب تخزين مخصص لحاوية مخصصة في Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_ يشير إلى سلسلة اتصال بمركز إعلام في موزعات إعلامات Azure.
SERVICEBUSCONNSTR_ يشير إلى سلسلة اتصال بمثيل ناقل خدمة Azure.
EVENTHUBCONNSTR_ يشير إلى سلسلة اتصال بمركز أحداث في مراكز أحداث Azure.
DOCDBCONNSTR_ يشير إلى سلسلة اتصال بقاعدة بيانات في Azure Cosmos DB.
REDISCACHECONNSTR_ يشير إلى سلسلة اتصال بذاكرة تخزين مؤقت في Azure Cache for Redis.
FILESHARESTORAGE_ يشير إلى سلسلة اتصال بمشاركة ملف مخصصة.

توزيع

ترتبط متغيرات البيئة التالية بنشر التطبيق. للاطلاع على المتغيرات المتعلقة بأتمتة إنشاء خدمة التطبيقات، راجع إنشاء التشغيل التلقائي.

اسم الإعداد الوصف
DEPLOYMENT_BRANCH لنشر Git المحلي أو نشر Git السحابي (مثل GitHub)، قم بالتعيين إلى الفرع في Azure الذي تريد النشر إليه. بشكل افتراضي ، هو master.
WEBSITE_RUN_FROM_PACKAGE قم بالتعيين لتشغيل التطبيق من حزمة ZIP محلية، أو قم بالتعيين 1 إلى عنوان URL لعنوان URL خارجي لتشغيل التطبيق من حزمة ZIP بعيدة. لمزيد من المعلومات، راجع تشغيل تطبيقك في Azure App Service مباشرة من حزمة ZIP.
WEBSITE_USE_ZIP مهملة. استخدم WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP مهملة. استخدم WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_WEBDEPLOY_USE_SCM قم بالتعيين إلى false WebDeploy للتوقف عن استخدام محرك نشر Kudu. الافتراضي هو true. للنشر على تطبيقات Linux باستخدام Visual Studio (WebDeploy/MSDeploy)، قم بتعيينه إلى false.
MSDEPLOY_RENAME_LOCKED_FILES قم بالتعيين 1 إلى محاولة إعادة تسمية DLLs إذا تعذر نسخها أثناء نشر WebDeploy. لا ينطبق هذا الإعداد إذا WEBSITE_WEBDEPLOY_USE_SCM تم تعيينه على false.
WEBSITE_DISABLE_SCM_SEPARATION بشكل افتراضي ، يتم تشغيل التطبيق الرئيسي وتطبيق Kudu في صناديق رمل مختلفة. عند إيقاف التطبيق، يظل تطبيق Kudu قيد التشغيل، ويمكنك الاستمرار في استخدام Git deploy وMSDeploy. يحتوي كل تطبيق على ملفاته المحلية الخاصة. يعد إيقاف تشغيل هذا الفصل (الإعداد إلى true) وضعا قديما لم يعد مدعوما بالكامل.
WEBSITE_ENABLE_SYNC_UPDATE_SITE قم بالتعيين 1 للتأكد من أن واجهة برمجة تطبيقات REST تستدعي التحديث site ويتم siteconfig تطبيقها بالكامل على جميع المثيلات قبل العودة. الافتراضي هو 1 إذا تم النشر باستخدام قالب ARM ، لتجنب ظروف السباق مع مكالمات ARM اللاحقة.
WEBSITE_START_SCM_ON_SITE_CREATION في نشر قالب ARM، اضبط على 1 في قالب ARM لبدء تشغيل تطبيق Kudu مسبقا كجزء من إنشاء التطبيق.
WEBSITE_START_SCM_WITH_PRELOAD بالنسبة إلى تطبيقات Linux، اضبط على فرض التحميل المسبق لتطبيق true Kudu عند تمكين Always On عن طريق اختبار عنوان URL الخاص به. الافتراضي هو false. بالنسبة Windows التطبيقات ، يتم دائما تحميل تطبيق Kudu مسبقا.

أتمتة البناء

ينطبق تكوين إنشاء Kudu على تطبيقات Windows الأصلية ويستخدم للتحكم في سلوك عمليات النشر المستندة إلى Git (أو المستندة إلى ZIP).

اسم الإعداد الوصف مثال
SCM_BUILD_ARGS إضافة أشياء في نهاية سطر الأوامر msbuild بحيث يتجاوز أي أجزاء سابقة من سطر الأوامر الافتراضي. للقيام ببناء نظيف: -t:Clean;Compile
SCM_SCRIPT_GENERATOR_ARGS يستخدم Kudu الأمر الموضح azure site deploymentscriptهنا لإنشاء برنامج نصي للنشر. يكتشف تلقائيا نوع إطار عمل اللغة ويحدد المعلمات لتمريرها إلى الأمر. يتجاوز هذا الإعداد المعلمات التي يتم إنشاؤها تلقائيا. للتعامل مع المستودع كملفات محتوى عادية: --basic -p <folder-to-deploy>
SCM_TRACE_LEVEL بناء مستوى التتبع. الافتراضي هو 1. اضبط على قيم أعلى، تصل إلى 4، لمزيد من التتبع. 4
SCM_COMMAND_IDLE_TIMEOUT مهلة بالثواني لكل أمر تقوم عملية الإنشاء بتشغيله للانتظار قبل ذلك دون إنتاج أي مخرجات. بعد ذلك ، يعتبر الأمر خاملا ويقتل. الافتراضي هو 60 (دقيقة واحدة). في Azure، هناك أيضا مهلة طلب خاملة عامة تقطع اتصال العملاء بعد 230 ثانية. ومع ذلك ، سيستمر الأمر في التشغيل من جانب الخادم بعد ذلك.
SCM_LOGSTREAM_TIMEOUT مهلة عدم النشاط في ثوان قبل إيقاف دفق السجل. الافتراضي هو 1800 (30 دقيقة).
SCM_SITEEXTENSIONS_FEED_URL عنوان URL لمعرض إضافات المواقع. الافتراضي هو https://www.nuget.org/api/v2/. عنوان URL للخلاصة القديمة هو http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY اضبط على 0 استخدام git.exe بدلا من libgit2sharp لعمليات git.
WEBSITE_LOAD_USER_PROFILE في حالة حدوث خطأ The specified user does not have a valid profile. أثناء ASP.NET أتمتة الإنشاء (مثل أثناء نشر Git)، قم بتعيين هذا المتغير لتحميل 1 ملف تعريف مستخدم كامل في بيئة الإنشاء. لا ينطبق هذا الإعداد إلا عندما يكون WEBSITE_COMPUTE_MODEDedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES المهلة بالدقائق لموقع SCM (Kudu). الافتراضي هو 20.
SCM_DO_BUILD_DURING_DEPLOYMENT مع نشر ZIP، يفترض محرك النشر أن ملف ZIP جاهز للتشغيل كما هو ولا يقوم بتشغيل أي أتمتة إنشاء. لتمكين أتمتة البنية نفسها كما هو الحال في نشر Git، اضبط على true.

الإعدادات الخاصة باللغة

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

اسم الإعداد الوصف
PORT غير قابلة للتعديل. بالنسبة لتطبيقات Linux، قم بالمنفذ الذي يستمع إليه وقت تشغيل .NET في الحاوية.
WEBSITE_ROLE_INSTANCE_ID غير قابلة للتعديل. معرف المثيل الحالي.
HOME غير قابلة للتعديل. الدليل الذي يشير إلى التخزين المشترك (/home).
DUMP_DIR غير قابلة للتعديل. دليل مقالب التعطل (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY تطبيقات لينكس فقط. بشكل افتراضي ، يتم تشغيل التطبيق من /home/site/wwwroot، دليل مشترك لجميع المثيلات التي تم توسيع نطاقها. قم بتعيين هذا المتغير لنسخ true التطبيق إلى دليل محلي في الحاوية الخاصة بك وتشغيله من هناك. عند استخدام هذا الخيار ، تأكد من عدم ترميز أي إشارة إلى /home/site/wwwroot. بدلا من ذلك، استخدم مسارا بالنسبة إلى /home/site/wwwroot.
MACHINEKEY_Decryption بالنسبة Windows التطبيقات الأصلية أو التطبيقات Windows المعبأة في حاويات، يتم حقن هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية decryption ، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر ملف Web.config .
MACHINEKEY_DecryptionKey بالنسبة Windows التطبيقات الأصلية أو التطبيقات Windows المعبأة في حاويات، يتم حقن هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة التي يتم إنشاؤها decryptionKey تلقائيا، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر ملف Web.config .
MACHINEKEY_Validation بالنسبة Windows التطبيقات الأصلية أو التطبيقات Windows المعبأة في حاويات، يتم حقن هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية validation ، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر ملف Web.config .
MACHINEKEY_ValidationKey بالنسبة Windows التطبيقات الأصلية أو التطبيقات Windows المعبأة في حاويات، يتم حقن هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة التي يتم إنشاؤها validationKey تلقائيا، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر ملف Web.config .

⁦⁩WordPress⁦⁩

إعداد التطبيق النطاق القيمة حد أقصى الوصف
WEBSITES_ENABLE_APP_SERVICE_STORAGE Web App صواب - عند التعيين إلى TRUE، يتم الاحتفاظ بمحتويات الملف أثناء إعادة التشغيل.
WP_MEMORY_LIMIT ⁦⁩WordPress⁦⁩ 128 مليون 512 مليون الواجهة الأمامية أو العامة وورد PHP حد الذاكرة (لكل برنامج نصي). لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT
WP_MAX_MEMORY_LIMIT ⁦⁩WordPress⁦⁩ 256 مليون 512 مليون لوحة معلومات المسؤول PHP حد الذاكرة (لكل برنامج نصي). بشكل عام ، تأخذ لوحة معلومات المسؤول / البرامج النصية الخلفية الكثير من الذاكرة مقارنة بالبرامج النصية للواجهة الأمامية. لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512 مليون 512 مليون حدود الذاكرة لبرنامج PHP النصي العام. لا يمكن إلا أن يتم تقليله.
FILE_UPLOADS PHP تشغيل - يمكن أن يكون إما قيد التشغيل أو الإيقاف. لاحظ أن القيم حساسة لحالة الأحرف. تمكين تحميلات الملفات أو تعطيلها.
UPLOAD_MAX_FILESIZE PHP 50 مليون 256M الحد الأقصى لحجم تحميل الملف. يمكن زيادتها حتى 256M.
POST_MAX_SIZE PHP 128 مليون 256 مليون يمكن زيادتها حتى 256M. عموما يجب أن يكون أكثر من UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 يمكن فقط تخفيضها. يرجى تقسيم البرامج النصية إذا كان الأمر يستغرق أكثر من 120 ثانية. تمت إضافته لتجنب البرامج النصية السيئة من إبطاء النظام.
MAX_INPUT_TIME PHP 120 120 الحد الأقصى للوقت المحدد لتحليل طلبات الإدخال. يمكن فقط تخفيضها.
MAX_INPUT_VARS PHP ⁧⁩10000⁧⁩ ⁧⁩10000⁧⁩ -
DATABASE_HOST قاعدة البيانات - - مضيف قاعدة البيانات المستخدمة للاتصال ب WordPress.
DATABASE_NAME قاعدة البيانات - - اسم قاعدة البيانات المستخدمة للاتصال ب WordPress.
DATABASE_USERNAME قاعدة البيانات - - اسم مستخدم قاعدة البيانات المستخدم للاتصال ب WordPress.
DATABASE_PASSWORD قاعدة البيانات - - كلمة مرور قاعدة البيانات المستخدمة للاتصال ب WordPress.

المجال وDNS

اسم الإعداد الوصف مثال
WEBSITE_DNS_SERVER عنوان IP لخادم DNS الأساسي للاتصالات الصادرة (مثل خدمة الواجهة الخلفية). خادم DNS الافتراضي لخدمة التطبيقات هو Azure DNS، وعنوان IP الخاص به هو 168.63.129.16. إذا كان تطبيقك يستخدم تكامل VNet أو كان في بيئة خدمة التطبيق، فإنه يرث تكوين خادم DNS من VNet بشكل افتراضي. 10.0.0.1
WEBSITE_DNS_ALT_SERVER عنوان IP لخادم DNS الاحتياطي للاتصالات الصادرة. راجع WEBSITE_DNS_SERVER.

TLS/SSL

لمزيد من المعلومات، راجع استخدام شهادة TLS/SSL في التعليمات البرمجية في Azure App Service.

اسم الإعداد الوصف
WEBSITE_LOAD_CERTIFICATES قيم بصمة الإبهام المنفصلة بفواصل إلى الشهادة التي تريد تحميلها في التعليمات البرمجية، أو * للسماح بتحميل جميع الشهادات في التعليمات البرمجية. يمكن تحميل الشهادات المضافة إلى تطبيقك فقط.
WEBSITE_PRIVATE_CERTS_PATH غير قابلة للتعديل. مسار في حاوية Windows إلى الشهادات الخاصة المحملة.
WEBSITE_PUBLIC_CERTS_PATH غير قابلة للتعديل. المسار في حاوية Windows إلى الشهادات العامة المحملة.
WEBSITE_INTERMEDIATE_CERTS_PATH غير قابلة للتعديل. مسار في حاوية Windows إلى الشهادات الوسيطة المحملة.
WEBSITE_ROOT_CERTS_PATH غير قابلة للتعديل. مسار في حاوية Windows إلى الشهادات الجذر المحملة.

الفتحات الخاصة بالنشر

لمزيد من المعلومات حول فتحات النشر، راجع إعداد بيئات التدريج في Azure App Service.

اسم الإعداد الوصف مثال
WEBSITE_SLOT_NAME غير قابلة للتعديل. اسم فتحة النشر الحالية. اسم فتحة الإنتاج هو Production.
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS بشكل افتراضي، تكون إصدارات إضافات المواقع خاصة بكل فتحة. يمنع هذا سلوك التطبيق غير المتوقع بسبب تغيير إصدارات الملحقات بعد المبادلة. إذا كنت تريد تبديل إصدارات الإضافات أيضا، فقم بتعيينها على 0جميع الفتحات.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS يعين إعدادات معينة على أنها لزجة أو غير قابلة للتبديل بشكل افتراضي. الافتراضي هو true. قم بتعيين هذا الإعداد إلى falseجميع فتحات النشر أو 0 لجعلها قابلة للتبديل بدلا من ذلك. لا يوجد تحكم دقيق في الحبيبات لأنواع معينة من الإعدادات.
WEBSITE_SWAP_WARMUP_PING_PATH المسار إلى ping لتسخين الفتحة المستهدفة في مبادلة ، بدءا من شرطة مائلة. الافتراضي هو /، الذي يقوم باختبار مسار الجذر عبر HTTP. /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES رموز استجابة HTTP صالحة لعملية الإحماء أثناء المبادلة. إذا لم تكن تعليمات الحالة البرمجية التي تم إرجاعها موجودة في القائمة، فسيتم إيقاف عمليات التجهيز والتبديل. وتعد جميع تعليمات الاستجابة البرمجية صالحة بشكل افتراضي. 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART أثناء تبديل الفتحات، الحد الأقصى لعدد المهلات التي نفرض بعدها إعادة تشغيل الموقع على مثيل جهاز ظاهري معين. الافتراضي هو 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS أثناء تبديل الفتحات، الحد الأقصى لعدد طلبات المهلة لعنوان URL واحد قبل الاستسلام. الافتراضي هو 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG قم بالتعيين إلى true أو 1 لتخطي جميع الروابط في applicationHost.config. الافتراضي هو false. إذا كان تطبيقك يؤدي إلى إعادة التشغيل لأنه applicationHost.config تم تحديثه بأسماء المضيفين المبادلة للفتحات th، فقم بتعيين هذا المتغير true لتجنب إعادة تشغيل من هذا النوع. إذا كنت تقوم بتشغيل تطبيق مؤسسة اتصالات Windows (WCF)، فلا تقم بتعيين هذا المتغير.

حاويات مخصصة

لمزيد من المعلومات حول الحاويات المخصصة، راجع تشغيل حاوية مخصصة في Azure.

اسم الإعداد الوصف مثال
WEBSITES_ENABLE_APP_SERVICE_STORAGE قم بالتعيين true/home لتمكين مشاركة الدليل عبر المثيلات التي تم تغيير حجمها. الافتراضي هو false للحاويات المخصصة.
WEBSITES_CONTAINER_START_TIME_LIMIT مقدار الوقت بالثواني لانتظار اكتمال بدء تشغيل الحاوية قبل إعادة تشغيل الحاوية. الافتراضي هو 230. يمكنك زيادته إلى الحد الأقصى 1800.
DOCKER_REGISTRY_SERVER_URL عنوان URL لخادم التسجيل، عند تشغيل حاوية مخصصة في App Service. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية. https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME اسم المستخدم للمصادقة مع خادم التسجيل في DOCKER_REGISTRY_SERVER_URL. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية.
DOCKER_REGISTRY_SERVER_PASSWORD كلمة مرور للمصادقة مع خادم التسجيل في DOCKER_REGISTRY_SERVER_URL. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية.
DOCKER_ENABLE_CI اضبط على true تمكين النشر المستمر للحاويات المخصصة. الافتراضي هو false للحاويات المخصصة.
WEBSITE_PULL_IMAGE_OVER_VNET الاتصال وسحب من سجل داخل شبكة افتراضية أو داخل الشركة. سيحتاج تطبيقك إلى الاتصال بشبكة افتراضية باستخدام ميزة تكامل VNet. هذا الإعداد مطلوب أيضا لتسجيل حاوية Azure مع نقطة النهاية الخاصة.
WEBSITES_WEB_CONTAINER_NAME في تطبيق Docker Compose ، يمكن الوصول إلى حاوية واحدة فقط من الحاويات عبر الإنترنت. قم بالتعيين إلى اسم الحاوية المحددة في ملف التكوين لتجاوز تحديد الحاوية الافتراضي. بشكل افتراضي، تكون الحاوية التي يمكن الوصول إليها عبر الإنترنت هي أول حاوية تحدد المنفذ 80 أو 8080، أو عند عدم العثور على مثل هذه الحاوية، تكون الحاوية الأولى المعرفة في ملف التكوين.
WEBSITES_PORT بالنسبة إلى حاوية مخصصة، رقم المنفذ المخصص على حاوية App Service لتوجيه الطلبات إليه. بشكل افتراضي، تحاول خدمة التطبيقات الكشف التلقائي عن منافذ المنفذين 80 و8080. لا يتم حقن هذا الإعداد في الحاوية كمتغير بيئة.
WEBSITE_CPU_CORES_LIMIT بشكل افتراضي ، يتم تشغيل حاوية Windows مع جميع النوى المتاحة لطبقة التسعير التي اخترتها. لتقليل عدد النوى، اضبط على حد عدد النوى المطلوب. لمزيد من المعلومات، راجع تخصيص عدد مراكز الحوسبة.
WEBSITE_MEMORY_LIMIT_MB بشكل افتراضي، تقتصر جميع حاويات Windows المنشورة في Azure App Service على ذاكرة وصول عشوائي (RAM) بسعة 1 غيغابايت. اضبط على حد الذاكرة المطلوب بالميجابايت. يجب ألا يتجاوز الإجمالي التراكمي لهذا الإعداد عبر التطبيقات في الخطة نفسها المبلغ المسموح به من قبل طبقة التسعير المختارة. لمزيد من المعلومات، راجع تخصيص ذاكرة الحاوية.
CONTAINER_WINRM_ENABLED بالنسبة إلى تطبيق Windows في حاويات، اضبط على 1 تمكين Windows الإدارة عن بعد (WIN-RM).

تغير الحجم

اسم الإعداد الوصف
WEBSITE_INSTANCE_ID غير قابلة للتعديل. معرف فريد لمثيل الجهاز الظاهري الحالي، عندما يتم توسيع نطاق التطبيق إلى مثيلات متعددة.
WEBSITE_IIS_SITE_NAME مهملة. استخدم WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING إعادة التدوير المتداخلة تجعل من ذلك قبل إيقاف تشغيل مثيل VM الحالي لأحد التطبيقات، يبدأ مثيل VM جديد. في بعض الحالات ، يمكن أن يسبب مشكلات في قفل الملفات. يمكنك محاولة إيقاف تشغيله عن طريق الإعداد إلى 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE بشكل افتراضي، يسمح للتطبيقات بالتوسع عبر الطوابع إذا كانت تستخدم ملفات Azure أو حاوية Docker. قم بالتعيين إلى 1 أو true لتعطيل تغيير حجم الطوابع المتقاطعة داخل منطقة التطبيق. الافتراضي هو 0. حاويات Docker المخصصة التي تم تعيينها WEBSITES_ENABLE_APP_SERVICE_STORAGE إلى الطوابع true المتقاطعة أو 1 لا يمكنها قياسها لأن محتواها غير مغلف بالكامل في حاوية Docker.

تسجيل الدخول

اسم الإعداد الوصف مثال
WEBSITE_HTTPLOGGING_ENABLED غير قابلة للتعديل. يوضح ما إذا كان تسجيل خادم الويب للتطبيقات الأصلية Windows ممكنا () أم لا (10).
WEBSITE_HTTPLOGGING_RETENTION_DAYS فترة الاحتفاظ بالأيام من سجلات خادم الويب Windows التطبيقات الأصلية، إذا تم تمكين سجلات خادم الويب. 10
WEBSITE_HTTPLOGGING_CONTAINER_URL عنوان URL ل SAS لحاوية تخزين blob لتخزين سجلات خادم الويب Windows التطبيقات الأصلية، إذا تم تمكين سجلات خادم الويب. إذا لم يتم تعيينها، تخزين سجلات خادم الويب في نظام ملفات التطبيق (التخزين المشترك الافتراضي).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS فترة الاحتفاظ بأيام سجلات التطبيقات Windows التطبيقات الأصلية، إذا تم تمكين سجلات التطبيقات. 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL عنوان URL ل SAS لحاوية تخزين blob لتخزين سجلات التطبيقات Windows التطبيقات الأصلية، إذا تم تمكين سجلات التطبيقات.
APPSERVICEAPPLOGS_TRACE_LEVEL الحد الأدنى لمستوى السجل للشحن إلى Log Analytics لنوع سجل AppServiceAppLogs .
DIAGNOSTICS_LASTRESORTFILE اسم الملف المراد إنشاؤه، أو مسار نسبي إلى دليل السجل، لتسجيل الأخطاء الداخلية لاستكشاف أخطاء المستمع وإصلاحها. الافتراضي هو logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE المسار إلى ملف إعدادات السجل، بالنسبة إلى D:\home أو /home. الافتراضي هو site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY مجلد السجل، بالنسبة إلى جذر التطبيق (D:\home\site\wwwroot أو /home/site/wwwroot). ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES الحد الأقصى لحجم ملف السجل بالبايت. الافتراضي هو 131072 (128 كيلو بايت).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES الحد الأقصى لحجم مجلد السجل بالبايت. الافتراضي هو 1048576 (1 ميغابايت).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES الحد الأقصى لعدد ملفات السجل للاحتفاظ بها. الافتراضي هو 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD مهلة بالمللي ثانية للحفاظ على تمكين تسجيل التطبيق. الافتراضي هو 43200000 (12 ساعة).
WEBSITE_LOG_BUFFERING بشكل افتراضي، يتم تمكين التخزين المؤقت للسجلات. اضبط على 0 تعطيله.
WEBSITE_ENABLE_PERF_MODE بالنسبة لتطبيقات Windows الأصلية، اضبط على TRUE إيقاف تشغيل إدخالات سجل IIS للطلبات الناجحة التي يتم إرجاعها في غضون 10 ثوان. هذه طريقة سريعة لإجراء قياس الأداء عن طريق إزالة التسجيل الموسع.

عدادات الأداء

فيما يلي متغيرات البيئة "المزيفة" التي لا توجد إذا قمت بتعدادها ، ولكن قم بإرجاع قيمتها إذا بحثت عنها بشكل فردي. القيمة ديناميكية ويمكن أن تتغير في كل عملية بحث.

اسم الإعداد الوصف
WEBSITE_COUNTERS_ASPNET كائن JSON يحتوي على عدادات perf ASP.NET.
WEBSITE_COUNTERS_APP كائن JSON يحتوي على عدادات وضع الحماية.
WEBSITE_COUNTERS_CLR كائن JSON يحتوي على عدادات CLR.
WEBSITE_COUNTERS_ALL كائن JSON يحتوي على مزيج من المتغيرات الثلاثة الأخرى.

تخزين مؤقت

اسم الإعداد الوصف
WEBSITE_LOCAL_CACHE_OPTION ما إذا كان قد تم تمكين ذاكرة التخزين المؤقت المحلية. الخيارات المتاحة هي:
- Defaultوراثة الإعداد العالمي على مستوى الطوابع.:
- Alwaysتمكين للتطبيق.:
- OnStorageعدم توفر
- Disabledمعطل للتطبيق.:
WEBSITE_LOCAL_CACHE_READWRITE_OPTION خيارات القراءة والكتابة لذاكرة التخزين المؤقت المحلية. الخيارات المتاحة هي:
- ReadOnlyذاكرة التخزين المؤقت للقراءة فقط.:
- WriteButDiscardChangesالسماح بالكتابة إلى ذاكرة التخزين المؤقت المحلية ولكن تجاهل التغييرات التي تم إجراؤها محليا.:
WEBSITE_LOCAL_CACHE_SIZEINMB حجم ذاكرة التخزين المؤقت المحلية بالميغابايت. الافتراضي هو 1000 (1 غيغابايت).
WEBSITE_LOCALCACHE_READY علامة للقراءة فقط تشير إلى ما إذا كان التطبيق يستخدم ذاكرة التخزين المؤقت المحلية.
WEBSITE_DYNAMIC_CACHE نظرا للطبيعة المشتركة لملف الشبكة للسماح بالوصول إلى مثيلات متعددة، تعمل ذاكرة التخزين المؤقت الديناميكية على تحسين الأداء عن طريق التخزين المؤقت للملفات التي تم الوصول إليها مؤخرا محليا على مثيل. يتم إبطال ذاكرة التخزين المؤقت عند تعديل الملف. موقع ذاكرة التخزين المؤقت هو (يتم %SYSTEMDRIVE%\local\DynamicCache تطبيق نفس %SYSTEMDRIVE%\local الحصة النسبية). بشكل افتراضي ، يتم تمكين التخزين المؤقت الكامل للمحتوى (مضبوط على ) ، والذي يتضمن كل من محتوى الملف وبيانات تعريف الدليل / الملف (الطوابع 1الزمنية والحجم ومحتوى الدليل). للحفاظ على استخدام القرص المحلي، اضبط على 2 تخزين بيانات تعريف الدليل/الملف مؤقتا فقط (الطوابع الزمنية والحجم ومحتوى الدليل). لإيقاف تشغيل التخزين المؤقت، اضبط على 0.
WEBSITE_READONLY_APP عند استخدام ذاكرة التخزين المؤقت الديناميكية، يمكنك تعطيل الوصول إلى الكتابة إلى جذر التطبيق (D:\home\site\wwwroot أو /home/site/wwwroot) عن طريق تعيين هذا المتغير إلى 1. باستثناء الدليل App_Data ، لا يسمح بالأقفال الحصرية ، بحيث لا يتم حظر عمليات النشر بواسطة الملفات المقفلة.

الشبكات

ترتبط متغيرات البيئة التالية بالاتصالات المختلطةوتكامل VNET.

اسم الإعداد الوصف
WEBSITE_RELAYS غير قابلة للتعديل. البيانات اللازمة لتكوين الاتصال المختلط، بما في ذلك نقاط النهاية وبيانات ناقل الخدمة.
WEBSITE_REWRITE_TABLE غير قابلة للتعديل. تستخدم في وقت التشغيل لإجراء عمليات البحث وإعادة كتابة الاتصالات بشكل مناسب.
WEBSITE_VNET_ROUTE_ALL بشكل افتراضي، إذا كنت تستخدم تكامل VNet الإقليمي، فإن تطبيقك يوجه حركة مرور RFC1918 فقط إلى VNet. اضبط على 1 توجيه جميع حركة المرور الصادرة إلى VNet الخاص بك وتخضع لنفس NSGs و UDRs. يتيح لك الإعداد الوصول إلى نقاط النهاية غير RFC1918 من خلال VNet، وتأمين جميع حركة المرور الصادرة التي تغادر تطبيقك، وفرض نفق كل حركة المرور الصادرة إلى جهاز شبكة من اختيارك.
WEBSITE_PRIVATE_IP غير قابلة للتعديل. عنوان IP المرتبط بالتطبيق عند دمجه مع VNet. بالنسبة لتكامل VNet الإقليمي، تكون القيمة عبارة عن عنوان IP من نطاق عناوين الشبكة الفرعية المفوضة، وبالنسبة لتكامل VNet المطلوب من البوابة، تكون القيمة عبارة عن عنوان IP من نطاق عناوين تجمع عناوين من نقطة إلى موقع تم تكوينه على "بوابة الشبكة الظاهرية". يتم استخدام عنوان IP هذا بواسطة التطبيق للاتصال بالموارد من خلال VNet. أيضا ، يمكن أن يتغير داخل نطاق العنوان الموصوف.
WEBSITE_PRIVATE_PORTS غير قابلة للتعديل. في تكامل VNet ، يعرض المنافذ التي يمكن استخدامها بواسطة التطبيق للتواصل مع العقد الأخرى.

مراجع المخزن الرئيسية

ترتبط متغيرات البيئة التالية بمراجع المخزن الرئيسية.

اسم الإعداد الوصف
WEBSITE_KEYVAULT_REFERENCES غير قابلة للتعديل. يحتوي على معلومات (بما في ذلك الحالات) لجميع مراجع Key Vault التي تم تكوينها حاليا في التطبيق.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION إذا قمت بتعيين اتصال التخزين المشترك لتطبيقك (باستخدامWEBSITE_CONTENTAZUREFILECONNECTIONSTRING) إلى مرجع Key Vault، فلن يتمكن التطبيق من حل مرجع المخزن الرئيسي عند إنشاء التطبيق أو تحديثه إذا تحقق أحد الشروط التالية:
- يصل التطبيق إلى قبو المفاتيح بهوية معينة من قبل النظام.
- يصل التطبيق إلى قبو المفاتيح بهوية معينة من قبل المستخدم ، ويتم قفل قبو المفاتيح باستخدام VNet.
لتجنب الأخطاء في وقت الإنشاء أو التحديث، قم بتعيين هذا المتغير إلى 1.
WEBSITE_DELAY_CERT_DELETION يمكن تعيين env var هذا إلى 1 من قبل المستخدمين لضمان عدم حذف الشهادة التي تعتمد عليها عملية العامل حتى يتم خروجها.

كورس

ترتبط متغيرات البيئة التالية بتكوين مشاركة الموارد عبر الأصل (CORS).

اسم الإعداد الوصف
WEBSITE_CORS_ALLOWED_ORIGINS غير قابلة للتعديل. يعرض الأصول المسموح بها ل CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS غير قابلة للتعديل. يوضح ما إذا كان تعيين Access-Control-Allow-Credentials الرأس إلى true ممكن () أم لا (TrueFalse).

تفويض المصادقة &

ترتبط متغيرات البيئة التالية بمصادقة خدمة التطبيق.

اسم الإعداد الوصف
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW عند التعيين إلى ، يقوم بتعطيل تعيين الهوية الأساسية لمؤشر الترابط في تطبيقات الويب المستندة إلى trueASP.NET (بما في ذلك تطبيقات وظائف v1). تم تصميم هذا للسماح للمطورين بحماية الوصول إلى موقعهم باستخدام المصادقة ، ولكن لا يزال يتعين عليهم استخدام آلية تسجيل دخول منفصلة داخل منطق التطبيق الخاص بهم. الافتراضي هو false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true أو false. القيمة الافتراضية هي false. هذا إعداد لتكامل تطبيقات Azure Mobile القديمة لخدمة تطبيقات Azure. يؤدي تعيين هذا الإجراء إلى true حل مشكلة قد يتغير فيها SID (معرف الأمان) الذي تم إنشاؤه للمستخدمين المصادق عليهم إذا قام المستخدم بتغيير معلومات ملف التعريف الخاص به. قد يؤدي تغيير هذه القيمة إلى تغيير معرفات مستخدمي Azure Mobile Apps الحالية. لا تحتاج معظم التطبيقات إلى استخدام هذا الإعداد.
WEBSITE_AUTH_NONCE_DURATION قيمة الفترة الزمنية في النموذج _hours_:_minutes_:_seconds_. القيمة الافتراضية هي 00:05:00، أو 5 دقائق. يتحكم هذا الإعداد في عمر nonce التشفير الذي تم إنشاؤه لجميع عمليات تسجيل الدخول التي تعتمد على المستعرض. إذا فشل تسجيل الدخول في الإكمال في الوقت المحدد، إعادة محاولة تدفق تسجيل الدخول تلقائيا. تم تصميم إعداد التطبيق هذا للاستخدام مع تجربة تكوين V1 (الكلاسيكية). في حالة استخدام مخطط تكوين مصادقة V2، يجب عليك بدلا من ذلك استخدام قيمة التكوين login.nonce.nonceExpirationInterval .
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT عند التعيين إلى true والمستخدمين النقر على روابط التطبيق التي تحتوي على أجزاء عنوان URL ، ستضمن عملية تسجيل الدخول عدم ضياع جزء جزء عنوان URL من عنوان URL الخاص بك في عملية إعادة توجيه تسجيل الدخول. لمزيد من المعلومات، راجع تخصيص تسجيل الدخول وتسجيل الخروج في مصادقة Azure App Service.
WEBSITE_AUTH_USE_LEGACY_CLAIMS للحفاظ على التوافق مع الإصدارات السابقة عبر الترقيات، تستخدم وحدة المصادقة تعيين المطالبات القديمة للأسماء القصيرة إلى الطويلة في /.auth/me واجهة برمجة التطبيقات، بحيث يتم استبعاد بعض التعيينات (مثل "الأدوار"). للحصول على الإصدار الأكثر حداثة من تعيينات المطالبات، اضبط هذا المتغير على False. وفي مثال "الأدوار"، سيتم تعيينها إلى اسم المطالبة الطويلة "http://schemas.microsoft.com/ws/2008/06/identity/claims/role"؛.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true أو false. القيمة الافتراضية هي false. عند التعيين إلى true، يزيل WWW-Authenticate رأس استجابة HTTP من استجابات HTTP 401 التي تم إنشاؤها بواسطة الوحدة النمطية. تم تصميم إعداد التطبيق هذا للاستخدام مع تجربة تكوين V1 (الكلاسيكية). في حالة استخدام مخطط تكوين مصادقة V2، يجب عليك بدلا من ذلك استخدام قيمة التكوين identityProviders.azureActiveDirectory.login.disableWwwAuthenticate .
WEBSITE_AUTH_STATE_DIRECTORY مسار دليل نظام الملفات المحلي حيث يتم تخزين الرموز المميزة عند تمكين مخزن الرموز المميزة المستند إلى الملف. القيمة الافتراضية هي %HOME%\Data\.auth. تم تصميم إعداد التطبيق هذا للاستخدام مع تجربة تكوين V1 (الكلاسيكية). في حالة استخدام مخطط تكوين مصادقة V2، يجب عليك بدلا من ذلك استخدام قيمة التكوين login.tokenStore.fileSystem.directory .
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL عنوان URL لحاوية blob مؤهل بالكامل. يرشد وحدة المصادقة لتخزين وتحميل كافة الرموز المميزة المشفرة إلى حاوية تخزين blob المحددة بدلا من استخدام نظام الملفات المحلي الافتراضي.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS أي رقم عشري موجب. القيمة الافتراضية هي 72 (ساعات). يتحكم هذا الإعداد في مقدار الوقت بعد انتهاء صلاحية الرمز المميز للجلسة /.auth/refresh بحيث يمكن استخدام واجهة برمجة التطبيقات لتحديثه. إنه مخصص بشكل أساسي للاستخدام مع تطبيقات Azure Mobile ، والتي تعتمد على الرموز المميزة للجلسة. ستفشل محاولات التحديث بعد هذه الفترة وسيطلب من المستخدمين النهائيين تسجيل الدخول مرة أخرى. تم تصميم إعداد التطبيق هذا للاستخدام مع تجربة تكوين V1 (الكلاسيكية). في حالة استخدام مخطط تكوين مصادقة V2، يجب عليك بدلا من ذلك استخدام قيمة التكوين login.tokenStore.tokenRefreshExtensionHours .
WEBSITE_AUTH_TRACE_LEVEL يتحكم في إسهاب آثار المصادقة المكتوبة إلى تسجيل التطبيق. القيم الصالحة هي Off، ، ، Warning، ErrorInformationو Verbose. القيمة الافتراضية هي Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true أو false. القيمة الافتراضية هي true. يجب ألا يتم تعيين هذه القيمة أبدا إلا false عند تصحيح أخطاء حالات فشل التحقق من صحة nonce المشفرة مؤقتا التي تحدث أثناء عمليات تسجيل الدخول التفاعلية. تم تصميم إعداد التطبيق هذا للاستخدام مع تجربة تكوين V1 (الكلاسيكية). في حالة استخدام مخطط تكوين مصادقة V2، يجب عليك بدلا من ذلك استخدام قيمة التكوين login.nonce.validateNonce .
WEBSITE_AUTH_V2_CONFIG_JSON يتم تعبئة متغير البيئة هذا تلقائيا بواسطة النظام الأساسي لخدمة تطبيقات Azure ويستخدم لتكوين وحدة المصادقة المتكاملة. تتوافق قيمة متغير البيئة هذا مع تكوين مصادقة V2 (غير الكلاسيكي) للتطبيق الحالي في Azure Resource Manager. ليس المقصود أن يتم تكوينه صراحة.
WEBSITE_AUTH_ENABLED غير قابلة للتعديل. يتم حقنه في تطبيق Windows أو Linux للإشارة إلى ما إذا كانت مصادقة خدمة التطبيق ممكنة أم لا.
WEBSITE_AUTH_ENCRYPTION_KEY بشكل افتراضي، يتم استخدام المفتاح الذي يتم إنشاؤه تلقائيا كمفتاح تشفير. للتجاوز، اضبط على المفتاح المطلوب. يوصى بذلك إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل الإعداد MACHINEKEY_DecryptionKey .
WEBSITE_AUTH_SIGNING_KEY بشكل افتراضي، يتم استخدام المفتاح الذي يتم إنشاؤه تلقائيا كمفتاح توقيع. للتجاوز، اضبط على المفتاح المطلوب. يوصى بذلك إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل الإعداد MACHINEKEY_ValidationKey .

الهوية المُدارة

ترتبط متغيرات البيئة التالية بالهويات المدارة.

اسم الإعداد الوصف
IDENTITY_ENDPOINT غير قابلة للتعديل. عنوان URL لاسترداد الرمز المميز للهوية المدارة للتطبيق.
MSI_ENDPOINT مهملة. استخدم IDENTITY_ENDPOINT.
IDENTITY_HEADER غير قابلة للتعديل. القيمة التي يجب إضافتها إلى الرأس عند تقديم طلب HTTP GET إلى X-IDENTITY-HEADERIDENTITY_ENDPOINT. يتم تدوير القيمة بواسطة النظام الأساسي.
MSI_SECRET مهملة. استخدم IDENTITY_HEADER.

فحص الحالة

ترتبط متغيرات البيئة التالية بالفحوصات الصحية.

اسم الإعداد الوصف
WEBSITE_HEALTHCHECK_MAXPINGFAILURES الحد الأقصى لعدد الأصوات الفاشلة قبل إزالة المثيل. تعيين إلى قيمة بين 2 و 100. عندما تقوم بتوسيع نطاق العمل أو تصغيره، تقوم خدمة التطبيقات باختبار مسار التحقق من الصحة للتأكد من جاهزية المثيلات الجديدة. لمزيد من المعلومات، راجع الفحص الصحي.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT لتجنب الحالات الصحية الساحقة ، لن يتم استبعاد أكثر من نصف الحالات. على سبيل المثال، إذا تم توسيع نطاق خطة خدمة التطبيق إلى أربع مثيلات وكانت ثلاث منها غير صحية، استبعاد مثيلين على الأكثر. وستستمر الحالتان الأخريان (إحداهما صحية والأخرى غير صحية) في تلقي الطلبات. في أسوأ السيناريوهات حيث تكون جميع الحالات غير صحية ، لن يتم استبعاد أي منها. لتجاوز هذا السلوك، قم بتعيينه إلى قيمة بين 0 و 100. تعني القيمة الأعلى أنه ستتم إزالة المزيد من الحالات غير الصحية. الافتراضي هو 50 (50٪).

الإعلامات

ترتبط متغيرات البيئة التالية بميزة الإعلامات المباشرة .

اسم الإعداد الوصف
WEBSITE_PUSH_ENABLED غير قابلة للتعديل. تتم إضافتها عند تمكين الإشعارات الفورية.
WEBSITE_PUSH_TAG_WHITELIST غير قابلة للتعديل. يحتوي على العلامات الموجودة في تسجيل الإشعار.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH غير قابلة للتعديل. يحتوي على قائمة بالعلامات في تسجيل الإعلام الذي يتطلب مصادقة المستخدم.
WEBSITE_PUSH_TAGS_DYNAMIC غير قابلة للتعديل. يحتوي على قائمة بالعلامات في تسجيل الإشعارات التي تمت إضافتها تلقائيا.

ملاحظة

تحتوي هذه المقالة على مراجع لمصطلح «القائمة البيضاء» وهو مصطلح لم تعد Microsoft تستخدمه. عند إزالة المصطلح من البرنامج، سنزيله من هذه المقالة.

وظائف الويب

ترتبط متغيرات البيئة التالية ب WebJobs.

اسم الإعداد الوصف
WEBJOBS_RESTART_TIME بالنسبة للوظائف المستمرة ، قم بالتأخير في ثوان عندما تتعطل عملية الوظيفة لأي سبب من الأسباب قبل إعادة تشغيلها.
WEBJOBS_IDLE_TIMEOUT بالنسبة للمهام التي تم تشغيلها ، فإن المهلة في ثوان ، وبعد ذلك يتم إحباط المهمة إذا كانت في وضع الخمول ، ليس لها وقت أو إخراج وحدة المعالجة المركزية.
WEBJOBS_HISTORY_SIZE بالنسبة للمهام التي تم تشغيلها، يتم الاحتفاظ بالحد الأقصى لعدد عمليات التشغيل في دليل المحفوظات لكل وظيفة. الافتراضي هو 50.
WEBJOBS_STOPPED قم بالتعيين لتعطيل 1 تشغيل أي وظيفة، وإيقاف جميع المهام قيد التشغيل حاليا.
WEBJOBS_DISABLE_SCHEDULE اضبط على 1 إيقاف تشغيل جميع عمليات التشغيل المجدولة. لا يزال من الممكن استدعاء الوظائف يدويا.
WEBJOBS_ROOT_PATH المسار المطلق أو النسبي لملفات webjob. بالنسبة للمسار النسبي، يتم دمج القيمة مع مسار الجذر الافتراضي (D:/home/site/wwwroot/ أو /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS قم بالتعيين إلى true لإرسال الإخراج من WebJobs الذي تم تشغيله إلى خط أنابيب سجلات التطبيق (الذي يدعم نظام الملفات والنقاط والجداول).
WEBJOBS_SHUTDOWN_FILE الملف الذي تقوم خدمة التطبيقات بإنشائه عند اكتشاف طلب إيقاف تشغيل. تقع على عاتق عملية مهمة الويب مسؤولية اكتشاف وجود هذا الملف وبدء إيقاف التشغيل. عند استخدام WebJobs SDK، تتم معالجة هذا الجزء تلقائيا.
WEBJOBS_PATH غير قابلة للتعديل. مسار الجذر للمهمة قيد التشغيل حاليا (سيكون تحت بعض الدليل المؤقت).
WEBJOBS_NAME غير قابلة للتعديل. اسم الوظيفة الحالي.
WEBJOBS_TYPE غير قابلة للتعديل. نوع الوظيفة الحالية (triggered أو continuous).
WEBJOBS_DATA_PATH غير قابلة للتعديل. مسار بيانات تعريف الوظيفة الحالي لاحتواء سجلات الوظيفة وتاريخها وأي قطعة أثرية للوظيفة.
WEBJOBS_RUN_ID غير قابلة للتعديل. بالنسبة للوظائف التي تم تشغيلها، معرف التشغيل الحالي للوظيفة.

الوظائف

اسم الإعداد الوصف
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED اضبط على 0 تعطيل ذاكرة التخزين المؤقت للوظائف.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT مرجع إعدادات التطبيق لـ Azure Functions
FUNCTIONS_EXTENSION_VERSION مرجع إعدادات التطبيق لـ Azure Functions
AzureWebJobsSecretStorageType مرجع إعدادات التطبيق لـ Azure Functions
FUNCTIONS_WORKER_RUNTIME مرجع إعدادات التطبيق لـ Azure Functions
AzureWebJobsStorage مرجع إعدادات التطبيق لـ Azure Functions
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING مرجع إعدادات التطبيق لـ Azure Functions
WEBSITE_CONTENTSHARE مرجع إعدادات التطبيق لـ Azure Functions
WEBSITE_CONTENTOVERVNET مرجع إعدادات التطبيق لـ Azure Functions
WEBSITE_ENABLE_BROTLI_ENCODING مرجع إعدادات التطبيق لـ Azure Functions
WEBSITE_USE_PLACEHOLDER اضبط على 0 تعطيل تحسين وظائف العنصر النائب في خطة الاستهلاك. العنصر النائب هو تحسين يحسن البداية الباردة.
WEBSITE_PLACEHOLDER_MODE غير قابلة للتعديل. إظهار ما إذا كان تطبيق الدالة قيد التشغيل على مضيف عنصر نائب () أو مضيفه الخاص (generalizedspecialized).
WEBSITE_DISABLE_ZIP_CACHE عند تشغيل تطبيقك من حزمة ZIP ( )، يتم تخزين حزم ZIP الخمس التي تم نشرها مؤخرا مؤقتا في نظام ملفات التطبيق ( WEBSITE_RUN_FROM_PACKAGE=1D:\home\data\SitePackages). قم بتعيين هذا المتغير لتعطيل 1 ذاكرة التخزين المؤقت هذه. بالنسبة لتطبيقات استهلاك Linux، يتم تعطيل ذاكرة التخزين المؤقت لحزمة ZIP افتراضيا.