Поделиться через

Переменные среды и настройки приложения в Azure 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 Относительный путь для пинга, чтобы разогреть приложение, начиная с косой черты. Значение по умолчанию — /robots933456.txt.

Всякий раз, когда платформа запускает контейнер, оркестратор делает повторные запросы к этому конечному пункту. Платформа рассматривает любой ответ с этой конечной точки как указание на то, что контейнер готов. Когда платформа считает, что контейнер готов, она начинает перенаправлять органический трафик в только что запущенный контейнер. Если WEBSITE_WARMUP_STATUSES не настроено, платформа считает любой ответ от контейнера на этой конечной точке (даже коды ошибок, такие как 404 или 502) указанием, что контейнер готов.

Этот параметр приложения не изменяет путь, который использует Always On.
WEBSITE_WARMUP_STATUSES Список кодов состояния HTTP, разделённых запятыми, которые считаются успешными, когда платформа выполняет разогревочные пинги на недавно запущенный контейнер. Используется с WEBSITE_WARMUP_PATH.

По умолчанию любой код состояния рассматривается как признак того, что контейнер готов для органического трафика. Вы можете использовать это приложение, чтобы требовать конкретного ответа, прежде чем органический трафик будет направлен в контейнер.

Примером является 200,202. Если в ответ на пинги к настроенному пути прогрева приложения приходит ответ с кодом состояния 200 или 202, органический трафик направляется в контейнер. Если получен код состояния, который отсутствует в списке (например, 502), платформа продолжает отправлять пинги до тех пор, пока не получен код 200 или 202, или пока не будет достигнут тайм-аут контейнера при запуске. См. WEBSITES_CONTAINER_START_TIME_LIMIT ниже в этой таблице.

Если контейнер не отвечает с кодом состояния HTTP, который есть в списке, платформа в конечном итоге завершает попытку запуска и повторяет, что приводит к ошибкам 503.
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 Версия npm по умолчанию, которую использует приложение.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Только для чтения Предел для одновременных запросов WebSocket. Для Standard уровня и выше значение составляет -1, но все еще имеется ограничение на виртуальную машину в зависимости от размера вашей виртуальной машины. См. Cross VM Numerical Limits.
WEBSITE_PRIVATE_EXTENSIONS Установите значение 0, чтобы отключить использование частных расширений сайта.
WEBSITE_TIME_ZONE По умолчанию, часовой пояс приложения всегда устанавливается в UTC. Вы можете изменить его на любое из допустимых значений, перечисленных в разделе Часовые пояса по умолчанию. Если указанное значение не распознано, приложение использует UTC.

Пример: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG После изменений слотов приложение может неожиданно перезапуститься. Причина заключается в том, что после обмена конфигурация привязки имени хоста выходит из синхронизации, что само по себе не вызывает перезапусков. Однако некоторые основные события хранения (например, переключение отказа тома хранения) могут обнаружить эти несоответствия и заставить все процессы-исполнители перезапуститься.

Чтобы минимизировать количество таких перезапусков, установите значение настройки приложения на 1 для всех слотов. (Значение по умолчанию — 0.) Но не устанавливайте это значение, если у вас запущено приложение Windows Communication Foundation. Для получения дополнительной информации см. Troubleshoot swaps.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED По умолчанию экземпляр виртуальной машины автоматически корректируется, когда он использует более 90% выделенной памяти в течение более 30 секунд, или когда 80% всех запросов за последние две минуты занимают более 200 секунд. Если экземпляр виртуальной машины срабатывает по одному из этих правил, процесс восстановления представляет собой перекрывающуюся перезагрузку экземпляра.

Установите значение false, чтобы отключить это поведение восстановления. Значение по умолчанию — true.

Для получения дополнительной информации см. сообщение в блоге Introducing Proactive Auto Heal.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Всякий раз, когда процесс w3wp.exe на экземпляре виртуальной машины вашего приложения падает из-за необработанного исключения более трех раз в течение 24 часов, отладочный процесс прикрепляется к основному рабочему процессу на этом экземпляре. Процесс отладчика собирает дамп памяти, когда процесс-работник снова сбой. Затем происходит анализ дампа памяти, и стек вызовов потока, который вызвал сбой, сохраняется в ваших журналах службы приложений.

Установите значение false, чтобы отключить этот автоматический режим мониторинга. Значение по умолчанию — true.

Для получения дополнительной информации см. публикацию в блоге Proactive Crash Monitoring in 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 Functions.

