مشاركة عبر


متغيرات البيئة وإعدادات التطبيق في 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 لتسخين التطبيق، بدءا من شرطة مائلة. الإعداد الافتراضي هو /robots933456.txt.

كلما بدأ النظام الأساسي في تشغيل حاوية، يقوم المنسق بإجراء طلبات متكررة مقابل نقطة النهاية هذه. يعتبر النظام الأساسي أي استجابة من نقطة النهاية هذه إشارة إلى أن الحاوية جاهزة. عندما يعتبر النظام الأساسي الحاوية جاهزة، فإنه يبدأ في إعادة توجيه حركة المرور العضوية إلى الحاوية التي بدأت حديثا. ما لم WEBSITE_WARMUP_STATUSES يتم تكوينه، يعتبر النظام الأساسي أي استجابة من الحاوية في نقطة النهاية هذه (حتى رموز الخطأ مثل 404 أو 502) إشارة إلى أن الحاوية جاهزة.

لا يغير إعداد التطبيق هذا المسار الذي يستخدمه Always On.
WEBSITE_WARMUP_STATUSES قائمة محددة بفاصلة برموز حالة HTTP التي تعتبر ناجحة عندما يقوم النظام الأساسي بإجراء عمليات ping التجهيز مقابل حاوية تم بدء تشغيلها حديثا. يستخدم مع WEBSITE_WARMUP_PATH.

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

مثال على ذلك 200,202 . إذا تلقت pings مقابل مسار التجهيز المكون للتطبيق استجابة برمز حالة 200 أو 202، يتم توجيه حركة المرور العضوية إلى الحاوية. إذا تم تلقي رمز حالة غير موجود في القائمة (مثل 502)، يستمر النظام الأساسي في إجراء عمليات اختبار الاتصال حتى يتم تلقي 200 أو 202، أو حتى يتم الوصول إلى حد مهلة بدء تشغيل الحاوية. (انظر WEBSITES_CONTAINER_START_TIME_LIMIT لاحقا في هذا الجدول.)

إذا لم تستجب الحاوية برمز حالة HTTP الموجود في القائمة، فإن النظام الأساسي يفشل في النهاية في محاولة بدء التشغيل ويعيد المحاولة، ما يؤدي إلى 503 أخطاء.
WEBSITE_COMPUTE_MODE للقراءة فقط. يحدد ما إذا كان التطبيق يعمل على أجهزة ظاهرية مخصصة (Dedicated) أو مشتركة (Shared) (VMs).
WEBSITE_SKU للقراءة فقط. مستوى التسعير للتطبيق. القيم المحتملة هي Freeو SharedBasicو و.Standard
SITE_BITNESS للقراءة فقط. يوضح ما إذا كان التطبيق 32 بت (x86) أو 64 بت (AMD64).
WEBSITE_HOSTNAME للقراءة فقط. اسم المضيف الأساسي للتطبيق. لا يمثل هذا الإعداد أسماء المضيفين المخصصة.
WEBSITE_VOLUME_TYPE للقراءة فقط. إظهار نوع وحدة تخزين التخزين قيد الاستخدام حاليا.
WEBSITE_NPM_DEFAULT_VERSION إصدار npm الافتراضي الذي يستخدمه التطبيق.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT للقراءة فقط. الحد لطلبات WebSocket المتزامنة. بالنسبة للطبقة Standard وأعلى، القيمة هي -1، ولكن لا يزال هناك حد لكل جهاز ظاهري استنادا إلى حجم الجهاز الظاهري الخاص بك. راجع الحدود الرقمية عبر الأجهزة الظاهرية.
WEBSITE_PRIVATE_EXTENSIONS قم بتعيين إلى 0 لتعطيل استخدام ملحقات الموقع الخاص.
WEBSITE_TIME_ZONE بشكل افتراضي، تكون المنطقة الزمنية للتطبيق دائما UTC. يمكنك تغييره إلى أي من القيم الصالحة المدرجة في المناطق الزمنية الافتراضية. إذا لم يتم التعرف على القيمة المحددة، يستخدم التطبيق التوقيت العالمي المتفق عليه.

