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


Справочник по параметрам приложений для Функций Azure

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

Существует несколько способов для добавления, обновления и удаления параметров приложения-функции.

После изменения параметров приложения-функции нужно перезапустить приложение-функцию.

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

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

Рекомендации по настройке приложения

При использовании параметров приложения следует учитывать следующие аспекты:

  • После изменения параметров приложения-функции нужно перезапустить приложение-функцию.

  • В именах параметров двойной подчеркивания (__) и двоеточия (:) считаются зарезервированными значениями. Двойные подчеркивания интерпретируются как иерархические разделители в Windows и Linux, а двоеточия интерпретируются одинаково только в Windows. Например, параметр AzureFunctionsWebHost__hostid=somehost_123456 будет интерпретирован как следующий объект JSON:

    "AzureFunctionsWebHost": {
        "hostid": "somehost_123456"
    }
    

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

  • Когда функции выполняются локально, параметры приложения указываются в Values коллекции в local.settings.json.

  • В файле host.json и в файле local.settings.json содержатся другие параметры конфигурации приложения-функции.

  • Параметры приложения можно использовать, чтобы переопределить значения параметров host.json без необходимости изменять сам файл host.json. Это полезно в сценариях, когда необходимо настроить или изменить конкретные параметры host.json для определенной среды. Этим способом также можно изменить параметры host.json без обязательной повторной публикации проекта. Дополнительные сведения см. в справочной статье по файлу host.json.

  • В этой статье описаны параметры, наиболее важные для приложений-функций. Так как Функции Azure выполняется в Служба приложений, также поддерживаются другие параметры приложения. Дополнительные сведения см. в разделе "Переменные среды" и "Параметры приложения" в службе приложение Azure.

  • Некоторые сценарии также требуют работы с параметрами, описанными в параметрах сайта Служба приложений.

  • Изменение параметров приложения только для чтения Служба приложений может поместить приложение-функцию в неответственное состояние.

  • При обновлении параметров приложения с помощью REST API, включая шаблоны ARM. Так как эти API заменяют существующие параметры приложения, необходимо включить все существующие параметры при добавлении или изменении параметров с помощью REST API или шаблонов ARM. По возможности используйте Azure CLI или Azure PowerShell для программной работы с параметрами приложения. Дополнительные сведения см. в разделе Работа с параметрами приложения.

APPINSIGHTS_INSTRUMENTATIONKEY

Ключ инструментирования для Application Insights. Не используйте оба APPINSIGHTS_INSTRUMENTATIONKEY и APPLICATIONINSIGHTS_CONNECTION_STRING. По возможности используйте APPLICATIONINSIGHTS_CONNECTION_STRING. При запуске Application Insights в национальном облаке необходимо использовать APPLICATIONINSIGHTS_CONNECTION_STRING. Дополнительные сведения см. в разделе Настройка мониторинга для Функций Azure.

Ключ Пример значения
APPINSIGHTS_INSTRUMENTATIONKEY 55555555-af77-484b-9032-64f83bb83bb

Не используйте оба APPINSIGHTS_INSTRUMENTATIONKEY и APPLICATIONINSIGHTS_CONNECTION_STRING. APPLICATIONINSIGHTS_CONNECTION_STRING Рекомендуется использовать.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Обеспечивает доступ к Application Insights с помощью проверки подлинности Microsoft Entra. Используйте этот параметр, когда необходимо подключиться к рабочей области Application Insights с помощью проверки подлинности Microsoft Entra. Дополнительные сведения см. в разделе проверки подлинности Microsoft Entra для Application Insights.

При использовании APPLICATIONINSIGHTS_AUTHENTICATION_STRINGзаданное значение зависит от типа управляемого удостоверения:

Управляемое удостоверение Значение параметра
Назначаемое системой Authorization=AAD
Назначаемое пользователем Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

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

Примечание.

При использовании APPLICATIONINSIGHTS_AUTHENTICATION_STRING для подключения к Application Insights с помощью проверки подлинности Microsoft Entra необходимо также отключить локальную проверку подлинности для Application Insights. Эта конфигурация требует проверки подлинности Microsoft Entra для приема данных телеметрии в рабочую область.

APPLICATIONINSIGHTS_CONNECTION_STRING

Строка подключения для Application Insights. Не используйте оба APPINSIGHTS_INSTRUMENTATIONKEY и APPLICATIONINSIGHTS_CONNECTION_STRING. Хотя использование APPLICATIONINSIGHTS_CONNECTION_STRING рекомендуется во всех случаях, это необходимо в следующих случаях:

  • Если для приложения-функции необходимы дополнительные настройки, которые поддерживаются с помощью строки подключения.
  • Если экземпляр Application Insights выполняется в национальном облаке, для которого требуется пользовательская конечная точка.

Дополнительные сведения см. в разделе Строки подключения.

Ключ Пример значения
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

Чтобы подключиться к Application Insights с проверкой подлинности Microsoft Entra, следует использовать APPLICATIONINSIGHTS_AUTHENTICATION_STRING.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Внимание

Функции Azure прокси-серверы — это устаревшая функция для версий 1.x до 3.x среды выполнения Функции Azure. Дополнительные сведения о устаревшей поддержке в версии 4.x см. в разделе "Прокси-серверы функций".

По умолчанию прокси-серверы Функций используют ярлык для отправки вызовов API из прокси напрямую в функции в том же приложении-функции. Этот ярлык используется вместо создания нового HTTP-запроса. Данный параметр позволяет отключить такое использование ярлыков.

Ключ значение Описание
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL true Вызовы с внутренним URL-адресом, указывающим на функцию в локальном приложении-функции, не будут направляться непосредственно этой функции. Вместо этого запросы направляются обратно на внешний HTTP-интерфейс приложения-функции.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL false Вызовы с URL-адресом внутреннего сервера, указывающим на функцию в локальном приложении-функции, будут перенаправляться непосредственно этой функции. По умолчанию устанавливается значение false.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Внимание

Функции Azure прокси-серверы — это устаревшая функция для версий 1.x до 3.x среды выполнения Функции Azure. Дополнительные сведения о устаревшей поддержке в версии 4.x см. в разделе "Прокси-серверы функций".

Этот параметр определяет, декодируются ли символы как косые %2F черты в параметрах маршрута при вставке в внутренний URL-адрес.

Ключ значение Описание
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES true Параметры маршрута с закодированными символами косой черты декодируются.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES false Все параметры маршрута передаются без изменений. Это поведение по умолчанию.

Например, рассмотрим файл proxies.json для приложения-функции в домене myfunction.com.

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}