Пример: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE Когда вы указываете настраиваемую учетную запись хранения с помощью WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, служба App Service создаёт общий доступ к файлам в этой учетной записи хранения для вашего приложения. Чтобы использовать собственное имя, установите эту переменную на нужное вам имя. Если общий ресурс с указанным именем не существует, служба App Service создаёт его для вас.

Пример: myapp123
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 Время (в секундах), которое платформа ожидает, пока контейнер станет готовым при запуске. Этот настрой применяется как для приложений на основе кода, так и для контейнерных приложений на службе приложений для Linux. Значение по умолчанию 230.

Когда контейнер запускается, проводятся многократные запросы к контейнеру, чтобы оценить его готовность обрабатывать органический трафик. (См. WEBSITE_WARMUP_PATH и WEBSITE_WARMUP_STATUSES.) Эти пинги выполняются непрерывно до тех пор, пока не будет получен успешный ответ или не истечет начальное ограничение времени. Если контейнер не будет признан готовым в течение установленного времени тайм-аута, платформа завершает попытку запуска и повторяет ее, что приводит к ошибкам 503.

Для службы приложений для контейнеров Windows время по умолчанию для запуска составляет 10 mins. Вы можете изменить предельное время начала, указав временной интервал. Например, 00:05:00 обозначает 5 минут.

Переменные префиксы

Следующая таблица показывает префиксы переменных окружения, которые служба приложений использует для различных целей.

Имя настройки Описание
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.
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 или облачного 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 deploy. Вы можете оставить больше или меньше, изменив настройку приложения на другое число.
WEBSITE_WEBDEPLOY_USE_SCM Установите значение false, чтобы Web Deploy прекратил использовать механизм развертывания Kudu. Значение по умолчанию — true. Чтобы развернуть приложения Linux с помощью Visual Studio (Web Deploy/MSDeploy), установите его в положение false.
MSDEPLOY_RENAME_LOCKED_FILES Установите значение 1, чтобы попытаться переименовать DLL, если они не могут быть скопированы во время развертывания Web Deploy. Этот параметр не применим, если WEBSITE_WEBDEPLOY_USE_SCM установлен на false.
WEBSITE_DISABLE_SCM_SEPARATION По умолчанию основное приложение и приложение Kudu запускаются в разных песочницах. Когда вы останавливаете приложение, приложение Kudu продолжает работать, и вы можете продолжать использовать развёртывание через Git и MSDeploy. У каждого приложения есть свои собственные локальные файлы. Отключение этого разделения (установка в true) является устаревшим режимом, который больше не поддерживается в полной мере.
WEBSITE_ENABLE_SYNC_UPDATE_SITE Установите параметр на 1, чтобы убедиться, что вызовы REST API для обновления site и siteconfig полностью применяются ко всем экземплярам перед возвратом. Значение по умолчанию — 1, если вы выполняете развертывание с помощью шаблона диспетчера ресурсов Azure (шаблон ARM), чтобы избежать условий гонки с последующими вызовами диспетчера ресурсов.
WEBSITE_START_SCM_ON_SITE_CREATION В развертывании ARM-шаблона укажите 1 в ARM-шаблоне, чтобы предварительно запустить приложение Kudu как часть создания приложения.
WEBSITE_START_SCM_WITH_PRELOAD Для приложений Linux установите true для принудительной предварительной загрузки приложения Kudu, когда функция "Всегда включено" активирована, путем выполнения запроса его 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, для более детального отслеживания.
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, чтобы использовать 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 runtime прислушивается в контейнере.
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. Программный элемент может переопределить автоматически сгенерированное значение путем настройки его в параметрах приложения службы App Service или установки его непосредственно в элементе decryptionKey файла machineKey.
MACHINEKEY_Validation Для нативных Windows приложений или контейнеризированных Windows приложений эта переменная внедряется в среду приложения или контейнера для активации криптографических механизмов ASP.NET. (См. элемент machineKey.) Чтобы изменить значение по умолчанию validation, настройте его как параметр приложения App Service или установите непосредственно в элементе machineKey файла Web.config.
MACHINEKEY_ValidationKey Для нативных Windows приложений или контейнеризированных Windows приложений эта переменная внедряется в среду приложения или контейнера для активации криптографических механизмов ASP.NET. Программный элемент может переопределить автоматически сгенерированное значение путем настройки его в параметрах приложения службы App Service или установки его непосредственно в элементе validationKey файла machineKey.

WordPress