على سبيل المثال:Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG بعد تبديل الفتحات، قد يواجه التطبيق عمليات إعادة تشغيل غير متوقعة. والسبب هو أنه بعد التبديل، يخرج تكوين ربط اسم المضيف عن المزامنة، والذي في حد ذاته لا يسبب إعادة التشغيل. ومع ذلك، قد تكتشف بعض أحداث التخزين الأساسية (مثل تجاوزات فشل وحدة التخزين) هذه التناقضات وتجبر جميع عمليات العامل على إعادة التشغيل.

لتقليل هذه الأنواع من عمليات إعادة التشغيل، قم بتعيين قيمة إعداد التطبيق إلى 1 على جميع الفتحات. (الافتراضي هو 0.) ولكن لا تقم بتعيين هذه القيمة إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation. لمزيد من المعلومات، راجع استكشاف أخطاء التبديل وإصلاحها.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED بشكل افتراضي، يتم تصحيح مثيل الجهاز الظاهري بشكل استباقي عندما يستخدم أكثر من 90% من الذاكرة المخصصة لأكثر من 30 ثانية، أو عندما يستغرق 80% من إجمالي الطلبات في الدقيقتين الأخيرتين أكثر من 200 ثانية. إذا كان مثيل الجهاز الظاهري يشغل إحدى هذه القواعد، فإن عملية الاسترداد هي إعادة تشغيل متداخلة للمثيل.

قم بتعيين إلى false لتعطيل سلوك الاسترداد هذا. الإعداد الافتراضي هو true.

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

قم بتعيين إلى false لتعطيل سلوك المراقبة التلقائية هذا. الإعداد الافتراضي هو true.

لمزيد من المعلومات، راجع منشور مدونة مراقبة الأعطال الاستباقية في Azure App Service .
WEBSITE_DAAS_STORAGE_SASURI أثناء مراقبة الأعطال (استباقية أو يدوية)، يتم حذف تفريغ الذاكرة بشكل افتراضي. لحفظ تفريغ الذاكرة في حاوية كائن ثنائي كبير الحجم للتخزين، حدد عنوان URI لتوقيع الوصول المشترك (SAS).
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 بشكل افتراضي، تنشئ App Service مساحة تخزين مشتركة لك عند إنشاء التطبيق. لاستخدام حساب تخزين مخصص بدلا من ذلك، قم بتعيين إلى سلسلة الاتصال لحساب التخزين الخاص بك. للحصول على الوظائف، راجع مرجع إعدادات التطبيق لوظائف Azure.

على سبيل المثال:DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE عند استخدام تحديد حساب تخزين مخصص مع WEBSITE_CONTENTAZUREFILECONNECTIONSTRING، تنشئ App Service مشاركة ملف في حساب التخزين هذا لتطبيقك. لاستخدام اسم مخصص، قم بتعيين هذا المتغير إلى الاسم الذي تريده. إذا لم تكن مشاركة ملف بالاسم المحدد موجودة، تقوم App Service بإنشائها لك.

على سبيل المثال:myapp123
WEBSITE_BYOS_BLOB_DIRECT_IO تم ضبطه على false الوضع الافتراضي. إذا تم تفعيله، سترسل جميع المعاملات استعلاما مباشرة من التخزين البعيد وسيتم تجاوز التخزين المؤقت. يتم تطبيق هذا الإعداد على مستوى التطبيق وبالتالي يؤثر على جميع مشاركات الكتلة التي يقوم التطبيق بتركيبها.

هذا ينطبق فقط عند استخدام Azure Blob Storage المثبت مخصصا. ينطبق على حاويات لينكس فقط (وليس ينطبق على ويندوز).
WEBSITE_SCM_ALWAYS_ON_ENABLED للقراءة فقط. إظهار ما إذا كان Always On ممكنا (1) أم لا (0).
WEBSITE_SCM_SEPARATE_STATUS للقراءة فقط. يوضح ما إذا كان تطبيق Kudu قيد التشغيل في عملية منفصلة (1) أم لا (0).
WEBSITE_DNS_ATTEMPTS عدد المرات التي يجب فيها تجربة تحليل الاسم.
WEBSITE_DNS_TIMEOUT عدد الثوان التي يجب انتظارها لتحليل الاسم.
WEBSITES_CONTAINER_START_TIME_LIMIT مقدار الوقت (بالثوان) الذي ينتظره النظام الأساسي حتى تصبح الحاوية جاهزة عند بدء التشغيل. ينطبق هذا الإعداد على كل من التطبيقات المستندة إلى التعليمات البرمجية والتطبيقات المستندة إلى الحاوية على App Service لنظام التشغيل Linux. القيمة الافتراضية هي 230.

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