Если параметр AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES установлен в значение true, URL-адрес example.com/api%2ftest разрешается в example.com/api/test. По умолчанию URL-адрес остается неизменным: example.com/test%2fapi. Дополнительные сведения см. в разделе Прокси-серверы функций.

AZURE_FUNCTIONS_ENVIRONMENT

Настраивает среду размещения среды выполнения приложения-функции при запуске в Azure. Это значение считывается во время инициализации, и только эти значения учитываются средой выполнения:

значение Описание
Production Представляет рабочую среду с сокращенным ведением журнала и полной оптимизацией производительности. Это значение по умолчанию, если AZURE_FUNCTIONS_ENVIRONMENT не задано или задано неподдерживаемое значение.
Staging Представляет промежуточную среду, например при выполнении в промежуточном слоте.
Development Разработка поддержка среды более подробное ведение журнала и другие оптимизации производительности. Набор основных средств AZURE_FUNCTIONS_ENVIRONMENT Development Функции Azure при запуске на локальном компьютере. Этот параметр нельзя переопределить в файле local.settings.json.

Используйте этот параметр вместо ASPNETCORE_ENVIRONMENT того, чтобы изменить среду выполнения в Azure на что-то другое Production. Дополнительные сведения см. в разделе "Класс и методы запуска на основе среды".

Этот параметр недоступен в среде выполнения Функций версии 1.x.

AzureFunctionsJobHost__*

Начиная с версии 2.x и далее среды выполнения Функций параметры приложения могут переопределять параметры из файла host.json в текущей среде. Такие переопределения выражаются в форме параметров приложения под названием AzureFunctionsJobHost__path__to__setting. Дополнительные сведения см. в разделе Переопределение значений из host.json.

AzureFunctionsWebHost__hostid

Задает идентификатор узла для заданного приложения-функции, который должен быть уникальным идентификатором. Этот параметр переопределяет автоматически созданное значение идентификатора узла для приложения. Используйте этот параметр только в том случае, если необходимо предотвратить конфликты идентификаторов узлов между приложениями-функциями, которые используют одну и ту же учетную запись хранения.

Идентификатор узла должен соответствовать следующим требованиям:

  • От 1 до 32 символов
  • содержит только строчные буквы, цифры и дефисы
  • Не начинается или заканчивается дефисом
  • Не содержит последовательных дефисов

Простой способ создать идентификатор — взять GUID, удалить дефисы и преобразовать его в строчные буквы, например путем преобразования GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 в значение 1835d7b55c984790815d072cc94c6f71.

Ключ Пример значения
AzureFunctionsWebHost__hostid myuniquefunctionappname123456789

Дополнительные сведения см. в разделе Рекомендации в отношении идентификаторов узла.

AzureWebJobsDashboard

Этот параметр не рекомендуется использовать и поддерживается только при выполнении в версии 1.x среды выполнения Функции Azure.

Необязательная строка подключения учетной записи для хранения журналов и их отображения на вкладке Монитор на портале. Учетная запись хранения должна быть учетной записью общего назначения, поддерживающей большие двоичные объекты, очереди и таблицы. Дополнительную информацию см. в статье Требования учетных записей хранения.

Ключ Пример значения
AzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobsDisableHomepage

Значение true отключает целевую страницу по умолчанию, отображаемую для корневого URL-адреса приложения-функции. Значение по умолчанию — false.

Ключ Пример значения
AzureWebJobsDisableHomepage true

Если пропустить этот параметр приложения или задать для него значение false, то в ответ на URL-адрес <functionappname>.azurewebsites.net отобразится страница, аналогичная приведенной ниже.

Целевая страница приложения-функции

AzureWebJobsDotNetReleaseCompilation

true означает использование режима выпуска при компиляции кода .NET; false означает использование режима отладки. По умолчанию — true.

Ключ Пример значения
AzureWebJobsDotNetReleaseCompilation true

AzureWebJobsFeatureFlags

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

Ключ Пример значения
AzureWebJobsFeatureFlags feature1,feature2,EnableProxies

Добавьте EnableProxies в этот список, чтобы повторно включить прокси-серверы в среде выполнения Функций версии 4.x при планировании миграции в Azure Управление API. Дополнительные сведения см. в разделе "Повторное включение прокси-серверов" в функциях версии 4.x.

AzureWebJobsKubernetesSecretName

Указывает ресурс секретов Kubernetes, используемый для хранения ключей. Поддерживается только при выполнении в Kubernetes. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType kubernetes. Если AzureWebJobsKubernetesSecretName этот параметр не задан, репозиторий считается только чтением. В этом случае перед развертыванием необходимо создать значения. Набор инструментов Azure Functions Core Tools автоматически создает значения при развертывании в Kubernetes.

Ключ Пример значения
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

Дополнительные сведения см. в статье "Управление хранилищем ключей".

AzureWebJobsSecretStorageKeyVaultClientId

Идентификатор клиента управляемого удостоверения, назначаемого пользователем, или регистрация приложения, используемая для доступа к хранилищу с ключами. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType keyvault. Поддерживается в среде выполнения Функций версий 4.x и более поздних.

Ключ Пример значения
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

Дополнительные сведения см. в статье "Управление хранилищем ключей".

AzureWebJobsSecretStorageKeyVaultClientSecret

Секрет для идентификатора клиента управляемого удостоверения, назначаемого пользователем, или регистрация приложения, используемая для доступа к хранилищу с ключами. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType keyvault. Поддерживается в среде выполнения Функций версий 4.x и более поздних.

Ключ Пример значения
AzureWebJobsSecretStorageKeyVaultClientSecret <CLIENT_SECRET>

Дополнительные сведения см. в статье "Управление хранилищем ключей".

AzureWebJobsSecretStorageKeyVaultName

Этот параметр не рекомендуется использовать только при выполнении в среде выполнения Функции Azure версии 3.x.

Имя экземпляра хранилища ключей, используемого для хранения ключей. Этот параметр использовался только в версии 3.x среды выполнения Функций, которая больше не поддерживается. Для версии 4.x используйте AzureWebJobsSecretStorageKeyVaultUri. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType keyvault.

Хранилище должно использовать политику доступа, соответствующую управляемому удостоверению, назначаемому системой, ресурса размещения. Политика доступа должна предоставлять удостоверению следующие разрешения секрета: Get, Set, List и Delete.
При локальном запуске функций используется удостоверение разработчика, а параметры должны находиться в файле local.settings.json.

Ключ Пример значения
AzureWebJobsSecretStorageKeyVaultName <VAULT_NAME>

Дополнительные сведения см. в статье "Управление хранилищем ключей".

AzureWebJobsSecretStorageKeyVaultTenantId