Настройки приложения Область действия Значение Максимум Описание
WEBSITES_ENABLE_APP_SERVICE_STORAGE Веб-приложение true Неприменимо При установке в true содержимое файлов сохраняется при перезапусках.
WP_MEMORY_LIMIT WordPress 128M 512M Предел памяти PHP для фронтенда или общего использования в WordPress (на скрипт). Не может быть больше 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. Если ваше приложение использует интеграцию виртуальной сети или находится в среде службы приложений, оно по умолчанию наследует конфигурацию 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.

Имя настройки Описание
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS По умолчанию версии расширений сайта специфичны для каждого слота. Этот параметр по умолчанию предотвращает непредвиденное поведение приложения из-за изменения версий расширений после обмена. Если вы хотите, чтобы версии расширений также сменялись, установите 0 на всех слотах.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS Назначает некоторые настройки как постоянные или несприимчивые к изменениям по умолчанию. По умолчанию true. Установите это значение на false или 0 для всех слотов развертывания, чтобы сделать их взаимо заменяемыми. Нет точного контроля для конкретных типов настроек.
WEBSITE_SWAP_WARMUP_PING_PATH Путь для пинга с целью прогрева целевой ячейки при замене, начиная со слэша. По умолчанию используется /, который пингует корневой путь по 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 сервера реестра, используемого при запуске пользовательского контейнера в службе приложений. В целях безопасности эта переменная не передается в контейнер.

Пример: 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 могла направлять запросы на него. По умолчанию, App Service пытается автоматически определить порты 80 и 8080. Это значение не вводится в контейнер в качестве переменной окружения.
WEBSITE_CPU_CORES_LIMIT По умолчанию контейнер Windows работает со всеми доступными ядрами для выбранного вами уровня цен. Чтобы уменьшить количество ядер, установите ограничение на количество желаемых ядер. Для получения дополнительной информации см. Настройка количества вычислительных ядер.
WEBSITE_MEMORY_LIMIT_MB По умолчанию, для всех контейнеров Windows, развернутых в службе приложений, установлен лимит памяти, зависящий от уровня плана службы приложений. Установите желаемый предел памяти в мегабайтах. Совокупный итог этой настройки среди приложений в одном и том же плане не должен превышать сумму, которую позволяет выбранный ценовой уровень. Для получения дополнительной информации см. Настройка памяти контейнера.

Масштабирование

Имя настройки Описание
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 SAS URL контейнера хранилища блобов для хранения журналов веб-сервера для нативных приложений Windows, если журналы веб-сервера включены. Если это не настроено, журналы веб-сервера хранятся в файловой системе приложения (по умолчанию в общем хранилище).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Период хранения (в днях) логов приложений для встроенных приложений Windows, если ведется запись логов приложений.

Пример: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL Для хранения журналов приложений для нативных приложений Windows, если ведение журналов включено, используйте SAS URL контейнера блоб-хранилища.
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 (Common Language Runtime).
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 на службе приложений и учетная запись хранения ограничена виртуальной сетью, включите этот параметр со значением 1.

Ссылки на хранилище ключей

Следующие переменные среды связаны с ссылками на хранилище ключей.

Имя настройки Описание
WEBSITE_KEYVAULT_REFERENCES Только для чтения Содержит информацию (включая статусы) обо всех ссылках на ключевые хранилища, которые в настоящее время настроены в приложении.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Если вы установите подключение общего хранилища вашего приложения (используя WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) как ссылку на хранилище ключей, приложение не сможет разрешить ссылку на хранилище ключей при создании или обновлении приложения, если выполняется одно из следующих условий:

- Приложение получает доступ к хранилищу ключей с использованием идентификации, назначенной системой.
- Приложение получает доступ к хранилищу ключей, используя назначенную пользователем идентичность, а хранилище ключей заблокировано с помощью виртуальной сети.

Чтобы избежать ошибок во время создания или обновления, установите эту переменную на 1.
WEBSITE_DELAY_CERT_DELETION Установка этой переменной окружения на значение 1 гарантирует, что сертификат, от которого зависит рабочий процесс, не будет удален до его завершения.

CORS (Совместное использование ресурсов разных источников)

