متغيّرات البيئة وإعدادات التطبيق في Azure App Service
إشعار
بدءا من 1 يونيو 2024، سيكون لجميع تطبيقات App Service التي تم إنشاؤها حديثا خيار إنشاء اسم مضيف افتراضي فريد باستخدام اصطلاح <app-name>-<random-hash>.<region>.azurewebsites.net
التسمية . ستظل أسماء التطبيقات الحالية دون تغيير.
مثال: myapp-ds27dh7271aah175.westus-01.azurewebsites.net
لمزيد من التفاصيل، راجع اسم المضيف الافتراضي الفريد لمورد App Service.
في Azure App Service، تتوفر إعدادات معينة لبيئة التوزيع أو وقت التشغيل كمتغيّرات البيئة. يمكن تخصيص بعض هذه الإعدادات عند تعيينها يدويًا كإعدادات للتطبيق. يوضح هذا المرجع المتغيرات التي يمكنك استخدامها أو تخصيصها.
بيئة التطبيق
ترتبط متغيرات البيئة التالية ببيئة التطبيق بشكل عام.
اسم الإعداد | الوصف | مثال |
---|---|---|
WEBSITE_SITE_NAME |
قراءة فقط. اسم التطبيق. | |
WEBSITE_RESOURCE_GROUP |
قراءة فقط. اسم مجموعة موارد Azure التي تحتوي على مورد التطبيق. | |
WEBSITE_OWNER_NAME |
قراءة فقط. يحتوي على معرّف اشتراك Azure الذي يمتلك التطبيق ومجموعة الموارد ومساحة الويب. | |
REGION_NAME |
قراءة فقط. اسم المنطقة للتطبيق. | |
WEBSITE_PLATFORM_VERSION |
قراءة فقط. إصدار نظام App Service الأساسي. | |
HOME |
قراءة فقط. المسار إلى الدليل الرئيسي (على سبيل المثال، D:\home لنظام التشغيل Windows). |
|
SERVER_PORT |
قراءة فقط. المنفذ الذي يجب أن يتبعه التطبيق. | |
WEBSITE_WARMUP_PATH |
مسار نسبي لأداة اختبار الاتصال تعمل على إعداد التطبيق، وهو يبدأ بشرطة مائلة. الافتراضي هو / ، والذي يقوم باختبار اتصال مسار الجذر. يمكن اختبار اتصال المسار المحدد بواسطة عميل لم تتم مصادقته، مثل Azure Traffic Manager، حتى إذا تم تعيين مصادقة App Service على رفض العملاء غير المصادق عليهم. (ملاحظة: لا يغير إعداد التطبيق هذا المسار الذي يستخدمه AlwaysOn.) |
|
WEBSITE_COMPUTE_MODE |
قراءة فقط. يحدد ما إذا كان التطبيق يعمل على جهاز ظاهري/أجهزة مخصصة (Dedicated ) أو مشتركة (Shared ). |
|
WEBSITE_SKU |
قراءة فقط. رمز التخزين التعريفي للتطبيق. القيم المُحتملة هي Free ، وShared ، وBasic وStandard . |
|
SITE_BITNESS |
قراءة فقط. يوضح ما إذا كان التطبيق 32 بت (x86 ) أو 64 بت (AMD64 ). |
|
WEBSITE_HOSTNAME |
قراءة فقط. اسم المضيف الأساسي للتطبيق. لا يتم حساب أسماء المضيفين المخصصة هنا. | |
WEBSITE_VOLUME_TYPE |
قراءة فقط. يعرض نوع حجم التخزين قيد الاستخدام حاليًا. | |
WEBSITE_NPM_DEFAULT_VERSION |
إصدار نظام إدارة الحزم الافتراضي الذي يستخدمه التطبيق. | |
WEBSOCKET_CONCURRENT_REQUEST_LIMIT |
قراءة فقط. حد لطلبات WebSocket المتزامنة. بالنسبة إلى المستوى القياسي وما فوق، تكون القيمة -1 ، ولكن لا يزال هناك حد لكل جهاز ظاهري بناءً على حجم جهازك (راجع الحدود الرقمية المتقاطعة للأجهزة الظاهرية). |
|
WEBSITE_PRIVATE_EXTENSIONS |
قم بالتعيين على 0 لتعطيل استخدام ملحقات المواقع الخاصة. |
|
WEBSITE_TIME_ZONE |
بشكلٍ افتراضي، تكون المنطقة الزمنية للتطبيق هي دائمًا التوقيت العالمي المتفق عليه (UTC). يمكنك تغييره إلى أي من القيم الصالحة المدرجة في المناطق الزمنية الافتراضية. إذا لم يتم التعرف على القيمة المحددة، فسيتم استخدام التوقيت العالمي المتفق عليه (UTC). | Atlantic Standard Time |
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG |
بعد تبديل الفتحات، قد يواجه التطبيق عمليات إعادة تشغيل غير متوقعة. هذا لأنه بعد التبديل، يصبح تكوين ربط اسم المضيف غير متزامن، وهو ما لا يتسبب في حد ذاته في إعادة التشغيل. ومع ذلك، قد تكتشف بعض أحداث التخزين الأساسية (مثل حالات تجاوز فشل وحدات التخزين) هذه التناقضات وتجبر جميع عمليات العاملين على إعادة التشغيل. لتقليل هذه الأنواع من عمليات إعادة التشغيل، اضبط قيمة إعداد التطبيق على 1 في جميع الفتحات (القيمة الافتراضية هي 0 ). ومع ذلك، لا تقم بتعيين هذه القيمة إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation (WCF). لمزيد من المعلومات، راجع استكشاف الأخطاء في عمليات التبديل وإصلاحها |
|
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED |
بشكل افتراضي، تتم "المعالجة التلقائية" بشكل استباقي للجهاز الظاهري عند استخدام أكثر من 90% من الذاكرة المخصصة لأكثر من 30 ثانية، أو عندما تستغرق 80% من إجمالي الطلبات في آخر دقيقتين أكثر من 200 ثانية. إذا قام مثيل جهاز ظاهري بتشغيل إحدى هذه القواعد، تصبح عملية الاسترداد عملية إعادة تشغيل متداخلة للمثيل. قم بالتعيين إلى false لتعطيل سلوك الاسترداد هذا. الافتراضي هو true . لمزيد من المعلومات، راجع المعالجة التلقائية الاستباقية. |
|
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED |
كلما تعطلت عملية w3wp.exe على مثيل جهاز ظاهري لتطبيقك بسبب استثناء غير معالج لأكثر من ثلاث مرات في 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 |
بشكل افتراضي، ينشئ App Service مساحة تخزين مشتركة لك عند إنشاء التطبيق. لاستخدام حساب تخزين مخصص بدلاً من ذلك، قم بتعيين سلسلة الاتصال لحساب التخزين الخاص بك. بالنسبة للوظائف، راجع مرجع إعدادات التطبيق للوظائف. | DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key> |
WEBSITE_CONTENTSHARE |
عند استخدام تحديد حساب تخزين مخصص مع WEBSITE_CONTENTAZUREFILECONNECTIONSTRING ، ينشئ App Service مشاركة ملف في حساب التخزين هذا لتطبيقك. لاستخدام اسم مخصص، اضبط هذا المتغيّر على الاسم الذي تريده. في حالة عدم وجود مشاركة ملف بالاسم المحدد، يقوم App Service بإنشائه لك. |
myapp123 |
WEBSITE_SCM_ALWAYS_ON_ENABLED |
قراءة فقط. يوضح ما إذا كانت "مجموعات قابلية وصول عالية التوفر AlwaysOn" ممكّنًة (1 ) أم لا (0 ). |
|
WEBSITE_SCM_SEPARATE_STATUS |
قراءة فقط. يوضح ما إذا كان تطبيق Kudu يعمل في عملية منفصلة (1 ) أم لا (0 ). |
|
WEBSITE_DNS_ATTEMPTS |
عدد المرات التي يجب فيها محاولة حل الاسم. | |
WEBSITE_DNS_TIMEOUT |
عدد الثوان التي يجب انتظارها لحل الاسم |
بادئات المتغيّر
يعرض الجدول التالي بادئات متغير البيئة التي تستخدمها 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. |
AZUREBLOBSTORAGE_ |
سلسلة اتصال بحساب تخزين مخصص لحاوية مخصصة في Azure Blob Storage. |
NOTIFICATIONHUBCONNSTR_ |
تشير إلى سلسلة اتصال إلى مركز إعلام في Azure Notification Hubs. |
SERVICEBUSCONNSTR_ |
تشير إلى سلسلة اتصال بمثيل Azure Service Bus. |
EVENTHUBCONNSTR_ |
تشير إلى سلسلة اتصال إلى مركز أحداث في Azure Event Hubs. |
DOCDBCONNSTR_ |
تشير إلى سلسلة اتصال بقاعدة بيانات في Azure Cosmos DB. |
REDISCACHECONNSTR_ |
تشير إلى سلسلة اتصال بذاكرة تخزين مؤقت في Azure Cache لـ Redis. |
FILESHARESTORAGE_ |
يشير إلى سلسلة اتصال لمشاركة ملف مخصص. |
التوزيع
ترتبط متغيّرات البيئة التالية بتوزيع التطبيق. بالنسبة إلى المتغيّرات المتعلقة بأتمتة إصدار App Service، راجع أتمتة الإنشاء.
اسم الإعداد | الوصف |
---|---|
DEPLOYMENT_BRANCH |
بالنسبة لتوزيع Git المحلي أو Cloud Git (مثل GitHub)، قم بتعيين الفرع في Azure الذي تريد التوزيع إليه. بشكل افتراضي، يكون master . |
WEBSITE_RUN_FROM_PACKAGE |
قم بالتعيين على 1 لتشغيل التطبيق من حزمة ZIP محلية، أو قم بتعيين عنوان URL الخاص بعنوان 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 |
يحتفظ تطبيقك ب 5 من أحدث ملفات zip المنشورة باستخدام توزيع zip. يمكنك الاحتفاظ بأكثر من ذلك أو أقل عن طريق تعيين إعداد التطبيق إلى رقم مختلف. |
WEBSITE_WEBDEPLOY_USE_SCM |
قم بالتعيين إلى false لكي يتوقف WebDeploy عن استخدام محرك توزيع Kudu. الافتراضي هو true . للتوزيع إلى تطبيقات Linux باستخدام Visual Studio (WebDeploy/MSDeploy)، اضبطه على false . |
MSDEPLOY_RENAME_LOCKED_FILES |
قم بالتعيين إلى 1 لمحاولة إعادة تسمية مكتبات DLL إذا تعذر نسخها في أثناء توزيع WebDeploy. لا ينطبق هذا الإعداد إذا WEBSITE_WEBDEPLOY_USE_SCM تم تعيينه إلى false . |
WEBSITE_DISABLE_SCM_SEPARATION |
بشكل افتراضي، يعمل التطبيق الرئيسي وتطبيق Kudu في صناديق رمل مختلفة. عند إيقاف التطبيق، لا يزال تطبيق Kudu قيد التشغيل، ويمكنك الاستمرار في استخدام Git publish وMSDeploy. يحتوي كل تطبيق على ملفاته المحلية الخاصة به. يعد إيقاف تشغيل هذا الفصل (الإعداد على true ) وضعًا قديمًا لم يعد مدعومًا بشكل كامل. |
WEBSITE_ENABLE_SYNC_UPDATE_SITE |
قم بالتعيين إلى 1 تأكد من أن استدعاءات REST API للتحديث site وsiteconfig يتم تطبيقها بالكامل على جميع المثيلات قبل العودة. الإعداد الافتراضي هو 1 في حالة التوزيع باستخدام قالب ARM، لتجنب ظروف السباق مع استدعاءات ARM اللاحقة. |
WEBSITE_START_SCM_ON_SITE_CREATION |
عند توزيع قالب ARM، اضبط على 1 في نموذج ARM لبدء تطبيق Kudu مسبقًا كجزء من إنشاء التطبيق. |
WEBSITE_START_SCM_WITH_PRELOAD |
بالنسبة لتطبيقات Linux، اضبط على true لفرض التحميل في الخلفية على تطبيق Kudu عند تمكين مجموعات قابلية وصول عالية التوفر AlwaysOn عن طريق اختبار اتصال عنوان 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_MODE هو Dedicated . |
|
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 |
تطبيقات Linux فقط. بشكل افتراضي، يتم تشغيل التطبيق من /home/site/wwwroot ، وهو دليل مشترك لجميع الحالات التي تم تغيير حجمها. اضبط هذا المتغيّر على true لنسخ التطبيق إلى دليل محلي في الحاوية الخاصة بك وتشغيله من هناك. عند استخدام هذا الخيار، تأكد من عدم ترميز أي مرجع إلى /home/site/wwwroot . بدلاً من ذلك، استخدم مسارًا متعلقًا بـ /home/site/wwwroot . |
MACHINEKEY_Decryption |
بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows الواردة في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية decryption ، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config. |
MACHINEKEY_DecryptionKey |
بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز قيمة decryptionKey التي تم إنشاؤها تلقائيًا، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config. |
MACHINEKEY_Validation |
بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية validation ، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config. |
MACHINEKEY_ValidationKey |
بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز قيمة validationKey التي تم إنشاؤها تلقائيًا، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config. |
WordPress
إعداد التطبيق | النطاق | القيمة | الحد الأقصى | الوصف |
---|---|---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
تطبيق الويب | صحيح | - | عند التعيين على 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 م | 256 م كحد أقصى لحجم تحميل الملف. يمكن زيادتها حتى 256 م. | |
POST_MAX_SIZE |
PHP | 128 م | 256 م | يمكن زيادتها حتى 256 م. بشكل عام يجب أن يكون أكثر من 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، راجع update admin password. كلما تم تغيير كلمة مرور قاعدة بيانات MySQL، تحتاج إعدادات التطبيق أيضا إلى التحديث. |
WORDPRESS_ADMIN_EMAIL |
النشر فقط | - | - | البريد الإلكتروني لمسؤول WordPress. |
WORDPRESS_ADMIN_PASSWORD |
النشر فقط | - | - | كلمة مرور مسؤول WordPress. هذا فقط لأغراض النشر. لا يؤثر تعديل هذه القيمة على تثبيت WordPress. لتغيير كلمة مرور مسؤول WordPress، راجع resetting your password. |
WORDPRESS_ADMIN_USER |
النشر فقط | - | - | اسم مستخدم مسؤول WordPress |
WORDPRESS_ADMIN_LOCALE_CODE |
النشر فقط | - | - | اسم مستخدم قاعدة البيانات المستخدم للاتصال بـ WordPress. |
المجال ونظام أسماء المجالات
اسم الإعداد | الوصف | مثال |
---|---|---|
WEBSITE_DNS_SERVER |
عنوان IP لخادم نظام أسماء المجالات الأساسي للاتصالات الصادرة (مثل خدمة خلفية). خادم نظام أسماء المجالات الافتراضي لخدمة التطبيقات هو نظام أسماء المجالات في Azure، وعنوان IP الخاص به هو 168.63.129.16 . إذا كان تطبيقك يستخدم تكامل VNet أو كان في بيئة خدمة التطبيقات، فإنه يرث تكوين خادم نظام أسماء المجالات من VNet افتراضيًا. |
10.0.0.1 |
WEBSITE_DNS_ALT_SERVER |
عنوان IP لخادم نظام أسماء المجالات الاحتياطي للاتصالات الصادرة. راجع WEBSITE_DNS_SERVER . |
|
WEBSITE_ENABLE_DNS_CACHE |
يسمح بتخزين قرارات نظام أسماء المجالات الناجحة مؤقتًا. بشكل افتراضي، سيتم مسح إدخالات ذاكرة التخزين المؤقت 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 |
مسار 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 بأسماء المضيف التي تم تبديلها في الفتحات، فاضبط هذا المتغير على true لتجنب إعادة تشغيل من هذا النوع. إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation (WCF)، فلا تقم بتعيين هذا المتغير. |
حاويات مخصصة
لمزيد من المعلومات حول الحاويات المخصصة، راجع تشغيل حاوية مخصصة في Azure.
اسم الإعداد | الوصف | مثال |
---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
بالنسبة إلى حاويات Linux المخصصة: قم بتعيين إلى true لتمكين /home الدليل ليتم مشاركته عبر مثيلات موسعة. الإعداد الافتراضي هو false لحاويات Linux المخصصة.بالنسبة لحاويات Windows: قم بتعيين إلى true لتمكين c:\home الدليل الذي سيتم مشاركته عبر مثيلات ذات مقياس. الإعداد الافتراضي هو true لحاويات Windows. |
|
WEBSITES_CONTAINER_START_TIME_LIMIT |
مقدار الوقت بالثواني لانتظار الحاوية لإكمال بدء التشغيل قبل إعادة تشغيل الحاوية. القيمة الافتراضية هي 230 . يمكنك زيادته حتى الحد الأقصى 1800 . |
|
WEBSITES_CONTAINER_STOP_TIME_LIMIT |
مقدار الوقت بالثوان لانتظار إنهاء الحاوية بأمان. القيمة الافتراضية هي 5 . يمكنك الزيادة إلى الحد الأقصى 120 |
|
DOCKER_REGISTRY_SERVER_URL |
عنوان URL لخادم التسجيل، عند تشغيل حاوية مخصصة في خدمة التطبيقات. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية. | 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 Container Registry مع نقطة نهاية خاصة. | |
WEBSITES_WEB_CONTAINER_NAME |
في تطبيق Docker Compose، يمكن الوصول إلى الإنترنت في إحدى الحاويات فقط. اضبط على اسم الحاوية المحددة في ملف التكوين لتجاوز اختيار الحاوية الافتراضية. بشكل افتراضي، تكون الحاوية التي يمكن الوصول إليها عبر الإنترنت هي أول حاوية تحدد المنفذ 80 أو 8080، أو عندما لا يتم العثور على مثل هذه الحاوية، تكون الحاوية الأولى المحددة في ملف التكوين. | |
WEBSITES_PORT |
بالنسبة للحاوية المخصصة، رقم المنفذ المخصص في الحاوية لخدمة التطبيقات لتوجيه الطلبات إليها. بشكل افتراضي، تحاول خدمة التطبيقات الكشف التلقائي عن المنفذ في المنفذين 80 و8080. لا يتم إدخال هذا الإعداد في الحاوية كمتغير بيئة. | |
WEBSITE_CPU_CORES_LIMIT |
بشكل افتراضي، يتم تشغيل حاوية Windows بجميع النوى المتاحة لطبقة التسعير التي اخترتها. لتقليل عدد النوى، اضبط عدد النوى المطلوب. لمزيد من المعلومات، راجع تخصيص عدد مراكز الحوسبة . | |
WEBSITE_MEMORY_LIMIT_MB |
بشكل افتراضي، تحتوي جميع حاويات Windows المنشورة في Azure App Service على حد ذاكرة تم تكوينه اعتمادا على خطة خدمة التطبيقات SKU. اضبط على حد الذاكرة المطلوب بالميغابايت. يجب ألا يتجاوز الإجمالي التراكمي لهذا الإعداد عبر التطبيقات في نفس الخطة المبلغ المسموح به بواسطة طبقة التسعير المختارة. لمزيد من المعلومات، راجع تخصيص ذاكرة الحاوية. |
تغير الحجم
اسم الإعداد | الوصف |
---|---|
WEBSITE_INSTANCE_ID |
قراءة فقط. معرّف فريد لمثيل جهاز ظاهري الحالي، عندما يتم تحجيم التطبيق إلى مثيلات متعددة. |
WEBSITE_IIS_SITE_NAME |
مهمل. استخدم WEBSITE_INSTANCE_ID . |
WEBSITE_DISABLE_OVERLAPPED_RECYCLING |
إعادة التدوير المتراكب تجعله قبل إيقاف تشغيل مثيل جهاز ظاهري الحالي للتطبيق، يبدأ مثيل جهاز ظاهري جديد. في بعض الحالات، يمكن أن يتسبب ذلك في حدوث مشكلات في قفل الملفات. يمكنك محاولة إيقاف تشغيله عن طريق التعيين على 1 . |
WEBSITE_DISABLE_CROSS_STAMP_SCALE |
بشكل افتراضي، يُسمح للتطبيقات بالتوسع عبر الطوابع إذا كانت تستخدم ملفات Azure أو حاوية 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 |
SAS URL لحاوية تخزين البيانات الثنائية الكبيرة لتخزين سجلات خادم الويب لتطبيقات Windows الأصلية، إذا تم تمكين سجلات خادم الويب. في حالة عدم التعيين، يتم تخزين سجلات خادم الويب في نظام ملفات التطبيق (التخزين الافتراضي المشترك). | |
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS |
فترة الاحتفاظ بالأيام الخاصة بسجلات التطبيق لتطبيقات Windows الأصلية، إذا تم تمكين سجلات التطبيق. | 10 |
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL |
SAS URL لحاوية تخزين البيانات الثنائية الكبيرة لتخزين سجلات التطبيقات لتطبيقات 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 يحتوي على عدادات CLR. |
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 ، لا يُسمح بأقفال خاصة، بحيث لا يتم حظر عمليات التوزيع بواسطة الملفات المؤمنة. |
الشبكات
ترتبط متغيرات البيئة التالية بـ التوصيلات المختلطة وتكامل VNET.
اسم الإعداد | الوصف |
---|---|
WEBSITE_RELAYS |
قراءة فقط. البيانات اللازمة لتكوين الاتصال الهجين، بما في ذلك نقاط النهاية وبيانات ناقل الخدمة. |
WEBSITE_REWRITE_TABLE |
قراءة فقط. تستخدم في وقت التشغيل لإجراء عمليات البحث وإعادة كتابة الاتصالات بشكل مناسب. |
WEBSITE_VNET_ROUTE_ALL |
بشكل افتراضي، إذا كنت تستخدم تكامل VNet الإقليمي، فإن تطبيقك يوجه حركة مرور RFC1918 فقط إلى VNet الخاص بك. قم بالتعيين على 1 لتوجيه كل حركة المرور الصادرة إلى شبكة VNet الخاصة بك وتخضع لنفس مجموعات NSG وUDRs. يتيح لك الإعداد الوصول إلى نقاط النهاية غير RFC1918 من خلال شبكة VNet الخاصة بك، وتأمين كل حركة المرور الصادرة التي تغادر تطبيقك، وفرض كل حركة المرور الصادرة عبر نفق إلى جهاز شبكة من اختيارك. |
WEBSITE_PRIVATE_IP |
قراءة فقط. عنوان IP المرتبط بالتطبيق عند دمجه مع شبكة VNet. بالنسبة إلى تكامل VNet الإقليمي، تكون القيمة عبارة عن عنوان IP من نطاق عناوين الشبكة الفرعية المفوضة، وبالنسبة لتكامل VNet المطلوب للبوابة، تكون القيمة عبارة عن عنوان IP من نطاق عناوين مجموعة عناوين من نقطة إلى موقع تم تكوينها على الشبكة الافتراضية بوابة. يستخدم التطبيق عنوان IP هذا للاتصال بالموارد من خلال VNet. أيضًا، يمكن أن يتغير داخل نطاق العنوان الموصوف. |
WEBSITE_PRIVATE_PORTS |
قراءة فقط. في تكامل VNet، يُظهر المنافذ التي يمكن للتطبيق استخدامها للتواصل مع العقد الأخرى. |
WEBSITE_CONTENTOVERVNET |
إذا كنت تقوم بتحميل Azure File Share على App Service وكان حساب التخزين مقيدا ب VNET، فتأكد من تمكين هذا الإعداد بقيمة 1 . |
مراجع الخزنة الرئيسية
ترتبط متغيرات البيئة التالية بـ مراجع خزنة المفاتيح.
اسم الإعداد | الوصف |
---|---|
WEBSITE_KEYVAULT_REFERENCES |
قراءة فقط. يحتوي على معلومات (بما في ذلك الحالات) لجميع مراجع Key Vault التي تم تكوينها حاليًا في التطبيق. |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
إذا قمت بتعيين اتصال التخزين المشترك لتطبيقك (باستخدام WEBSITE_CONTENTAZUREFILECONNECTIONSTRING ) إلى مرجع Key Vault، فلن يتمكن التطبيق من حل مرجع key vault عند إنشاء التطبيق أو تحديثه إذا كان أحد الشروط التالية صحيحا: - يصل التطبيق إلى خزنة المفاتيح بهوية مخصصة للنظام. - يصل التطبيق إلى خزينة المفاتيح بهوية يحددها المستخدم، وخزينة المفاتيح مؤمنة بـ VNet. لتجنب الأخطاء في وقت الإنشاء أو التحديث، اضبط هذا المتغير على 1 . |
WEBSITE_DELAY_CERT_DELETION |
يمكن تعيين هذا var env إلى 1 من قبل المستخدمين للتأكد من عدم حذف شهادة تعتمد عليها عملية العامل حتى يتم الخروج منها. |
CORS
ترتبط متغيرات البيئة التالية بتكوين مشاركة الموارد عبر المنشأ (CORS).
اسم الإعداد | الوصف |
---|---|
WEBSITE_CORS_ALLOWED_ORIGINS |
قراءة فقط. يُظهر الأصول المسموح بها لـ CORS. |
WEBSITE_CORS_SUPPORT_CREDENTIALS |
قراءة فقط. يوضح ما إذا كان تعيين العنوان Access-Control-Allow-Credentials على true ممكّنًا (True ) أم لا (False ). |
المصادقة والتخويل
ترتبط متغيرات البيئة التالية بـ مصادقة خدمة التطبيق.
اسم الإعداد | الوصف |
---|---|
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW |
عند التعيين على true ، يتم تعطيل تعيين الهوية الأساسية لمؤشر الترابط في تطبيقات الويب المستندة إلى ASP.NET (بما في ذلك v1 Function Apps). تم تصميم هذا للسماح للمطورين بحماية الوصول إلى موقعهم باستخدام المصادقة، ولكن لا يزال يستخدم آلية تسجيل دخول منفصلة ضمن منطق التطبيق الخاص بهم. الافتراضي هو false . |
WEBSITE_AUTH_HIDE_DEPRECATED_SID |
true أو false . القيمة الافتراضية هي false . هذا إعداد لتكامل Azure Mobile Apps القديم لخدمة Azure App Service. يؤدي تعيين هذا إلى true إلى حل مشكلة حيث قد يتغير SID (معرف الأمان) الذي تم إنشاؤه للمستخدمين المصادق عليهم إذا قام المستخدم بتغيير معلومات ملف التعريف الخاص به. قد يؤدي تغيير هذه القيمة إلى تغيير معرفات مستخدم Azure Mobile Apps الحالية. لا تحتاج معظم التطبيقات إلى استخدام هذا الإعداد. |
WEBSITE_AUTH_NONCE_DURATION |
قيمة النطاق الزمني بالشكل _hours_:_minutes_:_seconds_ . القيمة الافتراضية هي 00:05:00 ، أو 5 دقائق. يتحكم هذا الإعداد في عمر التشفير غير المشفر الذي تم إنشاؤه لجميع عمليات تسجيل الدخول التي تعتمد على المتصفح. إذا فشل إكمال تسجيل الدخول في الوقت المحدد، فستتم إعادة محاولة تدفق تسجيل الدخول تلقائيا. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين 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 وError وWarning وInformation و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 للإشارة إلى ما إذا تم تمكين مصادقة خدمة التطبيق. |
WEBSITE_AUTH_ENCRYPTION_KEY |
بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيًا كمفتاح تشفير. للتخطي، اضبط على المفتاح المطلوب. يوصى بهذا إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل MACHINEKEY_DecryptionKey الإعداد. |
WEBSITE_AUTH_SIGNING_KEY |
بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيًا كمفتاح التوقيع. للتخطي، اضبط على المفتاح المطلوب. يوصى بهذا إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل MACHINEKEY_ValidationKey الإعداد. |
الهوية المُدارة
ترتبط متغيرات البيئة التالية بـ الهويات المُدارة.
اسم الإعداد | الوصف |
---|---|
IDENTITY_ENDPOINT |
قراءة فقط. عنوان URL لاسترداد الرمز المميز للهوية المُدارة للتطبيق. |
MSI_ENDPOINT |
مهمل. استخدم IDENTITY_ENDPOINT . |
IDENTITY_HEADER |
قراءة فقط. القيمة التي يجب إضافتها إلى رأس X-IDENTITY-HEADER عند إجراء طلب HTTP GET إلىIDENTITY_ENDPOINT . يدير النظام الأساسي القيمة. |
MSI_SECRET |
مهمل. استخدم IDENTITY_HEADER . |
فحص الصحة
ترتبط متغيرات البيئة التالية بالفحوصات الصحية.
اسم الإعداد | الوصف |
---|---|
WEBSITE_HEALTHCHECK_MAXPINGFAILURES |
الحد الأقصى لعدد مرات الاتصال الفاشلة قبل إزالة المثيل. تعيين إلى قيمة بين 2 و100 . عند التحجيم أو التصغير، تقوم App Service ب ping مسار التحقق من الصحة للتأكد من أن المثيلات الجديدة جاهزة. لمزيد من المعلومات، راجع فحص السلامة. |
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT |
لتجنب الحالات الصحية الساحقة، لن يتم استبعاد أكثر من نصف الحالات. على سبيل المثال، إذا تم تحجيم خطة خدمة التطبيق إلى أربع حالات وكانت ثلاث حالات غير صحية، فسيتم استبعاد اثنين على الأكثر. أما المثيلان الآخران (أحدهما صحي والآخر غير صحي) فسيستمران في تلقي الطلبات. وفي أسوأ السيناريوهات حيث تكون جميع الحالات غير صحية، لن يستبعد أي منها. لتجاوز هذا السلوك، عيّن إلى قيمة بين 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 |
قم بالتعيين على صواب لإرسال الإخراج من 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 |
AzureWebJobsSecretStorageType |
مرجع إعدادات التطبيق لوظائف Azure |
FUNCTIONS_EXTENSION_VERSION |
مرجع إعدادات التطبيق لوظائف Azure |
FUNCTIONS_WORKER_RUNTIME |
مرجع إعدادات التطبيق لوظائف Azure |
AzureWebJobsStorage |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_CONTENTSHARE |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_CONTENTOVERVNET |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_ENABLE_BROTLI_ENCODING |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_USE_PLACEHOLDER |
مرجع إعدادات التطبيق لوظائف Azure |
WEBSITE_PLACEHOLDER_MODE |
قراءة فقط. يوضح ما إذا كان تطبيق الوظيفة يعمل على مضيف عنصر نائب (generalized ) أو مضيفه الخاص (specialized ). |
WEBSITE_DISABLE_ZIP_CACHE |
عند تشغيل تطبيقك من حزمة ZIP (WEBSITE_RUN_FROM_PACKAGE=1 )، يتم تخزين أحدث خمس حزم ZIP تم توزيعها مؤقتًا في نظام ملفات التطبيق (D:\home\data\SitePackages). اضبط هذا المتغير على 1 لتعطيل ذاكرة التخزين المؤقت هذه. بالنسبة لتطبيقات استهلاك Linux، يتم تعطيل ذاكرة التخزين المؤقت لحزمة ZIP افتراضيًا. |