Идентификатор арендатора регистрации приложения, используемый для доступа к хранилищу с ключами. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType keyvault. Поддерживается в среде выполнения Функций версий 4.x и более поздних. Дополнительные сведения см. в статье "Управление хранилищем ключей".

Ключ Пример значения
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

URI экземпляра хранилища ключей, используемого для хранения ключей. Поддерживается в среде выполнения Функций версий 4.x и более поздних. Это рекомендуемый параметр для использования экземпляра хранилища ключей для хранилища ключей. Для этого параметра требуется задать значение AzureWebJobsSecretStorageType keyvault.

Значение AzureWebJobsSecretStorageKeyVaultUri должно быть полным значением универсального кода ресурса (URI) хранилища, отображаемого на вкладке Обзор Key Vault, включая https://.

Хранилище должно использовать политику доступа, соответствующую управляемому удостоверению, назначаемому системой, ресурса размещения. Политика доступа должна предоставлять удостоверению следующие разрешения секрета: Get, Set, List и Delete.
При локальном запуске функций используется удостоверение разработчика, а параметры должны находиться в файле local.settings.json.

Ключ Пример значения
AzureWebJobsSecretStorageKeyVaultUri https://<VAULT_NAME>.vault.azure.net

Дополнительные сведения см. в статье Использование ссылок на Key Vault в Функциях Azure.

AzureWebJobsSecretStorageSas

Подписанный URL-адрес Хранилища BLOB-объектов для второй учетной записи хранения, используемый для хранилища ключей. По умолчанию Функции используют учетную запись, заданную в параметре AzureWebJobsStorage. При использовании этого параметра хранилища секретов убедитесь, что AzureWebJobsSecretStorageType не задан явным образом или имеет значение blob. Дополнительные сведения см. в статье "Управление хранилищем ключей".

Ключ Пример значения
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

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

Ключ значение Описание
AzureWebJobsSecretStorageType blob Ключи хранятся в контейнере хранилища BLOB-объектов в учетной записи, указанной в параметре AzureWebJobsStorage. Хранилище BLOB-объектов — это поведение по умолчанию, если AzureWebJobsSecretStorageType оно не задано.
Чтобы указать другую учетную запись хранения, используйте параметр AzureWebJobsSecretStorageSas для указания подписанного URL-адреса второй учетной записи хранения.
AzureWebJobsSecretStorageType files Ключи сохраняются в файловой системе. Это поведение по умолчанию для функций версии 1.x.
AzureWebJobsSecretStorageType keyvault Ключи хранятся в экземпляре хранилища ключей, заданном параметром AzureWebJobsSecretStorageKeyVaultName.
AzureWebJobsSecretStorageType kubernetes Поддерживается только при запуске среды выполнения Функций в Kubernetes. Если AzureWebJobsKubernetesSecretName этот параметр не задан, репозиторий считается только чтением. В этом случае перед развертыванием необходимо создать значения. Набор инструментов Azure Functions Core Tools автоматически создает значения при развертывании в Kubernetes.

Дополнительные сведения см. в статье "Управление хранилищем ключей".

AzureWebJobsStorage

Указывает строка подключения для учетной записи служба хранилища Azure, которую среда выполнения функций использует для обычных операций. Некоторые из этих учетных записей хранения функций включают управление ключами, управление триггерами таймера и контрольные точки Центров событий. Учетная запись хранения должна быть учетной записью общего назначения, поддерживающей большие двоичные объекты, очереди и таблицы. Дополнительные сведения см. в разделе Требования к учетной записи хранения.

Ключ Пример значения
AzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=...

Вместо строка подключения можно использовать подключение на основе удостоверений для этой учетной записи хранения. Дополнительные сведения см. в разделе Подключение к хранилищу узла с помощью удостоверения.

AzureWebJobsStorage__accountName

При использовании подключения к хранилищу на основе удостоверений задает имя учетной записи хранения вместо строка подключения вAzureWebJobsStorage. Этот синтаксис уникален AzureWebJobsStorage и не может использоваться для других подключений на основе удостоверений.

Ключ Пример значения
AzureWebJobsStorage__accountName <STORAGE_ACCOUNT_NAME>

Для национальных облаков или при использовании настраиваемого DNS следует использовать параметры, относящиеся AzureWebJobsStorage__*ServiceUri к службе.

AzureWebJobsStorage__blobServiceUri

При использовании подключения к хранилищу на основе удостоверений задает URI плоскости данных службы BLOB-объектов учетной записи хранения.

Ключ Пример значения
AzureWebJobsStorage__blobServiceUri https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

Используйте этот параметр вместо AzureWebJobsStorage__accountName национальных облаков или при использовании пользовательского DNS. Дополнительные сведения см. в разделе Подключение к хранилищу узла с помощью удостоверения.

AzureWebJobsStorage__queueServiceUri

При использовании подключения к хранилищу на основе удостоверений задает универсальный код ресурса (URI) плоскости данных службы очередей учетной записи хранения.

Ключ Пример значения
AzureWebJobsStorage__queueServiceUri https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net

Используйте этот параметр вместо AzureWebJobsStorage__accountName национальных облаков или при использовании пользовательского DNS. Дополнительные сведения см. в разделе Подключение к хранилищу узла с помощью удостоверения.

AzureWebJobsStorage__tableServiceUri

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

Ключ Пример значения
AzureWebJobsStorage__tableServiceUri https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net

Используйте этот параметр вместо AzureWebJobsStorage__accountName национальных облаков или при использовании пользовательского DNS. Дополнительные сведения см. в разделе Подключение к хранилищу узла с помощью удостоверения.

AzureWebJobs_TypeScriptPath

Путь к компилятору, который используется для TypeScript. Позволяет при необходимости переопределить значение по умолчанию.

Ключ Пример значения
AzureWebJobs_TypeScriptPath %HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

Указывает пароль, используемый для доступа к частному реестру контейнеров. Этот параметр требуется только при развертывании контейнерного приложения-функции из частного реестра контейнеров. Дополнительные сведения см. в разделе "Переменные среды" и "Параметры приложения" в службе приложение Azure.

DOCKER_REGISTRY_SERVER_URL

Указывает URL-адрес частного реестра контейнеров. Этот параметр требуется только при развертывании контейнерного приложения-функции из частного реестра контейнеров. Дополнительные сведения см. в разделе "Переменные среды" и "Параметры приложения" в службе приложение Azure.

DOCKER_REGISTRY_SERVER_USERNAME

Указывает учетную запись, используемую для доступа к частному реестру контейнеров. Этот параметр требуется только при развертывании контейнерного приложения-функции из частного реестра контейнеров. Дополнительные сведения см. в разделе "Переменные среды" и "Параметры приложения" в службе приложение Azure.

DOCKER_SHM_SIZE

