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

Пакеты расширений Функций Azure

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

Эта статья относится только к разработчикам функций Azure с помощью non-.NET языков. Сведения о добавлении расширений привязки непосредственно в приложения функций C# см. в статье "Регистрация расширений привязки функций Azure".

Обзор

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

При создании проекта Функций Azure из шаблона non-.NET пакеты расширений уже включены в host.json файле приложения.

Определение ссылки на пакет расширений

Вы определяете ссылку на пакет расширений в файле проекта host.json , добавив extensionBundle раздел, как в следующем примере:

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

В extensionBundle доступны следующие свойства:

Недвижимость Описание
id Пространство имен для наборов расширений Функций Microsoft Azure.
version Диапазон версий устанавливаемого пакета. В среде выполнения Функций всегда выбирается максимально допустимая версия, определенная в диапазоне версий. Например, version диапазон значений [4.0.0, 5.0.0) позволяет использовать все версии пакета от 4.0.0 до 5.0.0. Дополнительные сведения см. в разделе об интервальной нотации для указания диапазонов версий.

Поддерживаемые пакеты расширений

В этой таблице перечислены все Microsoft.Azure.Functions.ExtensionBundle версии пакета и текущее состояние поддержки.

Версия пакета Версия в host.json Режим поддержки Дата окончания поддержки
4.x [4.0.0, 5.0.0) Активен Еще не определено
3.x [3.3.0, 4.0.0) Устарело 05/30/2026
2.x [2.*, 3.0.0) Устарело 05/30/2026
1.x [1.*, 2.0.0) Устарело 05/30/2026

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

Дополнительные сведения см. в разделе "Политика поддержки".

Рекомендации по пакетам расширений

При работе с пакетами расширений следует учитывать следующие рекомендации.

  • По возможности следует задать version значение диапазона в host.json из этой таблицы, например [4.0.0, 5.0.0)вместо определения пользовательского диапазона.
  • Используйте последний диапазон версий, чтобы получить оптимальную производительность приложения и доступ к новейшим функциям.
  • В маловероятном случае нельзя использовать пакет расширений, вместо этого необходимо явно установить расширения.

Предварительный просмотр пакетов расширений

Предварительные версии определенных расширений привязки включены в пакет расширений для предварительного просмотра. Пакет расширений предварительной версии (Microsoft.Azure.Functions.ExtensionBundle.Preview) позволяет воспользоваться преимуществами расширений предварительной версии и новым поведением в настоящих расширениях, прежде чем они объявлены как GA.

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

  • Пакеты предварительной версии могут включать функции, которые по-прежнему находятся в процессе разработки и еще не готовы к использованию в рабочей среде. Они предназначены для оценки и тестирования в непроизводственных средах.
  • Критические изменения происходят между версиями предварительной версии без предварительного уведомления, которые могут включать в себя следующие изменения:
    • Определения триггеров и привязок
    • Расширения, включенные в предварительную версию
    • Характеристики производительности и стабильность
  • Обновления системы безопасности могут потребовать обновления версий.
  • Необходимо полностью протестировать пакеты предварительной версии в непроизводственных средах и избегать использования пакетов предварительной версии в рабочей среде. При использовании пакета предварительной версии в рабочей среде выполните следующие дополнительные меры предосторожности:
    • Закрепление пакета к определенной хорошо проверенной версии пакета вместо диапазона. Закрепление предотвращает автоматическое обновление версии пакета перед проверкой обновления в непроизводной среде.
    • Переместите приложение в версию пакета общедоступной версии, как только функциональные возможности становятся доступными в полностью поддерживаемом выпуске пакета.
  • Чтобы оставаться в курсе обновлений пакета, включая переход с предварительной версии на общедоступную версию, необходимо:
    • Мониторинг выпусков версий пакета предварительной версии на странице выпуска пакетов расширений. - Выпуски · Azure/azure-functions-extension-bundles
    • Документация по мониторингу конкретного расширения.
    • Просмотрите версии пакетов NuGet для определенных расширений предварительной версии, которые вы используете.
    • Отслеживайте значительные обновления или изменения журналов изменений, опубликованных в NuGet.org для каждого расширения предварительной версии.

Политика поддержки

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

Цикл поддержки пакета расширений GA следует таким этапам:

Этап Описание
Активен Последняя основная версия пакетов расширений считается активной и рекомендуется для приложений-функций.
Уведомление Корпорация Майкрософт предоставляет предварительное уведомление перед прекращением поддержки пакета расширений или версии расширения привязки. При получении такого уведомления необходимо начать обновление приложений-функций до последней поддерживаемой версии пакета расширений. Это обновление гарантирует, что приложения продолжают получать доступ к новым функциям, улучшениям производительности и поддержке.
Исключения Когда новая главная версия пакета дополнительных функций становится доступной для всех, предыдущая версия переходит на 12-месячный этап устаревания. Этот период перекрытия дает вам время для планирования, тестирования и обновления ваших приложений до того, как предыдущая версия будет выведена из эксплуатации.
Отставка После выхода из пакета расширений приложения-функции, ссылающиеся на определенную версию, не могут быть доступны для новых функций, исправлений безопасности и оптимизации производительности. Приложения-функции, использующие устаревшие версии, по-прежнему могут быть созданы и развернуты и разрешены для запуска на платформе. Однако до получения поддержки необходимо обновить приложение функций до поддерживаемой версии пакета.

Вы можете просмотреть версии пакета расширений и их включенные расширения в репозитории GitHub для расширений функций Azure. Отдельные пакеты .NET находятся в https://nuget.org.

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