بالنسبة إلى App Service لحاويات Windows، يكون حد وقت البدء الافتراضي هو 10 mins. يمكنك تغيير حد وقت البدء عن طريق تحديد فترة زمنية. على سبيل المثال، 00:05:00 يشير إلى 5 دقائق.

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

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

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

نشر

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

اسم الإعداد ‏‏الوصف‬
DEPLOYMENT_BRANCH لنشر Git المحلي أو Cloud Git (مثل GitHub)، قم بتعيين إلى الفرع في Azure الذي تريد النشر إليه. بشكل افتراضي، يكون master.
WEBSITE_RUN_FROM_PACKAGE اضبط على 1 لتشغيل التطبيق من حزمة ZIP محلية، أو اضبط على عنوان URL خارجي لتشغيل التطبيق من حزمة ZIP بعيدة. لمزيد من المعلومات، راجع تشغيل تطبيقك في Azure App Service مباشرة من حزمة ZIP.
WEBSITE_USE_ZIP ‏‏مهمل. استخدم WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP ‏‏مهمل. استخدم WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT يحتفظ تطبيقك بخمسة من أحدث ملفات ZIP المنشورة عبر توزيع ZIP. يمكنك الاحتفاظ بأكثر أو أقل عن طريق تغيير إعداد التطبيق إلى رقم مختلف.
WEBSITE_WEBDEPLOY_USE_SCM قم بتعيين إلى false ل Web Deploy للتوقف عن استخدام محرك توزيع Kudu. الإعداد الافتراضي هو true. للنشر إلى تطبيقات Linux باستخدام Visual Studio (Web Deploy/MSDeploy)، قم بتعيينه إلى false.
MSDEPLOY_RENAME_LOCKED_FILES قم بتعيين إلى 1 لمحاولة إعادة تسمية DLLs إذا تعذر نسخها أثناء نشر نشر ويب. لا ينطبق هذا الإعداد إذا WEBSITE_WEBDEPLOY_USE_SCM تم تعيينه إلى false.
WEBSITE_DISABLE_SCM_SEPARATION بشكل افتراضي، يتم تشغيل التطبيق الرئيسي والتطبيق Kudu في بيئات الاختبار المعزولة المختلفة. عند إيقاف التطبيق، لا يزال تطبيق Kudu قيد التشغيل، ويمكنك الاستمرار في استخدام نشر Git وMSDeploy. يحتوي كل تطبيق على ملفات محلية خاصة به. يعد إيقاف تشغيل هذا الفصل (الإعداد إلى true) وضعا قديما لم يعد مدعوما بالكامل.
WEBSITE_ENABLE_SYNC_UPDATE_SITE قم بتعيين للتأكد 1 من أن استدعاءات واجهة برمجة تطبيقات REST للتحديث site وتطبيقها siteconfig بالكامل على جميع المثيلات قبل العودة. الإعداد الافتراضي هو 1 إذا كنت تقوم بالنشر باستخدام قالب Azure Resource Manager (قالب ARM)، لتجنب حالات السباق مع استدعاءات Resource Manager اللاحقة.
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 يستخدم azure site deploymentscript Kudu الأمر لإنشاء برنامج نصي للتوزيع. يكتشف تلقائيا نوع إطار عمل اللغة ويحدد المعلمات لتمريرها إلى الأمر . يتجاوز هذا الإعداد المعلمات التي تم إنشاؤها تلقائيا.