Задает размер общей памяти (в байтах), если рабочая роль Python использует общую память. Дополнительные сведения см. в разделе Общая память.

Ключ Пример значения
DOCKER_SHM_SIZE 268435456

Указанное выше значение задает общий размер памяти около 256 МБ.

Требует, чтобы для параметра FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED было задано значение 1.

ENABLE_ORYX_BUILD

Указывает, используется ли система сборки Oryx во время развертывания. ENABLE_ORYX_BUILD при выполнении удаленных развертываний сборки в Linux необходимо задать значение true . Дополнительные сведения см. в разделе "Удаленная сборка".

Ключ Пример значения
ENABLE_ORYX_BUILD true

FUNCTION_APP_EDIT_MODE

Указывает, можно ли изменить приложение-функцию в портал Azure. Допустимые значения — readwrite и readonly.

Ключ Пример значения
FUNCTION_APP_EDIT_MODE readonly

Значение задается средой выполнения на основе языкового стека и состояния развертывания приложения-функции. Дополнительные сведения см. в разделе об ограничениях разработки в портал Azure.

FUNCTIONS_EXTENSION_VERSION

Версия среды выполнения Функций, в которой размещается ваше приложение-функция. Тильда (~) с основной версией означает использование последней версии этой основной версии (например, ~4). Когда доступны новые дополнительные версии той же основной версии, они автоматически устанавливаются в приложении-функции.

Ключ Пример значения
FUNCTIONS_EXTENSION_VERSION ~4

Поддерживаются следующие основные значения версии среды выполнения.

Значение Целевая версия среды выполнения Комментарий
~4 4.x Рекомендуемая конфигурация
~1 1.x Поддержка заканчивается 14 сентября 2026 г.

Значение ~4 означает, что приложение работает в среде выполнения версии 4.x. Значение ~1 позволяет закрепить для приложения версию 1.x среды выполнения. Версии среды выполнения 2.x и 3.x больше не поддерживаются. Дополнительные сведения см. в обзоре версий среды выполнения Функций Azure. Если запрашивается поддержка для закрепления приложения к определенной дополнительной версии, используйте полный номер версии (например, 4.0.12345). Дополнительные сведения см. в статье Выбор целевых версий среды выполнения Функций Azure.

FUNCTIONS_INPROC_NET8_ENABLED

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

Ключ Пример значения
FUNCTIONS_INPROC_NET8_ENABLED 1

Установите для 0 отключения поддержки .NET 8 в модели в процессе.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Этот параметр приложения является временным способом для Node.js приложений, чтобы включить критическое изменение, которое упрощает устранение ошибок точки входа в Node.js версии 18 или более поздней версии. Настоятельно рекомендуется использовать trueприложения модели программирования версии 4, которые всегда используют файлы точек входа. Поведение без критического изменения (false) игнорирует ошибки точки входа и не регистрирует их в Application Insights.

Начиная с Node.js версии 20 параметр приложения не влияет, и поведение критических изменений всегда включено.

Для Node.js версии 18 или ниже используется параметр приложения, а поведение по умолчанию зависит от того, происходит ли ошибка до или после регистрации функции модели версии 4:

  • Если ошибка возникает раньше (например, если вы используете модель версии 3 или файл точки входа не существует), поведение по умолчанию соответствует false.
  • Если ошибка возникает после (например, при попытке зарегистрировать повторяющиеся функции модели версии 4), поведение по умолчанию соответствует true.
Ключ значение Описание
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true Блокировать ошибки точки входа и регистрируют их в Application Insights.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false Игнорируйте ошибки точки входа и не регистрируйте их в Application Insights.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Переопределяет ограничение по умолчанию на размер текста запросов, отправленных в конечные точки HTTP. Значение присваивается в байтах с максимальным размером запроса по умолчанию 104857600 байтов.

Ключ Пример значения
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Внимание

Этот параметр больше не поддерживается. Первоначально было предоставлено, чтобы включить кратковременное решение для приложений, предназначенных для среды выполнения версии 2.x, чтобы вместо этого работать в среде выполнения версии 3.x во время ее поддержки. За исключением устаревших приложений, работающих в версии 1.x, все приложения-функции должны работать в среде выполнения функций версии 4.x: FUNCTIONS_EXTENSION_VERSION=~4 Дополнительные сведения см. в обзоре версий среды выполнения Функций Azure.

FUNCTIONS_WORKER_PROCESS_COUNT

Указывает максимальное количество языковых рабочих процессов. Значение по умолчанию — 1. Максимальное допустимое значение — 10. Вызовы функций равномерно распределяются между языковыми рабочими процессами. Рабочие процессы языка создаются каждые 10 секунд, пока число FUNCTIONS_WORKER_PROCESS_COUNT не будет достигнуто. Использование нескольких рабочих процессов языка не совпадает с масштабированием. Рассмотрите возможность использования этого параметра, если в вашей рабочей нагрузке имеется сочетание вызовов, ограниченных по производительности ЦП, и вызовов, ограниченных по пропускной способности ввода-вывода. Этот параметр применяется ко всем языковым средам выполнения, за исключением .NET в процессе (FUNCTIONS_WORKER_RUNTIME=dotnet).

Ключ Пример значения
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

Стек языка или языка рабочей среды выполнения для загрузки в приложение-функцию. Этот параметр соответствует языку, используемому в приложении (например, python). Начиная с версии 2.x среды выполнения Функций Azure отдельное приложение-функция может поддерживать только один язык.

Ключ Пример значения
FUNCTIONS_WORKER_RUNTIME node

Допустимые значения:

Значение Стек языка и языка
dotnet C# (библиотека классов)
C# (скрипт)
dotnet-isolated C# (изолированный рабочий процесс)
java Java
node JavaScript
TypeScript
powershell PowerShell
python Python
custom Другое

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

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

Ключ Пример значения
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED 1

Если этот параметр включен, вы можете использовать параметр DOCKER_SHM_SIZE, чтобы задать размер общей памяти. Дополнительные сведения см. в разделе Общая память.

JAVA_OPTS

Используется для настройки виртуальной машины Java (JVM), используемой для запуска функций Java при выполнении плана Premium или выделенного плана. При выполнении плана потребления вместо этого используйте languageWorkers__java__arguments. Дополнительные сведения см. в разделе "Настройка JVM".

languageWorkers__java__arguments

Используется для настройки виртуальной машины Java (JVM), используемой для запуска функций Java при выполнении плана потребления. Этот параметр увеличивает время холодного запуска для функций Java, работающих в плане потребления. Вместо этого используйте JAVA_OPTSдля плана "Премиум" или "Выделенный". Дополнительные сведения см. в разделе "Настройка JVM".

