通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure Functions 扩展捆绑包

本文介绍了扩展捆绑包如何使您的函数代码能够使用所有由 Azure Functions 支持的触发器和绑定。 还可以了解使用扩展捆绑包时应用的各种支持级别和策略。

本文仅适用于使用 non-.NET 语言的 Azure Functions 开发人员。 若要了解如何将绑定扩展直接添加到 C# 函数应用，请参阅 注册 Azure Functions 绑定扩展。

概述

扩展捆绑包将预定义的一组兼容的绑定扩展添加到函数应用。 扩展捆绑已进行版本控制。 每个版本都包含一组特定的绑定扩展，这些扩展经过验证，可协同工作。 根据应用中所需的扩展版本选择捆绑版本。

从 non-.NET 模板创建 Azure Functions 项目时，扩展捆绑包已在应用的 host.json 文件中启用。

定义扩展包引用

通过添加节在 extensionBundle 项目文件中定义扩展捆绑包引用，如以下示例所示：

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

extensionBundle 中提供了以下属性：

资产 DESCRIPTION
id Microsoft Azure Functions 扩展捆绑包的命名空间。
version 要安装的捆绑包的版本范围。 Functions 运行时始终选取由版本范围或间隔定义的可允许最高版本。 例如，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 定义文件。

有关详细信息，请参阅 支持策略。

扩展捆绑包注意事项

使用扩展捆绑包时，请记住以下注意事项：

  • 如果可能，应在此表中host.json设置version范围值，例如[4.0.0, 5.0.0)，而不是定义自定义范围。
  • 使用最新版本范围获取最佳的应用性能和对最新功能的访问权限。
  • 如果无法使用扩展捆绑包（这种情况不太可能发生），则必须显式安装扩展。

预览扩展捆绑包

特定绑定扩展的预发行版本包含在预览扩展捆绑包中。 预览扩展捆绑包 (Microsoft.Azure.Functions.ExtensionBundle.Preview) 允许在将现有扩展声明为 GA 之前利用预览扩展和新行为。

选择使用非 GA 扩展捆绑包时，请记住以下注意事项：

  • 预览版捆绑包可以包括仍在开发中但尚未准备好用于生产的功能。 它们用于在非生产环境中进行评估和测试。
  • 预览版之间发生中断性变更，但未事先通知，这可能包括对以下内容的更改：
    • 触发器和绑定的定义
    • 预览版中包含的扩展
    • 性能特征和稳定性
  • 安全更新可能需要升级版本。
  • 必须在非生产环境中完全测试预览捆绑包，并避免在生产环境中使用预览捆绑包。 在生产环境中必须使用预览捆绑包时，请采取以下额外预防措施：
    • 将捆绑包固定到经过测试的特定捆绑包版本，而不是固定到某个范围。 固定可防止在非生产环境中验证更新之前自动升级捆绑包版本。
    • 在完全支持的捆绑包版本中提供该功能后，将应用移动到使用 GA 捆绑包版本。
  • 若要随时了解捆绑更新，包括从预览版迁移到正式版，应：

支持策略

当基础捆绑包扩展的依赖项发生中断性变更或更新时，可能会出现扩展捆绑包的主要版本发布。 这些重大更改（通常在 Azure SDK 中引入）需要对捆绑包进行更新才能保持兼容。

GA 扩展捆绑的支持周期包含以下不同的阶段：

阶段 DESCRIPTION
活跃 最新版本的扩展捆绑包被视为活动版本，建议用于函数应用。
通知 Microsoft在停用扩展捆绑包或绑定扩展版本之前提供高级通知。 收到此类通知时，应开始计划将函数应用升级到支持的最新扩展捆绑包版本。 此升级可确保应用继续访问新功能、性能改进和支持。
弃用 当新的主扩展捆绑包版本正式发布时，以前的版本将进入 12 个月的弃用阶段。 这个重叠期为您在旧版本弃用之前计划、测试和升级应用提供了时间。
停用 扩展捆绑包停用后，引用特定版本的函数应用不符合新功能、安全修补程序和性能优化的条件。 仍可以创建和部署使用已停用版本的函数应用，并允许在平台上运行。 但是，必须先将 Functions 应用升级到受支持的捆绑包版本，然后才能获得支持。

可以在 Azure Functions 扩展捆绑包 GitHub 存储库中查看扩展捆绑包版本及其包含的扩展。 可以在 https://nuget.org找到单个 .NET 包。

若要了解有关绑定扩展的详细信息，请参阅 注册 Azure Functions 绑定扩展。