على سبيل المثال، للتعامل مع المستودع الخاص بك كملفات محتوى عادي: --basic -p <folder-to-deploy>.
SCM_TRACE_LEVEL إنشاء مستوى التتبع. الإعداد الافتراضي هو 1. اضبط على قيم أعلى، حتى 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_MODE يكون Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES المهلة، بالدقائق، لموقع إدارة التحكم بالمصادر (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 تطبيقات Linux فقط. بشكل افتراضي، يتم تشغيل التطبيق من /home/site/wwwroot، وهو دليل مشترك لجميع المثيلات التي تم توسيع نطاقها. قم بتعيين هذا المتغير إلى true لنسخ التطبيق إلى دليل محلي في الحاوية الخاصة بك وتشغيله من هناك. عند استخدام هذا الخيار، تأكد من عدم ترميز أي مرجع إلى /home/site/wwwroot. بدلا من ذلك، استخدم مسارا بالنسبة إلى /home/site/wwwroot.
MACHINEKEY_Decryption بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows المضمنة في حاويات، يتم إدخال هذا المتغير في بيئة تطبيق أو حاوية لتمكين إجراءات التشفير ASP.NET. (راجع عنصر machineKey.) لتجاوز القيمة الافتراضية decryption ، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر Web.config الملف.
MACHINEKEY_DecryptionKey بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows المضمنة في حاويات، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET. (راجع عنصر machineKey.) لتجاوز القيمة التي تم decryptionKey إنشاؤها تلقائيا، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر Web.config الملف.
MACHINEKEY_Validation بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows المضمنة في حاويات، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET. (راجع عنصر machineKey.) لتجاوز القيمة الافتراضية validation ، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر Web.config الملف.
MACHINEKEY_ValidationKey بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows المضمنة في حاويات، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات التشفير ASP.NET. (راجع عنصر machineKey.) لتجاوز القيمة التي تم validationKey إنشاؤها تلقائيا، قم بتكوينها كإعداد تطبيق App Service، أو قم بتعيينها مباشرة في machineKey عنصر Web.config الملف.

WordPress

إعداد التطبيق النطاق قيمة الحد الأقصى ‏‏الوصف‬
WEBSITES_ENABLE_APP_SERVICE_STORAGE تطبيق الويب true ‏‫غير قابل للتطبيق‬ عند التعيين إلى true، يتم الاحتفاظ بمحتويات الملف أثناء إعادة التشغيل.
WP_MEMORY_LIMIT WordPress 128M 512M حد ذاكرة WordPress PHP للواجهة الأمامية أو العامة (لكل برنامج نصي). لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT.
WP_MAX_MEMORY_LIMIT WordPress 256M 512M حد ذاكرة PHP للوحة معلومات المسؤول (لكل برنامج نصي). بشكل عام، تأخذ لوحة معلومات المسؤول والبرامج النصية الخلفية الكثير من الذاكرة مقارنة بالنصوص الأمامية. لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512M 512M حد الذاكرة لنصوص PHP العامة. يمكن تقليله فقط.
FILE_UPLOADS PHP On ‏‫غير قابل للتطبيق‬ تمكين تحميلات الملفات أو تعطيلها. يمكن أن يكون إما On أو Off. لاحظ أن القيم حساسة لحالة الأحرف.
UPLOAD_MAX_FILESIZE PHP 50M 256M حد الحجم لتحميل الملف. يمكن زيادته حتى 256M.
POST_MAX_SIZE PHP 128M 256M يمكن زيادته حتى 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 قاعدة البيانات ‏‫غير قابل للتطبيق‬ ‏‫غير قابل للتطبيق‬ كلمة مرور قاعدة البيانات المستخدمة للاتصال بقاعدة بيانات MySQL. لتغيير كلمة مرور قاعدة بيانات MySQL، راجع تحديث كلمة مرور المسؤول. كلما تم تغيير كلمة مرور قاعدة بيانات MySQL، تحتاج إعدادات التطبيق أيضا إلى تحديث.
WORDPRESS_ADMIN_EMAIL النشر فقط ‏‫غير قابل للتطبيق‬ ‏‫غير قابل للتطبيق‬ البريد الإلكتروني لمسؤول WordPress.
WORDPRESS_ADMIN_PASSWORD النشر فقط ‏‫غير قابل للتطبيق‬ ‏‫غير قابل للتطبيق‬ كلمة مرور مسؤول WordPress. هذا الإعداد مخصص فقط لأغراض النشر. لا يؤثر تعديل هذه القيمة على تثبيت WordPress. لتغيير كلمة مرور مسؤول WordPress، راجع إعادة تعيين كلمة المرور.
WORDPRESS_ADMIN_USER النشر فقط ‏‫غير قابل للتطبيق‬ ‏‫غير قابل للتطبيق‬ اسم مستخدم مسؤول WordPress.
WORDPRESS_ADMIN_LOCALE_CODE النشر فقط ‏‫غير قابل للتطبيق‬ ‏‫غير قابل للتطبيق‬ اسم مستخدم قاعدة البيانات المستخدم للاتصال ب WordPress.

المجال وDNS

اسم الإعداد ‏‏الوصف‬
WEBSITE_DNS_SERVER عنوان IP لخادم DNS الأساسي للاتصالات الصادرة (مثل خدمة خلفية). خادم DNS الافتراضي لخدمة التطبيقات هو Azure DNS، عنوان IP الخاص به هو 168.63.129.16. إذا كان تطبيقك يستخدم تكامل الشبكة الظاهرية أو كان في بيئة App Service، فإنه يرث تكوين خادم DNS من الشبكة الظاهرية بشكل افتراضي.

على سبيل المثال:10.0.0.1
WEBSITE_DNS_ALT_SERVER عنوان IP لخادم DNS الاحتياطي للاتصالات الصادرة. راجع WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE يسمح بتخزين دقة DNS الناجحة مؤقتا. بشكل افتراضي، يتم مسح إدخالات ذاكرة التخزين المؤقت DNS منتهية الصلاحية (بالإضافة إلى ذاكرة التخزين المؤقت الموجودة) كل 4.5 دقائق.

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_OVERRIDE_STICKY_EXTENSION_VERSIONS بشكل افتراضي، تكون إصدارات ملحقات الموقع خاصة بكل فتحة. يمنع هذا الافتراضي سلوك التطبيق غير المتوقع بسبب تغيير إصدارات الملحق بعد التبديل. إذا كنت تريد تبديل إصدارات الملحق أيضا، فقم بتعيين إلى 0 على جميع الفتحات.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS تعيين إعدادات معينة كإعدادات ملصقة أو غير قابلة للتبديل بشكل افتراضي. القيمة الافتراضية هي true. قم بتعيين هذه القيمة إلى false أو 0لكافة فتحات النشر لجعلها قابلة للتبديل بدلا من ذلك. لا يوجد تحكم دقيق في أنواع الإعدادات المحددة.
WEBSITE_SWAP_WARMUP_PING_PATH مسار اختبار اتصال لتسخين الفتحة الهدف في المبادلة، بدءا من شرطة مائلة. الافتراضي هو /، الذي يقوم ب pings المسار الجذر عبر 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 تم تحديثه بأسماء المضيفين المبدلة للفتحات، فقم بتعيين هذا المتغير true لتجنب إعادة التشغيل من هذا النوع. إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation، فلا تقم بتعيين هذا المتغير.

حاويات مخصصة

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

اسم الإعداد ‏‏الوصف‬
WEBSITES_ENABLE_APP_SERVICE_STORAGE بالنسبة لحاويات Linux، إذا لم يتم تحديد إعداد التطبيق هذا، /home تتم مشاركة الدليل عبر مثيلات موسعة بشكل افتراضي. يمكنك تعيينه إلى false لتعطيل المشاركة.

بالنسبة لحاويات Windows، قم بتعيين إلى true لتمكين c:\home الدليل ليتم مشاركته عبر مثيلات ذات مقياس. الإعداد الافتراضي هو true لحاويات Windows.
WEBSITES_CONTAINER_STOP_TIME_LIMIT مقدار الوقت، بالثوان، لانتظار انتهاء الحاوية بأمان. القيمة الافتراضية هي 5. يمكنك الزيادة إلى الحد الأقصى من 120.
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 الاتصال والسحب من سجل داخل شبكة ظاهرية أو محلية. يجب أن يكون تطبيقك متصلا بشبكة ظاهرية من خلال ميزة تكامل الشبكة الظاهرية. هذا الإعداد مطلوب أيضا ل Azure Container Registry مع نقطة نهاية خاصة.
WEBSITES_WEB_CONTAINER_NAME في تطبيق Docker Compose، يمكن الوصول إلى شبكة إنترنت واحدة فقط من الحاويات. قم بتعيين إلى اسم الحاوية المعرفة في ملف التكوين لتجاوز تحديد الحاوية الافتراضي. بشكل افتراضي، الحاوية التي يمكن الوصول إليها عبر الإنترنت هي الحاوية الأولى التي تحدد المنفذ 80 أو 8080. عند عدم العثور على مثل هذه الحاوية، يكون الافتراضي هو الحاوية الأولى المعرفة في ملف التكوين.
WEBSITES_PORT بالنسبة لحاوية مخصصة، رقم المنفذ المخصص على الحاوية لخدمة التطبيقات لتوجيه الطلبات إليها. بشكل افتراضي، تحاول App Service الكشف التلقائي عن المنفذين 80 و8080. لا يتم إدخال هذا الإعداد في الحاوية كمتغير بيئة.
WEBSITE_CPU_CORES_LIMIT بشكل افتراضي، يتم تشغيل حاوية Windows مع جميع الذاكرات الأساسية المتوفرة لمستوى التسعير الذي اخترته. لتقليل عدد الذاكرات الأساسية، قم بتعيين حد لعدد الذاكرات الأساسية المطلوبة. لمزيد من المعلومات، راجع تخصيص عدد الذاكرات الأساسية للحساب.
WEBSITE_MEMORY_LIMIT_MB بشكل افتراضي، تحتوي جميع حاويات Windows المنشورة في App Service على حد ذاكرة تم تكوينه، اعتمادا على مستوى خطة App Service. تعيين إلى حد الذاكرة المطلوب بالميغابايت. يجب ألا يتجاوز الإجمالي التراكمي لهذا الإعداد عبر التطبيقات في نفس الخطة المبلغ الذي يسمح به مستوى التسعير المختار. لمزيد من المعلومات، راجع تخصيص ذاكرة الحاوية.

تغير الحجم

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

تسجيل الدخول

اسم الإعداد ‏‏الوصف‬
WEBSITE_HTTPLOGGING_ENABLED للقراءة فقط. يوضح ما إذا كان تسجيل خادم الويب لتطبيقات Windows الأصلية ممكنا (1) أم لا (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS فترة الاستبقاء (بالأيام) لسجلات خادم الويب، إذا تم تمكين سجلات خادم الويب لتطبيق Windows أو Linux أصلي.

على سبيل المثال:10
WEBSITE_HTTPLOGGING_CONTAINER_URL عنوان URL SAS لحاوية تخزين الكائن الثنائي كبير الحجم لتخزين سجلات خادم الويب لتطبيقات Windows الأصلية، إذا تم تمكين سجلات خادم الويب. إذا لم يتم تعيينه، يتم تخزين سجلات خادم الويب في نظام ملفات التطبيق (التخزين المشترك الافتراضي).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS فترة الاستبقاء (بالأيام) لسجلات التطبيقات لتطبيقات Windows الأصلية، إذا تم تمكين سجلات التطبيق.

على سبيل المثال:10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL عنوان URL SAS لحاوية تخزين الكائن الثنائي كبير الحجم لتخزين سجلات التطبيقات لتطبيقات 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 الذي يحتوي على عدادات أداء ASP.NET.
WEBSITE_COUNTERS_APP كائن JSON الذي يحتوي على عدادات بيئة الاختبار المعزولة.
WEBSITE_COUNTERS_CLR كائن JSON الذي يحتوي على عدادات وقت تشغيل اللغة الشائعة.
WEBSITE_COUNTERS_ALL كائن JSON الذي يحتوي على مجموعة المتغيرات الثلاثة الأخرى.

التخزين المؤقت

اسم الإعداد ‏‏الوصف‬
WEBSITE_LOCAL_CACHE_OPTION ما إذا كانت ذاكرة التخزين المؤقت المحلية ممكنة. الخيارات المتوفرة هي:

- Default: وراثة الإعداد العمومي على مستوى الطابع.
- Always: تمكين للتطبيق.
- OnStorageUnavailability
- 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.

بالنسبة لتطبيقات Windows وتطبيقات Linux التي تم إنشاؤها باستخدام قالب WordPress، الافتراضي هو 1. بالنسبة لجميع تطبيقات Linux الأخرى، الافتراضي هو 0.
WEBSITE_READONLY_APP عند استخدام ذاكرة تخزين مؤقت ديناميكية، يمكنك تعطيل الوصول للكتابة إلى جذر التطبيق (D:\home\site\wwwroot أو /home/site/wwwroot) عن طريق تعيين هذا المتغير إلى 1. App_Data باستثناء الدليل، لا يسمح بتأمين حصري بحيث لا تحظر الملفات المؤمنة عمليات النشر.

الشبكات

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

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

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

مراجع خزنة المفاتيح

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

اسم الإعداد ‏‏الوصف‬
WEBSITE_KEYVAULT_REFERENCES للقراءة فقط. يحتوي على معلومات (بما في ذلك الحالات) لجميع مراجع خزنة المفاتيح التي تم تكوينها حاليا في التطبيق.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION إذا قمت بتعيين اتصال التخزين المشترك لتطبيقك (باستخدام WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) إلى مرجع خزنة المفاتيح، فلن يتمكن التطبيق من حل مرجع خزنة المفاتيح عند إنشاء التطبيق أو تحديثه إذا كان أحد الشروط التالية صحيحا:

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

لتجنب الأخطاء في وقت الإنشاء أو التحديث، قم بتعيين هذا المتغير إلى 1.
WEBSITE_DELAY_CERT_DELETION يؤدي تعيين متغير البيئة هذا إلى 1 ضمان عدم حذف شهادة تعتمد عليها عملية العامل حتى يتم الخروج منها.

كورس

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

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

المصادقة والتخويل

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

اسم الإعداد ‏‏الوصف‬
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW عند التعيين إلى true، يعطل تعيين هوية مؤشر الترابط الأساسية في ASP. تطبيقات الويب المستندة إلى NET (بما في ذلك تطبيقات الوظائف v1). تسمح هذه الإمكانية للمطورين بحماية الوصول إلى موقعهم من خلال المصادقة، ولكن لا تزال تستخدم آلية تسجيل دخول منفصلة ضمن منطق التطبيق الخاص بهم. الإعداد الافتراضي هو false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true أو false. القيمة الافتراضية هي false. هذا إعداد لتكامل تطبيقات الأجهزة المحمولة القديمة ل Azure App Service. يؤدي تعيين القيمة إلى true حل مشكلة حيث قد يتغير معرف الأمان الذي تم إنشاؤه للمستخدمين المصادق عليهم إذا قام المستخدم بتغيير معلومات ملف التعريف الخاص به.

قد يؤدي تغيير هذه القيمة إلى تغيير معرفات مستخدم 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 المحددة بدلا من استخدام نظام الملفات المحلي الافتراضي.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS أي رقم عشري موجب. القيمة الافتراضية هي 72 (ساعات). يتحكم هذا الإعداد في مقدار الوقت بعد انتهاء صلاحية رمز جلسة العمل الذي /.auth/refresh يمكن استخدام واجهة برمجة التطبيقات لتحديثه. محاولات التحديث بعد فشل هذه الفترة، ويطلب من المستخدمين تسجيل الدخول مرة أخرى.

إعداد التطبيق هذا مخصص للاستخدام مع تجربة التكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلا من ذلك استخدام login.tokenStore.tokenRefreshExtensionHours قيمة التكوين.
WEBSITE_AUTH_TRACE_LEVEL يتحكم في إسهاب تتبعات المصادقة المكتوبة في تسجيل التطبيق. القيم الصالحة هي OffوErrorWarningInformation.Verbose القيمة الافتراضية هي Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true أو false. القيمة الافتراضية هي true. يجب عدم تعيين هذه القيمة إلى false إلا عندما تقوم بتصحيح أخطاء فشل التحقق من صحة التشفير غير المشفرة مؤقتا التي تحدث أثناء عمليات تسجيل الدخول التفاعلية.

إعداد التطبيق هذا مخصص للاستخدام مع تجربة التكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلا من ذلك استخدام login.nonce.validateNonce قيمة التكوين.
WEBSITE_AUTH_V2_CONFIG_JSON تملأ Azure App Service متغير البيئة هذا تلقائيا. يستخدم هذا المتغير لتكوين وحدة المصادقة المتكاملة. تتوافق قيمته مع تكوين المصادقة V2 (غير الكلاسيكي) للتطبيق الحالي في Azure Resource Manager. لا يقصد به تكوينه بشكل صريح.
WEBSITE_AUTH_ENABLED للقراءة فقط. تم إدخاله في تطبيق Windows أو Linux للإشارة إلى ما إذا كانت مصادقة App Service ممكنة.
WEBSITE_AUTH_ENCRYPTION_KEY بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيا كمفتاح تشفير. للتجاوز، قم بتعيين إلى المفتاح المطلوب. نوصي بمتغير البيئة هذا إذا كنت تريد مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا قمت بتحديده، فإنه يحل محل MACHINEKEY_DecryptionKey الإعداد.
WEBSITE_AUTH_SIGNING_KEY بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيا كمفتاح التوقيع. للتجاوز، قم بتعيين إلى المفتاح المطلوب. نوصي بمتغير البيئة هذا إذا كنت تريد مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا قمت بتحديده، فإنه يحل محل MACHINEKEY_ValidationKey الإعداد.
WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES قائمة مفصولة بفواصل من النطاقات التي يحتاجها التطبيق. عند التعيين، يقوم هذا المتغير بتكوين مستند بيانات تعريف مورد محمي افتراضي، والذي يعلن أن النطاقات المحددة مدعومة. يتم تضمين النطاقات أيضا في تحديات المصادقة التي يرجعها التطبيق.

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

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

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

فحص الصحة

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

اسم الإعداد ‏‏الوصف‬
WEBSITE_HEALTHCHECK_MAXPINGFAILURES الحد الأقصى لعدد عمليات ping الفاشلة قبل إزالة المثيل. تعيين إلى قيمة بين 2 و 10. عندما تقوم بالتحجيم أو التصغير، تقوم App Service ب pings مسار التحقق من الصحة للتأكد من أن المثيلات الجديدة جاهزة. لمزيد من المعلومات، راجع التحقق من الصحة.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT لتجنب حدوث حالات صحية هائلة، لا يتم استبعاد أكثر من نصف المثيلات. على سبيل المثال، إذا تم تحجيم خطة App Service إلى أربعة مثيلات وثلاثة غير سليمة، يتم استبعاد اثنين على الأكثر. ولا يزال المثيلان الآخران (أحدهما سليم والآخر غير سليم) يتلقىان الطلبات. في أسوأ سيناريو حيث تكون جميع المثيلات غير صحية، لا يتم استبعاد أي منها.

لتجاوز هذا السلوك، قم بتعيين إلى قيمة بين 1 و 100. تعني القيمة الأعلى إزالة مثيلات أكثر غير صحية. الإعداد الافتراضي هو 50 (50%).

الإعلامات المنبثقة

ترتبط متغيرات البيئة التالية بميزة الإعلامات المنبثقة .

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

إشعار

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

WebJobs

ترتبط متغيرات البيئة التالية ب 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 الملف الذي تقوم App Service بإنشائه عند الكشف عن طلب إيقاف تشغيل. تقع على عاتق عملية WebJob مسؤولية الكشف عن وجود هذا الملف وبدء إيقاف التشغيل. عند استخدام 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.
AzureWebJobsSecretStorageType راجع مرجع إعدادات التطبيق ل Azure Functions.
FUNCTIONS_EXTENSION_VERSION راجع مرجع إعدادات التطبيق ل 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 راجع مرجع إعدادات التطبيق ل Azure Functions.
WEBSITE_PLACEHOLDER_MODE للقراءة فقط. يوضح ما إذا كان تطبيق الوظائف قيد التشغيل على مضيف نائب (generalized) أو مضيفه الخاص (specialized).
WEBSITE_DISABLE_ZIP_CACHE عند تشغيل تطبيقك من حزمة ZIP ( WEBSITE_RUN_FROM_PACKAGE=1)، يتم تخزين حزم ZIP الخمس الأحدث التي تم نشرها مؤقتا في نظام ملفات التطبيق (D:\home\data\SitePackages). قم بتعيين هذا المتغير لتعطيل 1 ذاكرة التخزين المؤقت هذه. بالنسبة لتطبيقات استهلاك Linux، يتم تعطيل ذاكرة التخزين المؤقت لحزمة ZIP بشكل افتراضي.