MDMaxBackgroundUpgradePeriod

Управляет периодом обновления в фоновом режиме для управляемых зависимостей для приложений-функций PowerShell. По умолчанию используется значение 7.00:00:00 (еженедельно).

Каждый рабочий процесс PowerShell инициирует проверку наличия обновлений модулей в коллекции PowerShell при каждом запуске процесса и далее после каждого истечения периода MDMaxBackgroundUpgradePeriod. Если в коллекции PowerShell доступна новая версия модуля, она устанавливается в файловой системе и предоставляется рабочим ролям PowerShell. Уменьшение этого значения позволяет приложению-функции быстрее получать более новые версии модулей, но при этом увеличивает потребление ресурсов приложения (сетевой ввод-вывод, ЦП, хранилище). Увеличение этого значения уменьшает использование ресурсов приложения, но может также отложить доставку новых версий модулей в приложение.

Ключ Пример значения
MDMaxBackgroundUpgradePeriod 7.00:00:00

Дополнительные сведения см. в разделе Управление зависимостями.

MDNewSnapshotCheckPeriod

Указывает, как часто каждый рабочий процесс PowerShell проверяет, установлены ли обновления для управляемых зависимостей. По умолчанию используется период 01:00:00 (ежечасно).

После установки новых версий модулей в файловой системе необходимо перезапустить каждый рабочий процесс PowerShell. Перезапуск рабочих ролей PowerShell влияет на доступность приложения, так как может прерывать текущее выполнение функции. До перезапуска всех рабочих процессов PowerShell вызовы функций могут использовать старые или новые версии модуля. Перезапуск всех рабочих ролей PowerShell завершается не в пределах периода MDNewSnapshotCheckPeriod.

После истечения периода MDNewSnapshotCheckPeriod рабочий процесс PowerShell проверяет, установлены ли обновления управляемых зависимостей. Когда обновления буду установлены, выполняется перезагрузка. Увеличение этого значения снижает частоту перерывов, связанных с перезапусками. Однако увеличение может также увеличить время, в течение которого вызовы функций могут использовать старые или новые версии модуля, недетерминированно.

Ключ Пример значения
MDNewSnapshotCheckPeriod 01:00:00

Дополнительные сведения см. в разделе Управление зависимостями.

MDMinBackgroundUpgradePeriod

Период времени после предыдущей проверки управляемого обновления зависимостей до запуска следующей проверки. По умолчанию используется значение 1.00:00:00 (ежедневно).

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

Ключ Пример значения
MDMinBackgroundUpgradePeriod 1.00:00:00

Дополнительные сведения см. в разделе Управление зависимостями.

PIP_INDEX_URL

Этот параметр позволяет переопределить базовый URL-адрес индекса пакета Python, который по умолчанию имеет значение https://pypi.org/simple. Используйте этот параметр, если необходимо запустить удаленную сборку с помощью пользовательских зависимостей. Эти пользовательские зависимости могут находиться в репозитории индексов пакетов, совместимом с PEP 503 (простым API репозитория) или в локальном каталоге, который соответствует одному и тому же формату.

Ключ Пример значения
PIP_INDEX_URL http://my.custom.package.repo/simple

Дополнительные сведения см. в разделе pip документация для --index-url и раздел Пользовательские зависимости в справочнике разработчика Python.

PIP_EXTRA_INDEX_URL

Значение этого параметра указывает дополнительный URL-адрес индекса для пользовательских пакетов для приложений Python, используемых в дополнение к параметру --index-url. Используйте этот параметр, когда вам необходимо запустить удаленную сборку с пользовательскими зависимостями, которые содержатся в дополнительном индексе пакетов. Следует следовать тем же правилам, что --index-urlи .

Ключ Пример значения
PIP_EXTRA_INDEX_URL http://my.custom.package.repo/simple

Дополнительные сведения см. в разделе pip документация для --extra-index-url и Пользовательские зависимости в справочнике разработчика Python.

ПРОЕКТ

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

Ключ Пример значения
ПРОЕКТ WebProject/WebProject.csproj

PYTHON_ISOLATE_WORKER_DEPENDENCIES

Эта конфигурация применяется только к приложениям-функциям Python. Она определяет приоритетность загрузки модулей. По умолчанию, этому параметру присваивается значение 0.

Ключ значение Описание
PYTHON_ISOLATE_WORKER_DEPENDENCIES 0 Приоритет загрузки библиотек Python из зависимостей внутренних рабочих ролей Python, что является поведением по умолчанию. Сторонние библиотеки, определенные в requirements.txt, могут быть тени.
PYTHON_ISOLATE_WORKER_DEPENDENCIES 1 Задает приоритетность загрузки библиотек Python из пакетов приложений, определенных в файле requirements.txt. Эта настройка позволяет избежать конфликтов с внутренними библиотеками рабочей роли Python.

PYTHON_ENABLE_DEBUG_LOGGING

Включает ведение журнала на уровне отладки в приложении-функции Python. Значение 1 включает ведение журнала на уровне отладки. Без этого параметра или со значением 0только сведения и журналы более высокого уровня отправляются из рабочей роли Python на узел Функций. Используйте этот параметр при отладке или трассировке выполнения функций Python.

При отладке функций Python также задайте уровень ведения журнала отладки или трассировки в файле host.json (при необходимости). Дополнительные сведения см. в статье Настройка мониторинга для Функций Azure.

PYTHON_ENABLE_WORKER_EXTENSIONS

Эта конфигурация применяется только к приложениям-функциям Python. Указание значения 1 для этого параметра позволяет рабочей роли загружать расширения рабочей роли Python, определенные в файле requirements.txt. Это позволяет приложению-функции обращаться к новым возможностям, предоставляемым в пакетах сторонних поставщиков. Он также может изменить поведение загрузки функции и вызова в приложении. Убедитесь, что выбранное расширение является надежным, так как вы несете риск его использования. Функции Azure не предоставляют явных гарантий на любые расширения. Сведения о том, как использовать расширение, перейдите на страницу вручную или документ readme расширения. По умолчанию это значение задает 0значение .

Ключ значение Описание
PYTHON_ENABLE_WORKER_EXTENSIONS 0 Отключает все расширения рабочей роли Python.
PYTHON_ENABLE_WORKER_EXTENSIONS 1 Разрешает рабочей роли Python загружать расширения из файла requirements.txt.

PYTHON_THREADPOOL_THREAD_COUNT

Указывает максимальное количество потоков, которое языковый рабочий процесс Python будет использовать для выполнения вызовов функций. Значение по умолчанию для версий Python 3.8 и ниже — 1. Для версий Python 3.9 и выше значение по умолчанию равно None. Этот параметр не гарантирует количество потоков, которые будут заданы во время выполнения. Этот параметр позволяет Python увеличивать количество потоков до заданного значения. Данный параметр применяется только к приложениям-функциям на Python. Кроме того, этот параметр применяется к вызовам синхронных функций, но не к соподпрограммам.