Следующие переменные среды относятся к настройке совместного использования ресурсов между источниками (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 (включая приложения функций версии 1). Эта возможность позволяет разработчикам защищать доступ к их сайту с помощью аутентификации, но при этом использовать отдельный механизм входа в систему в рамках логики их приложения. Значение по умолчанию — false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true или false. Значение по умолчанию false. Это настройка для устаревшей интеграции мобильных приложений в службе приложений Azure. Установка значения true решает проблему, при которой идентификатор безопасности, создаваемый для аутентифицированных пользователей, может измениться, если пользователь изменяет информацию своего профиля.

Изменение этого значения может привести к изменению существующих идентификаторов пользователей в 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 API, поэтому определенные сопоставления исключены (например, "roles"). Чтобы получить более современную версию сопоставлений утверждений, задайте для этой переменной значение False. В примере с "ролями" это будет сопоставлено с длинным именем требования http://schemas.microsoft.com/ws/2008/06/identity/claims/role.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true или false. Значение по умолчанию false. Когда установлено значение true, заголовок HTTP-ответа WWW-Authenticate удаляется из 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 (часы). Этот параметр управляет временем, в течение которого после истечения срока действия сеансового токена API /.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 автоматически заполняет эту переменную среды. Эта переменная используется для настройки встроенного модуля аутентификации. Его значение соответствует конфигурации аутентификации V2 (неклассическая) для текущего приложения в Azure Resource Manager. Это не предназначено для явной конфигурации.
WEBSITE_AUTH_ENABLED Только для чтения Внедряется в приложение Windows или Linux для указания на то, включена ли аутентификация App Service.
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 и 10. При увеличении или расширении App Service отправляет запросы на путь проверки состояния, чтобы убедиться, что новые экземпляры готовы. За дополнительной информацией см. Проверка состояния.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT Чтобы не перегружать здоровые экземпляры, исключается не более половины экземпляров. Например, если план App Service масштабирован до четырёх экземпляров и три из них работают некорректно, то исключаются не более двух из них. Другие две инстанции (одна здорова и одна нездорова) продолжают получать запросы. В наихудшем случае, когда все экземпляры являются нездоровыми, ни один из них не исключается.

Чтобы переопределить это поведение, установите значение в диапазоне от 1 до 100. Более высокое значение означает, что большее количество нездоровых экземпляров удаляется. Значение по умолчанию — 50 (50%).

Push-уведомления

Следующие переменные окружения связаны с функцией push-уведомлений.

Имя настройки Описание
WEBSITE_PUSH_ENABLED Только для чтения Добавляется, когда уведомления включены.
WEBSITE_PUSH_TAG_WHITELIST Только для чтения Содержит теги в регистрации уведомлений.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH Только для чтения Содержит список тегов в регистрации уведомлений, которые требуют аутентификации пользователя.
WEBSITE_PUSH_TAGS_DYNAMIC Только для чтения Содержит список тегов в регистрации уведомлений, которые были добавлены автоматически.

Заметка

Предыдущая таблица относится к белому списку — термину, который больше не используется Microsoft. Когда термин удаляется из программного обеспечения, мы удаляем его из этой статьи.

ВебДжобс

Следующие переменные среды имеют отношение к WebJobs.

Имя настройки Описание
WEBJOBS_RESTART_TIME Для непрерывных заданий укажите задержку в секундах до перезапуска процесса задания, если он завершится по какой-либо причине.
WEBJOBS_IDLE_TIMEOUT Тайм-аут в секундах для запущенных заданий. После этого тайм-аута задание прекращается, если оно бездействует, не использует процессорное время или не выдает результаты.
WEBJOBS_HISTORY_SIZE Для запущенных заданий максимальное количество запусков, сохраняемых в каталоге истории для каждого задания. Значение по умолчанию — 50.
WEBJOBS_STOPPED Установите значение 1, чтобы отключить выполнение любой задачи и остановить все задачи, выполняемые в данный момент.
WEBJOBS_DISABLE_SCHEDULE Установите значение 1, чтобы отключить все запланированные срабатывания. Задачи все еще могут быть выполнены вручную.
WEBJOBS_ROOT_PATH Абсолютный или относительный путь файлов WebJob. Для относительного пути значение объединяется с корневым путем по умолчанию (D:/home/site/wwwroot/ или /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS Установите значение true, чтобы отправлять вывод от активированных WebJobs в конвейер журнала приложений (который поддерживает файловые системы, блобы и таблицы).
WEBJOBS_SHUTDOWN_FILE Файл, который создается службой приложений, когда обнаружен запрос на завершение работы. Отслеживание наличия этого файла и инициирование завершения работы — это ответственность процесса WebJob. При использовании SDK WebJobs эта часть обрабатывается автоматически.
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-пакетов по умолчанию отключен.