إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في 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 بشكل افتراضي. |