Ключ Пример значения Максимальное значение
PYTHON_THREADPOOL_THREAD_COUNT 2 32

SCALE_CONTROLLER_LOGGING_ENABLED

Этот параметр в настоящее время находится в предварительной версии.

Этот параметр управляет ведением журнала в контроллере масштабирования Функций Azure. Дополнительные сведения см. в разделе Журналы контроллера масштабирования.

Ключ Пример значения
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

Значение для этого ключа указывается в формате <DESTINATION>:<VERBOSITY>, который определяется следующим образом:

Свойство Description
<DESTINATION> Место назначения, в которое отправляются журналы. Допустимые значения — AppInsights и Blob.
При использовании AppInsights убедитесь, что в приложении-функции включена функция Application Insights.
Если для назначения задано значение Blob, то журналы создаются в контейнере больших двоичных объектов с именем azure-functions-scale-controller в учетной записи хранения по умолчанию, заданной в параметре AzureWebJobsStorage приложения.
<VERBOSITY> Определяет уровень ведения журнала. Поддерживаются значения None, Warning и Verbose.
Если задано значение Verbose, контроллер масштабирования регистрирует причину каждого изменения количества рабочих ролей, а также сведения о триггерах, которые влияют на эти решения. Подробные журналы содержат предупреждения триггеров и хэши, использованные триггерами до и после запуска контроллера масштабирования.

Совет

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

SCM_DO_BUILD_DURING_DEPLOYMENT

Управляет поведением удаленной сборки во время развертывания. Если SCM_DO_BUILD_DURING_DEPLOYMENT задано значение true, проект создается удаленно во время развертывания.

Ключ Пример значения
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

Управление временем ожидания в секундах при установленном подключении к потоковой передаче журналов. Значение по умолчанию составляет 7200 секунд (2 часа).

Ключ Пример значения
SCM_LOGSTREAM_TIMEOUT 1800

В приведенном выше примере значение 1800 устанавливает время ожидания 30 минут. Дополнительные сведения см. в разделе "Включение журналов выполнения потоковой передачи" в Функции Azure.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

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

Ключ Пример значения
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=...

Этот параметр необходим для приложений плана потребления и elastic Premium, работающих как в Windows, так и в Linux. Он не требуется для приложений ценовой категории "Выделенный", которые не масштабируются динамически с помощью Функций.

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

Файлы Azure не поддерживает использование управляемого удостоверения при доступе к общей папке. Дополнительные сведения см. в Файлы Azure поддерживаемых сценариях проверки подлинности.

WEBSITE_CONTENTOVERVNET

Внимание

WEBSITE_CONTENTOVERVNET — это устаревший параметр приложения, который был заменен свойством сайта vnetContentShareEnabled .

Значение 1 позволяет масштабировать приложение-функцию, если учетная запись хранения ограничена виртуальной сетью. Этот параметр следует включать, когда учетная запись хранения ограничивается виртуальной сетью. Требуется только при использовании WEBSITE_CONTENTSHARE и WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Дополнительные сведения см. в разделе Ограничение учетной записи хранения виртуальной сетью.

Ключ Пример значения
WEBSITE_CONTENTOVERVNET 1

Этот параметр приложения требуется для планов Elastic Premium и выделенных (Служба приложений) (стандарт и выше). Не поддерживается при работе по плану потребления.

Примечание.

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

WEBSITE_CONTENTSHARE

Имя общей папки, которую функции используют для хранения кода приложения-функции и файлов конфигурации. Это содержимое требуется планами масштабирования на основе событий. Используется с WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. По умолчанию используется уникальная строка, созданная средой выполнения, которая начинается с имени приложения-функции. Дополнительные сведения см. в разделе "Настройка подключения учетной записи хранения".

Ключ Пример значения
WEBSITE_CONTENTSHARE functionapp091999e2

Этот параметр необходим для приложений категорий "Потребление" и "Премиум" в Windows и Linux. Он не требуется для приложений ценовой категории "Выделенный", которые не масштабируются динамически с помощью Функций.

Общая папка создается при создании приложения-функции. Изменение или удаление этого параметра может привести к тому, что приложение-функция не запускается. Дополнительные сведения см. в этой статье по устранению неполадок.

Следующие рекомендации применяются при использовании шаблона Azure Resource Manager (ARM) или Bicep-файла для создания приложения-функции во время развертывания:

  • Если вы не зададите значение WEBSITE_CONTENTSHARE для основного приложения-функции или любых приложений в слотах, для вас будут созданы уникальные значения общей папки. Не рекомендуется использовать WEBSITE_CONTENTSHARE для развертывания шаблона ARM.
  • Существуют сценарии, в которых необходимо задать WEBSITE_CONTENTSHARE значение предопределенного значения, например при использовании защищенной учетной записи хранения в виртуальной сети. В этом случае необходимо задать уникальное имя общей папки для основного приложения-функции и приложения для каждого слота развертывания. В случае учетной записи хранения, защищенной виртуальной сетью, необходимо также создать общую папку в рамках автоматического развертывания. Дополнительные сведения см. в разделе "Защищенные развертывания".
  • Не делайте WEBSITE_CONTENTSHARE параметром слота.
  • При указании WEBSITE_CONTENTSHARE значение должно соответствовать этому руководству по именам общих ресурсов.

WEBSITE_DNS_SERVER

Задает DNS-сервер, используемый приложением при разрешении IP-адресов. Этот параметр часто требуется при использовании определенных функций сети, таких как частные зоны Azure DNS и частные конечные точки.

Ключ Пример значения
WEBSITE_DNS_SERVER 168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Определяет, используется ли шифрование Brotli вместо сжатия gzip (вариант по умолчанию) для сжатия. Если параметр WEBSITE_ENABLE_BROTLI_ENCODING имеет значение 1, используется кодирование Brotli. в противном случае используется кодирование gzip.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Отключает кэширование при развертывании приложений-функций с помощью шаблонов Azure Resource Manager (ARM).

Ключ Пример значения
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

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

Внимание

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

Ключ Пример значения
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 5

WEBSITE_NODE_DEFAULT_VERSION

Только для Windows. Задает версию Node.js, используемую при запуске приложения-функции в Windows. Чтобы среда выполнения использовала новейшую доступную вспомогательную версию заданной основной версии, следует указать символ тильды (~). Например, при установке ~18используется последняя версия Node.js 18. Когда основной номер версии указан с тильдой, обновлять вспомогательную версию вручную не требуется.

