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

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

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

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

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

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

Языки

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

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

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

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

Версия среды выполнения для Функций 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".

Более старые вспомогательные версии периодически удаляются из Функций Azure. Последние новости о выпусках службы "Функции 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

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

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

Привязки

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

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

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

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

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

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

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

Примечания:

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

Время ожидания приложения-функции

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

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

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

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

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

• Как программировать и тестировать функции Azure в локальной среде
• Выбор целевых версий среды выполнения Функций Azure
• Заметки о выпуске