Общие сведения о версиях среды выполнения Функций Azure

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

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

Уровни поддержки

Различают два уровня поддержки:

• Общедоступные (GA) — полностью поддерживаемые и утвержденные для использования в рабочей среде.
• Предварительная версия — пока не поддерживается, но в будущем ожидается повышение до состояния GA.

Языки

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

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

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

Сведения о языковых версиях ранее поддерживаемых версий среды выполнения Функций см. в версиях среды выполнения "Устаревшие".

Запуск в определенной версии

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

По умолчанию приложения-функции, созданные на портале Azure, с помощью Azure CLI или из средств Visual Studio, устанавливаются в версию 4.x. При необходимости эту версию можно изменить. Только после создания приложения-функции, но перед добавлением любых функций, можно изменить версию среды выполнения до 1.x. Обновление до более поздней основной версии разрешено даже с приложениями, имеющими существующие функции.

Перенос существующих приложений-функций

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

• Переход с среды выполнения версии 3.x на версию 4.x
• Переход с среды выполнения версии 1.x на версию 4.x

Изменение версии приложений в Azure

Используются следующие основные значения версий среды выполнения:

Закрепление на определенной минорной версии

Чтобы устранить проблемы, которые может возникнуть при запуске приложения-функции в последней основной версии, необходимо временно закрепить приложение на определенной дополнительной версии. Закрепление дает время, чтобы приложение работало правильно в последней основной версии. Способ закрепления на минорную версию отличается между Windows и Linux. Дополнительные сведения см. в статье «Как нацеливать версии среды выполнения Azure Functions».

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

Минимальные версии расширений

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Устаревшие версии

Эти версии среды выполнения Функций достигли конца расширенной поддержки 13 декабря 2022 г.

Как можно скорее необходимо перенести приложения в версию 4.x, чтобы получить полную поддержку. Полный набор инструкций по миграции, относящихся к языку, см. в статье "Миграция приложений в Функции Azure версии 4.x".

Приложения с использованием версий 2.x и 3.x по-прежнему можно создавать и развертывать из конвейера CI/CD DevOps, а все существующие приложения продолжают работать без критических изменений. Однако приложения не могут быть доступны для новых функций, исправлений безопасности и оптимизации производительности. Только после обновления приложений до версии 4.x вы сможете получить поддержку соответствующих служб.

Версии 2.x и 3.x больше не поддерживаются из-за окончания поддержки .NET Core 3.1, которая была основной зависимостью. Это требование влияет на все языки, поддерживаемые функциями Azure.

Локально разработанные версии приложений

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

Версии среды выполнения Visual Studio

В Visual Studio вы выбираете версию среды выполнения при создании проекта. Средства Функций Azure для Visual Studio поддерживают две основные версии среды выполнения. Правильная версия используется при отладке и публикации на основе параметров проекта. Параметры версии определяются в CSPROJ-файле в следующих свойствах:

<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>

<TargetFramework>net48</TargetFramework>
<AzureFunctionsVersion>v1</AzureFunctionsVersion>

Visual Studio Code и Основные инструменты Azure Functions

Основные средства Функций Azure используются для разработки командной строки, а также расширения Функций Azure для Visual Studio Code. Дополнительные сведения см. в разделе "Установка основных средств Функций Azure".

Для разработки Visual Studio Code может также потребоваться обновить параметры пользователя для azureFunctions.projectRuntime в соответствии с версией установленных средств. Этот параметр также обновляет шаблоны и языки, используемые во время создания приложения-функции.

Привязки

Начиная с версии 2.x среда выполнения использует новую модель расширения привязки , которая предлагает следующие преимущества:

• Поддержка расширений привязки, не связанных с Microsoft.

• Развязка среды выполнения и привязок. Это изменение позволяет версионировать расширения привязки и выпускать их независимо. Например, вы можете перейти на версию расширения, которая зависит от более новой версии базового пакета SDK.

• Более светлая среда выполнения, в которой известны только используемые привязки и загружаются средой выполнения.

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

В этой таблице показаны привязки, поддерживаемые в основных версиях среды выполнения Функций Azure:

Примечания:

1. Поддержка среды выполнения Azure Functions версии 1.x окончится 14 сентября 2026 г. Настоятельно рекомендуется перенести приложения в версию 4.x для полной поддержки.
2. Начиная с среды выполнения версии 2.x все привязки, кроме ПРОТОКОЛА HTTP и Таймера, должны быть зарегистрированы. См. раздел "Регистрация расширений привязки".
3. Триггеры не поддерживаются на тарифе «Потребление». Требует триггеров, управляемых во время выполнения.
4. Поддерживается только в Kubernetes, IoT Edge и других автономных режимах.

Длительность времени ожидания приложения-функции

Продолжительность тайм-аута функций в функциональном приложении определяется свойством functionTimeout в файле host.json проекта. Это свойство применяется специально к выполнению функций. После запуска триггера выполнение функции следует завершить или ответить в установленное время ожидания. Чтобы избежать времени ожидания, важно создавать надежные функции. Для получения дополнительной информации см. «Повышение производительности и надежности Azure Functions».

В следующей таблице приведены значения по умолчанию и максимальные значения (в минутах) для конкретных планов:

1. Независимо от параметра времени ожидания приложения-функции, 230 секунд — это максимальное время, затраченное функцией HTTP для реагирования на запрос. Это связано с временем простоя по умолчанию Azure Load Balancer. При более длительной обработке рассмотрите возможность использования асинхронного шаблона Устойчивых функций или отложите работу и получите немедленный ответ.
2. Максимальное время ожидания выполнения не применяется. Однако льготный период, предоставленный выполнению функции, составляет 60 минут во время масштабирования планов Flex Consumption и Premium, а льготный период 10 минут предоставляется во время обновлений платформы.
3. Требуется, чтобы план службы приложений был настроен на Always On. Льготный период 10 минут предоставляется во время обновлений платформы.
4. Время ожидания по умолчанию для среды выполнения узла функций версии 1.x неограниченно.
5. Если минимальное количество реплик равно нулю, время ожидания по умолчанию зависит от конкретных триггеров, используемых в приложении.

Связанный контент

Дополнительные сведения см. в следующих ресурсах:

• Разработка функций Azure локально с помощью основных средств
• Как настраивать версии среды выполнения Azure Functions
• Заметки о выпуске