Ключ Пример значения
WEBSITE_NODE_DEFAULT_VERSION ~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

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

Ключ Пример значения
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

Добавьте WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS значение 0 для всех слотов, чтобы убедиться, что устаревшие параметры диагностики не блокируют переключения. Вы также можете добавить этот параметр и значение только в рабочий слот в качестве параметра слота развертывания (липкий).

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

По умолчанию параметры версии для приложений-функций зависят от каждого слота. Этот параметр используется при обновлении функций с помощью слотов развертывания. Это позволяет избежать непредвиденного поведения из-за изменения версий после переключения. Установите значение 0 в рабочей среде и в слоте, чтобы все параметры версии также были переключены. Дополнительные сведения см. в разделе "Обновление с помощью слотов".

Ключ Пример значения
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS 0

WEBSITE_RUN_FROM_PACKAGE

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

Ключ Пример значения
WEBSITE_RUN_FROM_PACKAGE 1

Допустимые значения — это URL-адрес, разрешающий расположение файла пакета внешнего развертывания или 1. Если задано значение 1, пакет должен быть в папке d:\home\data\SitePackages. При использовании zip-развертывания с WEBSITE_RUN_FROM_PACKAGE включенным пакет автоматически отправляется в это расположение. В предварительной версии этот параметр называется WEBSITE_RUN_FROM_ZIP. Дополнительные сведения см. в статье Запуск Функций Azure из файла пакета.

При развертывании из URL-адреса внешнего пакета также необходимо вручную синхронизировать триггеры. Дополнительные сведения см. в разделе "Синхронизация триггеров".

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

Параметры WEBSITE_CONTENTAZUREFILECONNECTIONSTRING и WEBSITE_CONTENTSHARE имеют дополнительные проверки, чтобы убедиться, что приложение может быть правильно запущено. Создание параметров приложения завершается ошибкой, если приложение-функция не может должным образом вызвать нижестоящей учетной записи хранения или Key Vault из-за ограничений сети или других факторов ограничения. Если задано 1значение WEBSITE_SKIP_CONTENTSHARE_VALIDATION, проверка проверки пропускается; в противном случае значение по умолчанию 0 используется и выполняется проверка.

Ключ Пример значения
WEBSITE_SKIP_CONTENTSHARE_VALIDATION 1

Если проверка пропущена, а строка подключения или общий ресурс содержимого недействителен, приложение не сможет запуститься должным образом. В этом случае функции возвращают ошибки HTTP 500. Дополнительные сведения см. в статье об ошибке устранения неполадок: "Функции Azure среда выполнения недоступна"

WEBSITE_SLOT_NAME

Только чтение. Имя текущего слота развертывания. Имя рабочего слота — Production.

Ключ Пример значения
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

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

Ключ ОС Пример значения
WEBSITE_TIME_ZONE Windows Eastern Standard Time
WEBSITE_TIME_ZONE Linux America/New_York

Часовой пояс по умолчанию, используемый с выражениями CRON — время в формате UTC. Если нужно использовать другой часовой пояс в выражении CRON, создайте параметр приложения с именем WEBSITE_TIME_ZONE для приложения-функции.

Значение этого параметра зависит от операционной системы и плана, в рамках которого выполняется приложение-функция.

Операционная система Планирование Значение
Windows Все Задайте в качестве значения имя нужного часового пояса, которое задается второй строкой каждой пары параметров, определяемых командой Windows tzutil.exe /L
Linux Premium
Выделенные
В качестве значения задайте имя нужного часового пояса, как указано в базе данных часовых поясов.

Примечание.

WEBSITE_TIME_ZONE и TZ в настоящее время не поддерживаются при запуске в Linux в плане потребления. В этом случае можно задать WEBSITE_TIME_ZONE или TZ создать проблемы, связанные с SSL, и привести к остановке работы метрик для приложения.

Например, для Восточного времени США (представленного параметром Eastern Standard Time (в Windows) или America/New_York (в Linux)) сейчас используется время со значением UTC-05:00 в зимний период и со значением UTC-04:00 в летний период. Чтобы триггер таймера срабатывал каждый день в 10:00 по восточному времени, создайте для приложения-функции параметр с именем WEBSITE_TIME_ZONE, задайте ему значение Eastern Standard Time (в Windows) или America/New_York (в Linux), а затем используйте следующее выражение NCRONTAB:

"0 0 10 * * *"

При использовании параметра WEBSITE_TIME_ZONE время корректируется в соответствии с изменениями времени в определенном часовом поясе, включая летнее время и изменения в зимнем времени.

WEBSITE_USE_PLACEHOLDER

Указывает, следует ли использовать определенную оптимизацию холодного запуска при выполнении в плане потребления. Установите для 0 отключения оптимизации холодного запуска в плане потребления.

Ключ Пример значения
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

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

Ключ Пример значения
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Внимание

WEBSITE_VNET_ROUTE_ALL — это устаревший параметр приложения, который был заменен параметром сайта vnetRouteAllEnabled .

Указывает, весь ли исходящий из приложения трафик направляется через виртуальную сеть. Значение 1 параметра указывает, что весь трафик приложения направляется через виртуальную сеть. Этот параметр потребуется при настройке интеграции региональной виртуальной сети в планах размещения Elastic Premium и Выделенного размещения. Он также применяется, когда для определения статического исходящего IP-адреса используется шлюз NAT виртуальной сети.

Ключ Пример значения
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Указывает, является ли /home каталог общим для масштабируемых экземпляров со значением trueпо умолчанию. Это необходимо задать false при развертывании приложения-функции в контейнере.

параметры сайта Служба приложений

Некоторые конфигурации должны поддерживаться на уровне Служба приложений в качестве параметров сайта, таких как языковые версии. Эти параметры управляются на портале с помощью REST API или с помощью Azure CLI или Azure PowerShell. Ниже приведены параметры сайта, которые могут потребоваться в зависимости от языка среды выполнения, ОС и версий:

AlwaysOn

В приложении-функции, работающем в плане выделенного (Служба приложений), среда выполнения Функций неактивна через несколько минут бездействия, что указывает только запросы к триггеру HTTP пробуждения приложения-функции. Чтобы убедиться, что функции, не активированные по протоколу HTTP, выполняются правильно, включая функции триггера таймера, включите AlwaysOn для приложения-функции, задав alwaysOn параметр сайта значением true.

functionsRuntimeAdminIsolationEnabled

Определяет, можно ли получить доступ к встроенным конечным точкам администратора в/admin приложении-функции. Если задано значение false (по умолчанию), приложение разрешает запросы конечным точкам в том случае, если эти запросы /admin представляют главный ключ в запросе. /admin Когда trueдоступ к конечным точкам не удается получить, даже с главным ключом.

Это свойство нельзя задать для приложений, работающих в номере SKU потребления Linux, и его нельзя задать для приложений, работающих в версии 1.x Функции Azure. Если вы используете версию 1.x, сначала необходимо перейти на версию 4.x.

linuxFxVersion

Для приложений-функций, работающих в Linux, linuxFxVersion указывает язык и версию для рабочего процесса конкретного языка. Эти сведения используются вместе с FUNCTIONS_EXTENSION_VERSIONопределением конкретного образа контейнера Linux для запуска приложения-функции. Этот параметр может быть задан как предопределенное значение или URI пользовательского образа.

Это значение задается при создании приложения-функции Linux. Возможно, потребуется задать его для развертываний шаблона ARM и Bicep и в определенных сценариях обновления.

Допустимые значения linuxFxVersion

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

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Предыдущая команда требует обновления до версии 2.40 Azure CLI.

Пользовательские образы

При создании и обслуживании собственного пользовательского контейнера Linux для приложения-функции linuxFxVersion вместо этого используется формат DOCKER|<IMAGE_URI>, как показано в следующем примере:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

Это означает источник реестра развернутого контейнера. Дополнительные сведения см. в статье "Работа с контейнерами и Функции Azure".

Внимание

При создании собственных контейнеров необходимо сохранить базовый образ контейнера обновленным до последнего поддерживаемого базового образа. Поддерживаемые базовые образы для Функции Azure относятся к языку и находятся в репозитории базовых образов Функции Azure.

Команда функций привержена публикации ежемесячных обновлений для этих базовых образов. Регулярные обновления включают последние незначительные обновления версий и исправления безопасности для среды выполнения функций и языков. Необходимо регулярно обновлять контейнер из последнего базового образа и повторно развертывать обновленную версию контейнера.

netFrameworkVersion

Задает определенную версию функций .NET для C#. Дополнительные сведения см. в разделе "Обновление приложения-функции" в Azure.

PowerShellVersion

Задает определенную версию PowerShell, в которой выполняются функции. Дополнительные сведения см. в разделе "Изменение версии PowerShell".

При локальном запуске вместо этого используйте FUNCTIONS_WORKER_RUNTIME_VERSION параметр в файле local.settings.json.

vnetContentShareEnabled

Приложения, работающие в плане Premium, используют общую папку для хранения содержимого. Имя этой общей папки содержимого хранится в параметре WEBSITE_CONTENTSHARE приложения и его строка подключения хранится в WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Чтобы маршрутизировать трафик между приложением-функцией и ресурсом содержимого через виртуальную сеть, необходимо также задать значение vnetContentShareEnabled true. Включение этого свойства сайта является обязательным требованием при ограничении учетной записи хранения виртуальной сети в планах размещения Elastic Premium и Выделенных.

Примечание.

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

Это свойство сайта заменяет устаревший WEBSITE_CONTENTOVERVNET параметр.

vnetImagePullEnabled

Функции поддерживают приложения-функции , работающие в контейнерах Linux. Чтобы подключиться и извлечь из реестра контейнеров в виртуальной сети, необходимо задать значение vnetImagePullEnabled true. Это свойство сайта поддерживается в планах размещения Elastic Premium и Выделенных сайтов. План потребления Flex не зависит от свойств сайта или параметров приложения для настройки сети. Дополнительные сведения см. в разделе о прекращении использования плана потребления Flex.

vnetRouteAllEnabled

Указывает, весь ли исходящий из приложения трафик направляется через виртуальную сеть. Значение true параметра указывает, что весь трафик приложения направляется через виртуальную сеть. Используйте этот параметр при настройке интеграции региональной виртуальной сети в планах Elastic Premium и Выделенных планах. Он также применяется, когда для определения статического исходящего IP-адреса используется шлюз NAT виртуальной сети. Дополнительные сведения см. в разделе "Настройка маршрутизации приложений".

Этот параметр сайта заменяет устаревший параметр WEBSITE_VNET_ROUTE_ALL .

Отмена плана потребления Flex

В плане потребления Flex эти свойства сайта и параметры приложения не рекомендуется использовать при создании ресурсов приложения-функции:

Параметр/свойство Причина
ENABLE_ORYX_BUILD Заменен параметром remoteBuild при развертывании в Flex Consumption
FUNCTIONS_EXTENSION_VERSION Параметр приложения задается серверной частью. Значение ~1 можно игнорировать.
FUNCTIONS_WORKER_RUNTIME Заменено name в properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION Заменено version в properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY Заменен разделом триггера масштабирования и параллелизма
FUNCTIONS_WORKER_PROCESS_COUNT Параметр недействителен
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED Параметр недействителен
SCM_DO_BUILD_DURING_DEPLOYMENT Заменен параметром remoteBuild при развертывании в Flex Consumption
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Заменен разделом развертывания functionAppConfig
WEBSITE_CONTENTOVERVNET Не используется для сетевых подключений в Flex Consumption
WEBSITE_CONTENTSHARE Заменен разделом развертывания functionAppConfig
WEBSITE_DNS_SERVER DNS наследуется от интегрированной виртуальной сети в Flex
WEBSITE_NODE_DEFAULT_VERSION Заменено version в properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE Не используется для развертываний в Flex Consumption
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Общий ресурс содержимого не используется в Flex Consumption
WEBSITE_VNET_ROUTE_ALL Не используется для сетевых подключений в Flex Consumption
properties.alwaysOn Недействительно
properties.containerSize Переименовано как instanceMemoryMB
properties.ftpsState FTPS не поддерживается
properties.isReserved Недействительно
properties.IsXenon Недействительно
properties.javaVersion Заменено version в properties.functionAppConfig.runtime
properties.LinuxFxVersion Заменены properties.functionAppConfig.runtime
properties.netFrameworkVersion Заменено version в properties.functionAppConfig.runtime
properties.powerShellVersion Заменено version в properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit Переименовано как maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount Переименовано как alwaysReadyInstances
properties.use32BitWorkerProcess 32-разрядная версия не поддерживается
properties.vnetBackupRestoreEnabled Не используется для сетевых подключений в Flex Consumption
properties.vnetContentShareEnabled Не используется для сетевых подключений в Flex Consumption
properties.vnetImagePullEnabled Не используется для сетевых подключений в Flex Consumption
properties.vnetRouteAllEnabled Не используется для сетевых подключений в Flex Consumption
properties.windowsFxVersion Недействительно

Следующие шаги

Узнайте, как обновлять параметры приложения

См. параметры конфигурации в файле host.json

См. другие параметры приложения для приложений Службы приложений Azure