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

将消耗计划迁移到 Flex 消耗计划

本文介绍如何将现有函数应用从 消耗计划 迁移到 Flex Consumption 计划。 对于大多数应用来说,迁移过程都很简单。 从Windows迁移的应用还必须兼容Linux,可能需要修改代码。

重要

在消耗计划中托管 Linux 上函数应用的支持将于 2028 年 9 月 30 日停用。 截至目前,尚未对 Linux 消耗计划进行功能和语言方面的增强。 请按照本文所述步骤,将消耗计划应用迁移到 Flex 消耗计划中运行。 若要详细了解 Linux 消耗计划终止支持日期,请参阅 Azure Functions 消耗计划托管(旧版)。

迁移方法

本文支持在适用于 Linux 和 Windows 应用的 Flex Consumption 计划中迁移到 Linux 函数应用。 Functions 提供了多种方法来简化大多数迁移步骤,尤其是适用于 Linux 应用。

下表显示了可用于每个操作系统的迁移方法,本文对此进行了介绍。

迁移方法 DESCRIPTION Linux Windows
GitHub Copilot 中的 Azure 技能 让Copilot以交互式方式引导和自动化您的迁移。 ✅ ✅
CLI 迁移命令 使用 az functionapp flex-migration 进行自动迁移。 ✅ ❌
标准 CLI 命令 使用Azure CLI命令进行分步迁移。 ➖ ✅
Azure 门户 Azure 门户中的分步迁移。 ✅ ✅
基础结构即代码 使用 ARM 模板、Bicep文件或 Terraform 创建可重复的迁移代码。 ➖ ➖

✅ 支持和精选 | ➖ 支持,未精选 | ❌ 不支持

若要查看应用的正确说明,请选择文章顶部的操作系统。

你可以在Azure技能库中查看Linux消费迁移工作流程和Windows消费迁移工作流程。

可以预期什么

迁移消耗计划应用所需的特定步骤取决于操作系统和特定的迁移方法:

通过使用先决条件设置 GitHub Copilot,然后使用“开始迁移”中的提示。 Copilot 会引导你完成评估、Windows 到 Linux 代码准备、目标创建与配置、部署、验证以及生产切换。 它会在需要时征求你的意见或请求你的批准。

以下章节将解释检查和迁移任务供参考。 按照 Copilot 工作流操作时,无需执行手动 CLI 步骤或门户中的步骤。

Copilot 在评估和复制过程中保持源应用只读。 对源触发器、设置、应用状态或资源的更改需要对具体操作的明确批准。

无论迁移方法如何,迁移的一般原则如下:

  • 检查代码兼容性。 对于支持的语言版本上的 Linux 应用,通常不需要修改代码。 Windows 应用在运行 Linux 前还必须移除 Windows 特定的依赖。 本指南可帮助你检查。
  • 必须创建新应用。 迁移过程会与现有应用一起创建新的 Flex Consumption 应用,因此可以在切换之前进行测试。
  • 使用相同的资源组。 新应用在同一资源组中运行,可以访问相同的依赖项。
  • 你可以控制计时。 在重定向流量并停用旧应用之前,请彻底测试新应用。

注释

如果你使用的是 Azure 政府版,目前还不能参加 Flex 消耗计划。 现在请查看本指南,以便在可用时准备就绪。

迁移到 Flex 消耗的优点

当你迁移兼容应用时,你的函数会获得以下好处:

  • 更快的冷启动:始终就绪的实例意味着函数响应速度更快。
  • 更好的缩放:按函数缩放和并发控制可提供更多控制。
  • 虚拟网络支持:将函数连接到专用网络并使用专用终结点。
  • 积极投资:新功能和改进最先在 Flex 消耗计划中推出。

有关详细信息,请参阅 灵活消费计划优势 和 托管计划比较。

基于资源的部署

本文未明确说明如何使用基础结构即代码(IaC)进行迁移。 然而,可以按照相同的迁移步骤转换 ARM 模板、Bicep 文件和 Terraform 配置。

Flex Consumption 计划在 functionAppConfig 资源定义中引入了新的 Microsoft.Web/sites 部分,该定义取代了多个旧版应用设置。 有关这些更改的详细信息,请参阅 Flex 消耗计划弃用。

这些资源可帮助你开始使用 Flex 消耗资源部署:

成功迁移后, 更新资源部署文件 以匹配新的 Flex Consumption 配置。

先决条件

  • 访问包含一个或多个要迁移的函数应用的 Azure 订阅。 用于执行迁移任务的帐户必须具有以下权限:

    • 创建和管理函数应用和应用服务托管计划。
    • 向托管标识分析角色。
    • 创建和管理存储帐户。
    • 创建和管理 Application Insights 资源。
    • 访问应用的所有依赖资源,例如Azure 密钥保管库、Azure 服务总线或Azure 事件中心。

    在资源组中分配 所有者 或 参与者 角色通常提供足够的权限。

  • 若要使用Azure CLI或GitHub Copilot进行迁移,

    • Azure CLI 2.77.0 或更高版本。 使用Azure CLI命令时是必需的。 脚本在 Azure Cloud Shell 中使用 Azure CLI进行测试。
    • 通过运行 az login 登录到Azure CLI。 请确保登录到包含要迁移的函数应用的订阅。
    az extension add --name resource-graph
    
  • 若要使用 GitHub Copilot进行迁移,请在所需模式下配置GitHub Copilot:

    1. 安装 Copilot CLI

    2. 如果尚未登录Azure CLI:

      az login
      

      请确保登录到包含要迁移的函数应用的订阅。

    3. 启动Copilot CLI:

      copilot
      
    4. 添加市场来源(仅第一次):

      /plugin marketplace add microsoft/azure-skills
      
    5. 安装插件:

      /plugin install azure@azure-skills
      
    6. 安装后,重新加载模型上下文协议(MCP)服务器:

      /mcp reload
      
    7. 验证安装:

      /mcp show
      

      您应该会看到带有复选标记的 Azure 插件。 该工具 functionapp 是此插件的一部分。

    小窍门

    如果 Copilot 指向错误的订阅,则要求其使用特定的订阅 ID。 可以通过运行 az account show --query id -o tsv来查找订阅 ID。 如果Copilot连接到错误的Azure租户,请在进行Azure调用时要求Copilot使用特定的租户 ID。 可以通过运行 az account show --query tenantId -o tsv来查找租户 ID。

确定要迁移的潜在应用

小窍门

已经知道要迁移哪个应用了? 可以跳过本部分,直接转到 “评估现有应用”。

如果你有多个函数应用,并且不确定需要迁移哪些应用,本部分将帮助你找到它们。 获取应用名称、资源组、位置和运行时堆栈的列表。

若要启动扫描订阅并提示你选择要迁移的应用的交互式迁移,请使用以下提示:

migrate my linux function apps in azure from consumption to flex consumption

Copilot标识符合条件的 Linux 消耗应用,让你选择要迁移的应用,然后引导你完成每个应用的评估、应用创建、配置和部署。 继续 迁移步骤。

如果只想查看哪些应用符合条件而不启动迁移,请改用以下提示:

list my linux consumption apps eligible for flex consumption migration

Copilot返回符合条件的和不符合资格的应用列表,以及任何不兼容的原因。 然后,可以使用 “开始迁移 Linux”中的提示来迁移特定应用。

要在不开始迁移的情况下识别订阅中的 Windows Consumption 应用,请使用此提示:

What Windows Consumption Function Apps can I upgrade to Flex Consumption?

Copilot 会发现候选应用,并检查其区域、运行时、部署配置及其他兼容性要求。 Discovery 可识别候选对象,但并不保证每个应用都已准备好迁移。 在继续之前,请查看评估结果。

要迁移特定应用,请使用 开始迁移 中的提示。

评估现有应用

Azure技能会自动为你执行这些任务。 使用Azure技能时,直接转到 启动迁移。

在迁移之前,请运行此快速清单,确保应用准备就绪。 大多数应用都会通过这些检查,而不会出现问题:

使用Copilot时,请在不创建目标应用的情况下请求评估:

Assess whether my Windows Consumption Function App <APP_NAME> is ready to migrate to Flex Consumption.

用你的源应用名替换 <APP_NAME> 。 Copilot 生成兼容性评估,记录阻碍和所需准备。 对于 Windows 应用,也要检查 Windows 特定的代码依赖。

确认区域兼容性

确认目前支持的 Flex 消耗计划与要迁移的消耗计划处于同一区域。

已确认: 当 az functionapp flex-migration list 命令输出或 Copilot 评估将你的应用列入 eligible_apps 列表中时,说明当前 Linux 消耗计划应用所在区域支持 Flex 消耗计划。 在这种情况下,可以继续 验证语言堆栈兼容性。

需要执行的操作: 当输出在列表中包括你的应用 ineligible_apps 时,你会看到一条错误消息,指出 The site '<name>' is not in a region supported in Flex Consumption. Please see the list of regions supported in Flex Consumption by running az functionapp list-flexconsumption-locations。 在这种情况下,您当前的 Linux 消费应用所使用的区域不支持弹性消费计划。

Copilot 会检查源应用所在区域是否支持 Flex Consumption,并将结果记录在评估中。 如果不支持该区域,先确认选择的位置再创建目标应用。

如果区域当前不受支持,但仍选择迁移函数应用,则应用必须在支持 Flex Consumption 计划的其他区域中运行。 但是,在其他连接服务的不同区域中运行应用可能会带来额外的延迟。 在完成迁移之前,请确保新区域能够满足应用程序的性能要求。

验证语言堆栈兼容性

Flex 消耗计划并不支持所有的 Functions 语言堆栈。 此表指示当前支持哪些语言堆栈:

堆栈设置 堆栈名称 已支持
dotnet-isolated .NET(隔离工作器模型) ✅ 是
node JavaScript/TypeScript ✅ 是
java Java ✅ 是
python Python ✅ 是
powershell PowerShell ✅ 是
go Go ✅ 是
dotnet .NET(进程内模型) ❌ 否
custom 自定义处理程序 ✅ 是

已确认: 如果 az functionapp flex-migration list 命令或者 Copilot 评估包含你的应用在 eligible_apps 列表中,Linux 消耗应用已经在 Flex Consumption 中使用受支持的语言堆栈,你可以继续验证堆栈版本兼容性。

需要执行的操作: 如果输出中将您的应用包含在 ineligible_apps 列表中,并显示一条错误消息 Runtime '<name>' not supported for function apps on the Flex Consumption plan.,则表示 Linux 消费型应用未运行 Flex Consumption 支持的运行时。

如果函数应用使用不受支持的运行时堆栈:

Copilot 在评估时读取源运行时和 Functions 主机版本。 对于不受支持的辅助角色运行时或版本 4 以外的 Functions 主机版本,需要在迁移前做好准备。

验证堆栈版本兼容性

在迁移之前,请确保您的应用程序在当前区域的 Flex Consumption 计划中运行时,支持其运行时堆栈版本。

已确认:如果 az functionapp flex-migration list 命令或 Copilot 评估在 eligible_apps 列表中包含你的应用,说明你的 Linux 消耗计划应用已使用 Flex 消耗支持的语言堆栈版本,你可以继续验证部署槽位的使用情况。

需要执行的操作: 如果输出在列表中包括您的应用 ineligible_apps ,并显示 Invalid version {0} for runtime {1} for function apps on the Flex Consumption plan. Supported versions for runtime {1} are {2}.一条错误信息,则说明您的 Linux 消费型应用未运行 Flex Consumption 兼容的支持运行时。

Copilot 将源语言版本与目标区域中 Flex Consumption 支持的版本进行比较。 当Azure配置缺失或模糊时,它会使用项目或部署包的元数据;当证据中没有明确支持的版本时,会要求你选择目标版本。

如果函数应用使用不受支持的语言堆栈版本,请先 将应用代码升级到受支持的版本 ,然后再迁移到 Flex Consumption 计划。

验证部署槽位使用情况

消耗计划应用可以定义部署槽位。 有关详细信息,请参阅 Azure Functions 部署槽位。 但是,Flex 消耗计划目前暂不支持部署槽。 在迁移之前,请确定应用是否具有部署槽位。 如果确实如此,请制定相应的策略,以便在 Flex 消耗计划中运行时,无需部署槽位,即可管理你的应用程序。

已确认:当前应用启用部署槽位时,az functionapp flex-migration list 命令或 Copilot 评估会在 eligible_apps 列表中显示函数应用,而不会发出警告。 继续 验证证书的使用。

需要执行的操作: 当前应用已启用部署槽位,输出会在 eligible_apps 列表中显示函数应用,但会添加一条警告,指出: The site '<name>' has slots configured. This condition doesn't block migration, but please note that slots aren't supported in Flex Consumption.

Copilot 检测源部署槽并在评估中记录。 由于 Flex Consumption 不支持槽位,建议在继续之前选择如何整合其功能或使用独立应用。

如果函数应用当前正在使用部署槽位,则当前无法在 Flex Consumption 计划中重现此功能。 在迁移之前,请考虑以下选项:

  • 重新架构应用程序以使用单独的函数应用。 这样,您可以将函数代码进行开发、测试和部署至第二个非生产应用,而无需使用部署槽。
  • 将任何新代码或功能从部署槽迁移到主(生产)槽。

验证证书的使用

Flex Consumption 计划通过 站点范围证书模型支持 TLS/SSL 证书。 与其他托管计划不同,在同一区域和资源组中的应用之间共享证书时,Flex Consumption 证书的范围限定为每个应用。 如果现有应用使用证书,请注意以下差异:

  • Flex 消费计划中不使用 WEBSITE_LOAD_CERTIFICATES 应用设置。 相反,您可以通过使用门户中的 “可供应用代码访问” 开关,让您的代码可以访问每个证书。 有关详细信息,请参阅 使证书可供代码访问。
  • 由于 Flex Consumption 在 Linux 上运行,因此代码必须从文件路径加载证书(公用证书使用 /var/ssl/certs,私用证书使用 /var/ssl/private),而不能从 Windows 证书存储中加载证书。
  • 每个应用最多支持三个专用证书和三个公共证书(.cer)。

已确认:如果 az functionapp flex-migration list 命令或 Copilot 评估在 eligible_apps 列表中包含你的应用,则你的 Linux Consumption 应用兼容,你可以继续验证 Blob 存储触发器。 如果应用使用证书,则需要在迁移后将其添加到新应用。

需执行的操作:如果输出在 ineligible_apps 列表中列出了你的应用,并显示证书相关错误,请查看 站点作用域的证书注意事项,并确认你的应用能够在这些证书限制内正常运行。

Copilot 会对源应用使用的证书进行盘点,并检查站点范围的证书限制。 它不会自动转移证书。 通过使用站点范围证书流程重新添加所需的证书,并更新读取 Windows 证书存储的代码,使其使用 Linux 证书文件路径。

如果应用使用证书,请计划在迁移完成后使用 站点范围的证书流程将这些证书重新添加到新的 Flex Consumption 应用中。 确保应用的证书需求符合 站点范围内的限制 (每个应用 3 个专用 + 3 个公共)。

验证 Blob 存储触发器

目前,Flex 消耗计划针对 Azure Blob 存储仅支持基于事件的触发器,这些触发器使用 Source 的 EventGrid 设置进行定义。 该计划不支持使用容器轮询且使用 Source 设置为 LogsAndContainerScan 的 Blob 存储触发器。 由于容器轮询是默认设置,因此您必须确定您的任何 Blob 存储触发器是否使用了默认的 LogsAndContainerScan 源设置。 有关详细信息,请参阅 Blob 容器触发器。

确认:如果az functionapp flex-migration list命令或 Copilot 评估在 eligible_apps 列表中包含你的应用,则说明你的 Linux Consumption 应用没有使用轮询 Blob 存储触发器。 可以继续 考虑依赖服务。

需要执行的操作: 如果输出的列表中包含你的应用 ineligible_apps ,并显示 The site '<name>' has blob storage triggers that don't use Event Grid as the source: <list> Flex Consumption only supports Event Grid-based blob triggers. Please convert these triggers to use Event Grid or replace them with Event Grid triggers before migration.一条错误消息,则 Linux 消耗应用与 Flex Consumption 不兼容。

Copilot 通过类型识别 Blob 触发绑定,并标记未将源显式指定为 EventGrid 的任何触发器。 它指导部署前所需的代码更改和事件订阅设置。

如果您的应用程序有任何没有事件网格源的 Blob 存储触发器,您必须在迁移到 Flex Consumption 计划之前将其更改为事件网格源。

重要

在转换轮询 Blob 触发器之前,请确认事件网格能够到达目标函数应用的事件传递端点。 Event Grid 推送交付不支持通过私有端点进行传递。 如果目标仅为私有,迁移前应解决事件传递架构;仅靠虚拟网络集成无法提供来自 Event Grid 的入站连接能力。

将现有 Blob 存储触发器更改为事件网格源的基本步骤包括:

  1. 在 Blob 存储触发器定义中添加或更新 source 属性为 EventGrid,然后重新部署应用程序。

  2. 在事件订阅使用的函数应用中生成终结点 URL。

  3. 在 Blob 存储容器上创建事件订阅。

有关详细信息,请参阅 教程:使用事件订阅在 blob 容器上触发 Azure Functions。

检查 Windows 专用代码依赖

Flex Consumption 运行在 Linux 上。 检查你的应用是否包含仅限 Windows 的 API、包、本地二进制文件、Windows 专用路径和大小写假设、PowerShell 模块以及 Windows 证书存储访问。 针对 .NET Framework 或以 Windows 运行时标识符发布的应用也需要准备。

Flex Consumption 不支持 PowerShell 托管依赖。 迁移前,将所有必需的 PowerShell 模块打包在你的应用程序的根 Modules 文件夹中,并确认这些模块支持 Linux。 单靠 requirements.psd1 文件并不能在目标应用上安装模块。 更多信息请参见 PowerShell依赖管理。

在评估过程中,Copilot 会提供启发式依赖扫描。 尽可能提供本地源目录或已检出的仓库。 如果源码不可用,Copilot 可以检索已部署的包,但编译产物可能会限制扫描覆盖范围。 扫描并不全面,你负责验证Linux兼容性。

在部署到新应用之前,构建并验证任何必要的代码变更。 如果你无法移除所需的 Windows 依赖项,可以考虑选择使用 Windows 上的高级计划,而不是 Flex 消耗。

考虑依赖服务

小窍门

简单的仅限 HTTP 的应用? 如果函数仅使用 HTTP 触发器,并且不连接到其他Azure服务,则可能跳过本部分的大部分内容。 只需记住在迁移后更新您的任何客户端以指向新应用的 url。

由于Azure Functions是计算服务,因此请考虑迁移对应用上游和服务的影响。

数据保护策略

若要在迁移期间同时保护上游和下游数据,请使用以下策略:

  • 幂等性:确保函数可以多次安全地处理相同的消息,而不会产生负面影响。 有关详细信息,请参阅 为相同输入设计的 Azure Functions。
  • 日志记录和监视:若要跟踪消息处理,可在迁移期间在这两个应用中启用详细的日志记录。 有关详细信息,请参阅 Azure Functions 中的 Monitor 执行。
  • 检查点:对于事件中心触发器等流式处理触发器,实施正确的检查点行为来跟踪处理位置。 有关详细信息,请参阅 Azure Functions 可靠事件处理。
  • 并行处理:请考虑在直接转换期间暂时并行运行这两个应用。 请务必仔细监视和验证如何从上游服务处理数据。 有关详细信息,请参阅 用于复原的自定义多区域解决方案。
  • 逐步切换:对于大容量系统,请考虑通过逐步将部分流量重定向到新应用来实现切换。 可以使用 Azure API 管理 或 Azure 应用程序网关 等服务管理来自应用的上游请求的路由。

按触发器类型进行的缓解

规划缓解策略以保护应用中特定函数触发器的数据:

触发器 数据风险 策略
Azure Blob 存储 高 在新应用中为基于事件的触发器创建单独的容器。
运行新应用后,将客户端切换为使用新容器。
允许在停止旧应用之前完全处理原始容器。
Azure Cosmos DB 高 为新应用专门创建专用租约容器。
将此新的租用容器设置为新应用中的 leaseCollectionName 配置。
需要函数是幂等或必须能够处理副本更改源处理的结果。
将 StartFromBeginning 配置在新应用中设置为 false 以避免重新处理整个数据流。
Azure 事件网格 中等 在新应用中重新创建相同的事件订阅。
要求 函数具有幂等性,或者你必须能够处理由于重复事件处理而产生的结果。
Azure 事件中心 中等 创建新的 使用者组 供新应用使用。 有关详细信息,请参阅 事件网格触发器的迁移策略。
Azure 服务总线 高 创建新主题或队列供新应用使用。
将发送者和客户端更新为使用新主题或队列。
原始主题为空后,关闭旧应用。
Azure 存储 队列 高 创建新队列供新应用使用。
将发送者和客户端更新为使用新队列。
原始队列为空后,关闭旧应用。
HTTP 低 请记住,在迁移后将客户端和其他应用或服务切换为面向新的 HTTP 终结点。
计时器 低 在直接转换期间,确保偏移两个应用之间的计时器计划,避免两个应用同时执行任务。
在新应用成功运行后,禁用旧应用中的计时器触发器。

预迁移任务

在创建新的 Flex Consumption 应用之前,请收集有关当前应用的一些信息。 此步骤可确保在转换过程中不会丢失任何设置。

使用 Copilot 时,技能会在迁移工作流中清点此配置。 请审查其发现和决策,而不是再次运行这些手动命令。

小窍门

此步骤主要是复制粘贴工作。 从现有应用收集设置,以便你可以将其应用到新应用。

在迁移之前完成这些任务:

收集应用设置

如果计划从应用设置使用相同的触发器和绑定源和其他设置,请先记下现有消耗计划应用中的当前应用设置。

Copilot 会审核应用设置名称,但不会显示机密值。 它会询问是否复制过滤过的源设置,或者暂缓处理这些设置,以便配置隔离的目标依赖。 如果你推迟这些设置,部署将等待,直到所需的目标配置准备就绪。

谨慎

应用设置经常包含密钥和其他共享机密。 始终安全地存储应用程序设置,理想情况下是加密的。 为了提高安全性,在新的 Flex Consumption 计划应用中将Microsoft Entra ID身份验证与托管标识配合使用,而不是共享机密。

收集应用配置

其他应用配置存在于应用设置之外。 从现有应用捕获这些配置,以便可以在新应用中正确重新创建它们。

查看这些设置。 如果当前应用中存在其中任何一个,请决定是否在新的 Flex Consumption 计划应用中重新创建它们:

配置 设置 注释
CORS 设置 cors 确定客户端可能需要的任何现有跨域资源共享 (CORS) 设置。
自定义域 如果应用当前使用*.azurewebsites.net以外的域,需要将该自定义域映射替换为新应用的映射。
HTTP 版本 http20Enabled 确定应用是否需要 HTTP 2.0。
仅 HTTPS httpsOnly 确定访问应用是否需要 TSL/SSL。
传入的客户端证书 clientCertEnabled
clientCertMode
clientCertExclusionPaths
设置使用证书进行身份验证的客户端请求的要求。
横向扩展上限 WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 设置横向扩展实例的上限。 默认值为 200。 此值在应用设置中找到,但在 Flex Consumption 计划应用中,它会改为添加为网站设置(maximumInstanceCount)。
最低入站 TLS 版本 minTlsVersion 设置应用所需的最低 TLS 版本。
最低入站 TLS 密码 minTlsCipherSuite 为应用设置最低 TLS 密码要求。
已挂载的 Azure 文件共享 azureStorageAccounts 确定应用中是否存在任何显式装载的文件共享(仅限 Linux)。
SCM 基础身份验证发布凭据 scm.allow 确定 scm 发布站点是否已启用。 虽然出于安全性考虑不建议使用,但某些发布方法需要它。

注释

没有后量子TLS的收集或迁移设置。 minTlsVersion 控制最低接受的TLS协议版本,并 minTlsCipherSuite 控制密码套件的选择。 这两个属性都不控制用于密钥交换的 TLS 支持的组。 支持 TLS 1.3 和混合组的客户端可以自动与平台前端协商 X25519MLKEM768;不支持该组的客户端则使用支持的经典密钥交换。 详情请参见 Azure 应用服务 中的 Post-quantum hybrid key exchange。

Copilot 可以清点站点设置、缩放限制、CORS、自定义域及其他配置。 它记录了评估中未支持或手动处理的项目。 对于此次 Windows 迁移,显式 Azure 文件存储装载元数据仅用于清点。

识别托管标识和基于角色的访问权限

在迁移之前,记录应用是依赖于系统分配的托管标识还是任何用户分配的托管标识。 确定授予这些身份的基于角色的访问控制(RBAC)权限。 必须在新应用中重新创建系统分配的托管标识和任何角色分配。 可以在新应用中重复使用用户分配的托管标识。

Copilot 盘点系统分配和用户分配的托管身份及其角色分配。 它利用这份清单配置目标的身份标识,并重新创建对相应资源的访问权限。

标识内置身份验证设置

迁移到 Flex Consumption 之前,请收集有关任何内置身份验证配置的信息。 如果希望应用使用相同的客户端身份验证行为,则必须在新应用中重新创建它们。 有关详细信息,请参阅 Azure Functions 中的 认证和授权。

请特别注意重定向 URI、允许的外部重定向和令牌设置,以确保经过身份验证的用户顺利过渡。

Copilot 会清点已启用的提供程序和身份验证行为,同时不会泄露提供程序机密。 它识别特定目标的回调URI,并在代码部署前指导提供者的配置。 它不会自动复制提供程序注册或机密。

入站访问限制

可以在消耗计划中设置应用的 入站访问限制 。 你可能希望在新应用中维护这些限制。 对于定义的每个限制,请确保捕获以下属性:

  • IP 地址或 CIDR 范围
  • 优先级值
  • 操作类型(允许/拒绝)
  • 规则的名称

Copilot 会清点并重新创建兼容的访问限制。 它并不会自动削弱这些限制,以确保部署运行状况检查或 HTTP 验证能够成功。

在 Flex Consumption 计划中运行时,可以重新创建这些基于 IP 的入站限制。 可以通过实施其他网络限制(例如虚拟网络集成和入站专用终结点)进一步保护应用。 有关详细信息,请参阅虚拟网络集成。

开始迁移

重要

如果所选主机或部署存储账户禁用共享密钥访问,或者您的组织需要无密钥存储访问,请配置托管身份认证,并为主机存储和部署存储配置所需的角色分配。 本文描述的基本基于CLI的创建流程使用存储连接字符串。 先使用密钥创建应用、之后再转换,无法满足在预配期间禁止共享密钥身份验证的要求。 更多信息请参见 基于身份的主机存储连接 和 配置部署设置。

如果在 “标识” 部分中使用了发现提示,则技能已评估、创建和配置新的 Flex Consumption 应用。 可以跳过本部分并继续 迁移步骤。

如果已知道要迁移的应用,请使用以下提示:

migrate my app <APP_NAME> to flex consumption

技能会自动处理评估、应用创建和配置迁移 , 相当于 az functionapp flex-migration start 命令及其验证步骤。

成功启动迁移后,继续 获取代码部署包。

如果已知道要迁移的应用,请使用以下提示:

Migrate my Windows Consumption Function App <APP_NAME> to Flex Consumption.

用你的源应用名替换 <APP_NAME> 。 Copilot 展示迁移计划,进行评估、清点配置,并随源应用创建新的 Flex 消耗应用。

默认情况下,工作流程会建议将 <APP_NAME>-flex 用作目标应用名称。 Copilot 会让你在创建目标应用前,选择是重用源存储账户、创建新账户,还是使用特定现有账户。 你可以请求不同的目标名称,或者在提示词中说明你的存储偏好。 请仔细检查存储选择,因为共享依赖可能会让两个应用处理相同的事件。

Copilot 会检查所选存储账户是否允许共享密钥身份验证,并询问仅标识策略要求。 如果不允许基于密钥的创建,Copilot 会在创建目标应用前暂停。 在同一订阅中,使用身份优先的基础设施即代码为此次迁移预配一个空的 Flex Consumption 应用。 配置主机和部署存储的托管身份访问、所需角色分配及监控。 暂时不要部署函数代码。 有关配置示例,请参见 Flex Consumption infrastructure-as-code示例。

返回目标的完整 Azure 资源 ID 和保存的进度文件路径。 Copilot 会验证现有目标,并在你批准后恢复配置和部署,无需创建新的应用。 使用此提示:

Resume the Flex Consumption migration for <APP_NAME> using progress at <PROGRESS_FILE_PATH>.
I provisioned a keyless target at <TARGET_RESOURCE_ID>. Use that existing target; do not create another app.

部署前,Copilot 帮助完成 Windows 到 Linux 的代码准备、目标配置、内置认证以及非 HTTP 触发安全。 然后,它通过更新的流水线、本地项目或兼容的部署包提供部署。

默认情况下,Copilot 会在.azure-upgrade/<SOURCE_APP_NAME>/upgrade-status.md中记录进度。 要继续,请使用此提示:

Resume the Flex Consumption migration for <APP_NAME>.

获取代码部署包

若要重新部署应用,需要项目的源文件或部署包。 理想情况下,可以在源代码管理中维护项目文件,以便轻松地将函数代码重新部署到新应用。 如果有源代码文件,可以跳过本部分并继续捕获性能基准(可选)。

如果不再有权访问项目源文件,可以从Azure中的现有消耗计划应用下载当前部署包。 部署包的位置取决于是在 Linux 上运行还是Windows运行。

Linux 上的消费计划应用将在以下位置之一存储部署 zip 包文件:

  • 默认主机存储帐户(scm-releases)中名为 AzureWebJobsStorage 的Azure Blob 存储容器。 此容器是 Linux 上的消耗计划应用的默认部署源。

  • 如果应用具有 URL 形式的 WEBSITE_RUN_FROM_PACKAGE 设置,则包位于你维护的外部可访问位置。 外部包应托管在具有受限访问权限的 Blob 存储容器中。 有关详细信息,请参阅 外部包 URL。

小窍门

如果将存储帐户限制为仅允许托管标识访问,则可能需要将 Azure 帐户添加到 Storage Blob Data Reader 角色中,以授予 Azure 帐户对存储容器的读取权限。

部署包使用 squashfs 格式进行压缩。 若要查看包内的内容,必须使用可解压缩此格式的工具。

使用以下步骤从当前应用下载部署包:

Copilot迁移技能尝试将现有代码项目下载并重新部署到新应用。 如果不成功,该过程将指导你在迁移工作流中获取并部署你的代码包。 可以跳过本部分并继续执行 迁移步骤。

项目源文件的位置取决于 WEBSITE_RUN_FROM_PACKAGE 应用设置,如下所示:

WEBSITE_RUN_FROM_PACKAGE 值 源文件位置
1 这些文件位于存储在由 WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 设置定义的存储帐户Azure 文件存储共享中的 zip 包中。 此设置 WEBSITE_CONTENTSHARE 定义文件共享的名称。
终结点 URL 这些文件位于你维护的外部可访问位置的 zip 包中。 外部包应托管在具有受限访问权限的 Blob 存储容器中。 有关详细信息,请参阅 外部包 URL。

Copilot 首先要求本地源目录。 如果源不可用,它会提示从源应用的内容共享或外部包 URL 中检索已部署的包。 它检查该软件包是否适合 Linux 和 Flex Consumption 使用;针对 Windows 的构建需要提前准备,而非直接重新部署。

捕获性能基准(可选)

如果计划根据迁移到 Flex Consumption 计划来评估应用中的性能提升,请考虑记录当前计划的性能基准。 然后,你可以将它们与在 Flex Consumption 计划中运行的应用的相同基准进行比较。

小窍门

始终比较类似条件下的性能,例如一天、一周中的时间和客户端负载。 尽可能一切运行两个基准。

下面是一些用于结构化性能测试的基准:

建议的基准 注释
冷启动 测量从第一个请求到空闲时间段后的第一个响应的时间。
吞吐量 使用 负载测试工具 测量每秒的最大请求数,以确定应用如何处理并发请求。
延迟 在各种负载条件下,跟踪P50、P95和P99的响应时间。 可以在 Application Insights 中监视这些指标。

使用此 Kusto 查询查看 Application Insights 中建议的延迟响应时间:

requests
| where timestamp > ago(1d)
| summarize percentiles(duration, 50, 95, 99) by bin(timestamp, 1h)
| render timechart

迁移步骤

若要将函数从 Consumption 计划应用程序迁移到 Flex Consumption 计划应用程序,请执行以下主要步骤:

验证 Flex Consumption 应用是否已创建和配置

运行 az functionapp flex-migration start 命令后,请验证是否已成功并正确配置新的 Flex Consumption 应用。 下面是验证迁移结果的一些步骤:

Copilot迁移技能会在迁移过程中自动验证新应用。 如果在启动 Linux 迁移中使用 Copilot 提示开始迁移,该功能已验证应用是否正确创建和配置。 可以跳过本部分并继续 配置内置身份验证。

查看迁移摘要

自动迁移命令传输大多数配置。 但是,手动验证是否已迁移这些项目。 可能需要手动配置它们:

  • 证书:使用站点范围证书流程,将 TLS/SSL 证书重新添加到 Flex Consumption 应用中。
  • 部署槽位:在 Flex 消耗中不受支持。
  • 内置身份验证设置:需要手动重新配置这些设置。
  • CORS 设置:可能需要根据配置手动验证这些设置。

如果缺少或不正确任何关键设置,请使用本文Windows迁移过程部分中概述的步骤手动配置这些设置。

计划的最终审核

在继续迁移过程之前,请花点时间执行以下最后的准备步骤:

使用Copilot时,请在批准目标创建和部署前,审查评估、配置清单、代码变更、部署选择和触发安全决策。 成功的仅验证迁移并不意味着生产流量或触发器已直接转换。

  • 查看所有收集的信息:浏览前面评估和预迁移部分中记录的所有备注、配置详细信息和应用程序设置。 如果什么都不清楚,请再次运行Azure CLI命令,或从门户获取信息。

  • 定义迁移计划:根据你的发现,为迁移创建一个清单,其中突出显示了:

    • 需要特别注意的任何设置
    • 在迁移过程中可能影响的触发器和绑定或其他依赖项
    • 迁移后验证的测试策略
    • 如果出现意外问题,则回滚计划
  • 停机时间规划:考虑何时停止原始函数应用以避免数据丢失和重复处理事件,以及此迁移如何影响用户或下游系统。 在某些情况下,可能需要在停止整个应用之前 禁用特定函数 。

仔细的最终评审有助于确保迁移过程更顺利,并最大程度地降低忽略重要配置的风险。

在弹性消耗计划中创建应用

可以通过各种方式在 Flex Consumption 计划中创建函数应用以及其他必需的Azure资源:

创建选项 参考文章
GitHub Copilot 在开始迁移步骤中使用 Windows 提示。 Copilot 会确认目标资源,并作为引导工作流程的一部分创建应用。
Azure CLI 创建 Flex 消耗应用
Azure 门户 在 Azure 门户中创建函数应用
基础结构即代码 ARM 模板
azd
Bicep
Terraform
Visual Studio Code Visual Studio Code 部署
Visual Studio Visual Studio 部署

小窍门

如果可能,请使用Microsoft Entra ID进行身份验证,而不是包含共享密钥的连接字符串。 使用托管标识是一种最佳做法,通过消除直接在应用程序设置中存储共享机密的需要,从而提高安全性。 如果原始应用使用了连接字符串,则 Flex Consumption 计划支持托管标识。 其中大多数链接介绍了如何在函数应用中启用托管标识。

在新应用中应用已迁移的设置

在部署代码之前,请使用原始函数应用中的相关 Flex Consumption 计划应用设置配置新应用。

重要

在 Flex Consumption 计划中运行时,并非所有消耗计划应用设置都受支持。 有关详细信息,请参阅 Flex 消耗计划弃用。

批准后,Copilot 会复制支持的应用设置,但不会显示或持久保存原始机密值。 它保留了目标拥有的存储和 Application Insights 设置。 它还会审查 Linux 上所需的从 : 到 __ 的名称转换,如果源名称映射不明确就会停止。

应用其他应用配置

查找 在预迁移期间收集 的旧应用中的其他应用配置列表,并在新应用中设置这些配置。

注释

没有后量子TLS设置可以应用。 Consumption 和 Flex Consumption 应用都采用与兼容客户端的平台管理协商;迁移证书或自定义域名不会改变后量子密钥交换资格。 最低TLS和密码套件设置无法控制支持的组。 详情请参见 Azure 应用服务 中的 Post-quantum hybrid key exchange。

Copilot 会从库存中应用兼容的站点配置并验证目标。 未受支持的设置和需要手动操作的项目仍是明确的后续工作,而非被静默复制。

配置缩放和并发设置

Flex 消耗计划使用按函数缩放。 应用中的每个函数都根据其工作负荷独立缩放。 缩放更严格地与并发设置相关。 这些设置有助于根据当前的并发执行做出缩放决策。 有关详细信息,请参阅 Flex Consumption 计划文章中的 按函数缩放 和 并发性。

如果希望新的应用能够像最初的应用一样扩展,请仔细考虑并发设置。 设置更高的并发值可能会导致创建更少的实例来处理相同的负载。

如果在原始应用中设置自定义横向扩展限制,则可以将其应用到新应用。 否则,请跳到下一部分。

默认的最大实例计数为 100。 将其设置为介于 1 和 1,000 之间的值。

注释

减少 HTTP 函数应用的最大实例计数至低于 40 可能会导致频繁的请求失败,并在流量超过容量时延长限流窗口。 此设置仅适用于可接受有限横向扩展且经过完全测试的高级方案。

Copilot 会在应用前将任何源的最大横向扩展设置与支持的 Flex 消耗范围进行核对。 如果源没有设置自定义限制,它会保留目标默认值。 迁移后复审针对工作负载的并发调优。

配置任何自定义域和 CORS 访问权限

如果原始应用具有任何绑定的自定义域或 CORS 设置,请在新应用中重新创建它们。 有关自定义域的详细信息,请参阅 在 Azure 应用服务。

Copilot 重新创建兼容的 CORS 配置并指导自定义域设置。 任何对源绑定、DNS 或生产路由的更改都需要单独审批;创建目标应用并不会完成流量切换。

配置托管标识并分配角色

如何在新应用中配置托管标识取决于托管标识的类型:

托管标识类型 创建标识 角色分配
用户分配 可选 可以继续在新应用中使用相同的用户分配的托管标识。 必须将这些标识重新分配给 Flex Consumption 应用,并验证它们是否仍然在远程服务中具有正确的角色分配。 如果选择为新应用创建新标识,则必须分配与现有标识相同的角色。
系统分配 是的 由于每个函数应用都有自己的系统分配托管标识,因此必须在新应用中启用系统分配的托管标识,并重新分配与原始应用中相同的角色。

正确重新创建角色分配是确保函数应用在迁移后对Azure资源具有相同访问权限的关键。

小窍门

如果原始应用使用连接字符串或其他共享机密进行身份验证,则通过切换到对托管标识使用Microsoft Entra ID身份验证来提高应用的安全性是一个很好的机会。 更多信息请参见 Azure Functions 中的“配置远程服务连接”。

  • 系统分配
  • 用户分配

Copilot 为目标启用系统分配的身份,并为新主体重新创建所需的角色分配。 它根据目标资源验证访问,而不是重复使用源身份主体。

配置网络访问限制

如果原始应用有任何基于 IP 的入站访问限制,请重新创建要保留在新应用中的任何相同入站访问规则。

小窍门

Flex Consumption 计划 完全支持虚拟网络集成。 由于此支持,还可以在迁移后使用入站私有终结点。 有关详细信息,请参阅专用终结点。

Copilot 会重建兼容的源访问限制并验证这些限制。 如果这些限制阻止了直接的HTTP测试,它会将验证记录为延迟,而不是自动打开访问。

启用监视

在开始使用 Flex 消耗计划运行新应用之前,确保已启用 Application Insights。 配置 Application Insights 时,可以排查在代码部署和启动过程中出现的任何问题。

实施涵盖应用指标、日志和成本的综合监视策略。 使用此策略,可以验证迁移的成功,快速识别任何问题,并优化新应用的性能和成本。

如果计划将此新应用与当前应用进行比较,请确保方案还会收集所需的比较基准。 有关详细信息,请参阅 “配置监视”。

使用Copilot时,该技能会在部署前验证目标的Application Insights配置。 它在源使用 Microsoft Entra 认证采集时保留该采集方式,并在部署后验证遥测数据。

配置内置身份验证

如果原始应用使用了内置客户端身份验证(有时称为 Easy Auth),请在新应用中重新创建它。 如果计划重复使用相同的客户端注册,请确保在身份验证提供程序中设置新应用的经过身份验证的终结点。

适用于 Linux 的Copilot迁移技能不会自动执行内置身份验证配置。 使用 Azure CLI 或 Azure 门户选项卡手动重新创建身份验证设置。

Copilot 指导在目标上逐个提供商进行配置和验证。 您必须通过门户、包含机密的现有设置或 密钥保管库 引用直接配置提供程序机密,并注册目标回调 URI。 如果认证被延迟,Copilot 会在部署代码前停止,避免目标在未认证的情况下暴露之前受保护的端点。

将应用代码部署到新的 Flex Consumption 资源

根据原始应用的设置配置新的 Flex Consumption 计划应用后,请将代码部署到Azure中的新应用资源。

谨慎

部署成功后,新应用中的启用触发器可以立即开始处理连接服务的数据。 若要最大程度地减少重复数据并在启动新应用并关闭原始应用时防止数据丢失,请查看 触发器类型在缓解中定义的策略。

部署前,Copilot 会对每个触发器进行分类,并建议禁用可能处理生产事件或按计划运行的非 HTTP 函数。 如果你批准禁用,它会在部署前写入并验证禁用设置,部署后再验证有效功能状态。 HTTP 功能保持启用,因为必须将客户端重定向到新的主机名。

无法在 Linux 上通过按函数的应用设置禁用包含连字符 (-) 的函数名称。 对于这些功能,Copilot 需要单独的安全决策:隔离依赖、重命名和重新打包、批准源优先切换,或明确接受主动处理。 它不会把无效的禁用标志视为保护。

在 HTTP 切换前规划好功能键处理。 新应用有自己的 Host 键和功能键。 对于使用这些密钥的调用者,要么保留兼容的源主机和 HTTP 函数密钥,要么在重定向流量之前,更新调用者以使用目标应用的密钥。 Copilot 会询问使用哪种策略,如果你选择保留,部署后会复制并验证所选密钥。 在切换前,针对目标端点验证已认证的请求。

Copilot 不会复制 _master 键或由扩展管理的系统按键。 分别更新需要目标生成的系统密钥的 webhook 集成。 保留客户端密钥意味着在两个应用共存期间,这些凭证可同时为这两个应用提供授权。

使用 Copilot 时,可以选择是更新 CI/CD 流水线、发布准备好的本地项目,还是部署已检索到的兼容软件包。 验证后,Copilot 会引导生产切换,并在更改源应用前征求明确批准。

Functions 提供了多种方式来部署代码,无论是从代码项目还是作为现成的部署包进行部署。

小窍门

如果在源代码存储库中维护项目代码,现在是配置持续部署管道的最佳时机。 通过持续部署,可以根据连接的存储库中的更改自动部署应用程序更新。

更新现有部署工作流,将源代码部署到新应用:

  • 使用 Azure Pipelines
  • 使用 GitHub Actions

还可以为新应用创建新的持续部署工作流。 有关详细信息,请参阅 Azure Functions 的连续部署。

迁移后的任务

🎉 祝贺! 应用现在在 Flex Consumption 上运行。 若要充分利用新计划,请考虑以下可选后续任务:

验证基本功能

  1. 验证新应用是否在 Flex Consumption 计划中运行:

    Copilot迁移技能在部署后验证你的新应用,包括其托管计划和功能状态。 当有意的访问限制阻止访问时,HHTTP 测试可以继续保持推迟状态。 在生产切换前,审查任何延期的测试并验证非 HTTP 处理。 如果需要重新验证,请使用以下提示:

    verify my flex consumption app <APP_NAME> is running correctly
    
  2. 使用 HTTP 客户端在新应用上至少调用一个 HTTP 触发器终结点,以确保它按预期响应。

记录性能基准

运行新应用后,运行从原始应用收集的相同性能基准,例如:

建议的基准 注释
冷启动 测量从第一个请求到空闲时间段后的第一个响应的时间。
吞吐量 使用 负载测试工具 测量每秒的最大请求数,以确定应用如何处理并发请求。
延迟 在各种负载条件下,跟踪P50、P95和P99的响应时间。 可以在 Application Insights 中监视这些指标。

使用此 Kusto 查询查看 Application Insights 中建议的延迟响应时间:

requests
| where timestamp > ago(1d)
| summarize percentiles(duration, 50, 95, 99) by bin(timestamp, 1h)
| render timechart

注释

弹性消耗计划指标不同于消耗计划指标。 在迁移前后比较性能时,请记住,必须使用不同的指标来跟踪类似的性能特征。 有关详细信息,请参阅 “配置监视”。

创建自定义仪表板

通过使用 Azure Monitor 指标和 Application Insights,可以在 Azure 门户中创建仪表板,这些仪表板显示来自平台指标以及运行时日志和分析的图表。

请考虑在 Azure 门户中针对关键指标设置仪表板和警报。 有关详细信息,请参阅 在 Azure 中监控您的应用。

优化计划设置

迁移的实际性能改进和成本影响可能会因特定于应用的工作负载和配置而异。 弹性消耗计划提供了多个设置,你可以调整这些设置来优化应用的性能。 你可能想要进行调整,以更紧密地匹配原始应用的行为,或平衡成本与性能。 有关详细信息,请参阅 Flex Consumption 文章中的 微调应用 。

更新资源部署文件

如果使用 Bicep 或 Terraform 管理函数应用基础结构,请更新部署文件,将目标计划调整为 Flex 消耗计划。 本部分介绍消耗与弹性消耗计划资源定义之间的主要区别。

重要

你无法就地将现有消耗层级应用转换为 Flex 消耗层级。 在部署 Flex Consumption 等效项之前,需要使用新名称创建新资源或删除现有资源。

主要差异

在将资源部署从按需迁移到弹性消耗时,请考虑以下重要更改:

方面 消耗计划 Flex 消耗计划
托管计划 SKU Y1 (动态) FC1 (FlexConsumption)
需要计划 可选(自动创建) 必需(必须明确指明)
操作系统 Windows或 Linux 仅限 Linux
配置 应用设置 functionAppConfig 部分
存储内容共享 WEBSITE_CONTENTSHARE 设置 deployment.storage 中的 functionAppConfig

以下示例演示消耗与弹性消耗计划资源定义之间的主要差异。 它们使用系统分配的托管标识,但尚未完全实施。 它们不包括所有必需的资源,例如存储帐户、Application Insights 或所有必要的角色分配。 有关完整、可投入生产使用的示例,请查看 Flex Consumption IaC 示例。

消耗计划(之前):

// Consumption plan (optional - auto-created if omitted)
resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  location: location
  sku: {
    name: 'Y1'
    tier: 'Dynamic'
  }
  properties: {
    reserved: true // Linux
  }
}

resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
  name: functionAppName
  location: location
  kind: 'functionapp,linux'
  properties: {
    serverFarmId: hostingPlan.id
    siteConfig: {
      linuxFxVersion: 'DOTNET-ISOLATED|8.0'
      appSettings: [
        { name: 'FUNCTIONS_EXTENSION_VERSION', value: '~4' }
        { name: 'FUNCTIONS_WORKER_RUNTIME', value: 'dotnet-isolated' }
        { name: 'AzureWebJobsStorage__accountName', value: storageAccount.name }
        { name: 'WEBSITE_CONTENTAZUREFILECONNECTIONSTRING__accountName', value: storageAccount.name }
        { name: 'WEBSITE_CONTENTSHARE', value: functionAppName }
        { name: 'APPLICATIONINSIGHTS_CONNECTION_STRING', value: appInsights.properties.ConnectionString }
        { name: 'APPLICATIONINSIGHTS_AUTHENTICATION_STRING', value: 'Authorization=AAD' }
      ]
    }
  }
  identity: {
    type: 'SystemAssigned'
  }
}

弹性消费计划(之后):

// Flex Consumption plan (required)
resource hostingPlan 'Microsoft.Web/serverfarms@2023-12-01' = {
  name: hostingPlanName
  location: location
  sku: {
    name: 'FC1'
    tier: 'FlexConsumption'
  }
  kind: 'functionapp'
  properties: {
    reserved: true
  }
}

// Deployment storage container (required)
resource deploymentContainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2023-05-01' = {
  name: '${storageAccount.name}/default/deployments'
}

resource functionApp 'Microsoft.Web/sites@2023-12-01' = {
  name: functionAppName
  location: location
  kind: 'functionapp,linux'
  properties: {
    serverFarmId: hostingPlan.id
    functionAppConfig: {
      deployment: {
        storage: {
          type: 'blobContainer'
          value: '${storageAccount.properties.primaryEndpoints.blob}deployments'
          authentication: {
            type: 'SystemAssignedIdentity'
          }
        }
      }
      scaleAndConcurrency: {
        maximumInstanceCount: 100
        instanceMemoryMB: 2048
      }
      runtime: {
        name: 'dotnet-isolated'
        version: '8.0'
      }
    }
    siteConfig: {
      appSettings: [
        { name: 'AzureWebJobsStorage__accountName', value: storageAccount.name }
        { name: 'APPLICATIONINSIGHTS_CONNECTION_STRING', value: appInsights.properties.ConnectionString }
        { name: 'APPLICATIONINSIGHTS_AUTHENTICATION_STRING', value: 'Authorization=AAD' }
      ]
    }
  }
  identity: {
    type: 'SystemAssigned'
  }
}

注释

将 APPLICATIONINSIGHTS_AUTHENTICATION_STRING 与 Authorization=AAD 配合使用时,还必须将 Monitoring Metrics Publisher 角色分配给 Application Insights 资源上的函数应用的托管标识。

有关完整的 Bicep 示例,请参阅 Flex 消耗层级 Bicep 示例。

迁移后协调资源部署

如果使用基础结构即代码来管理Azure资源部署,请在迁移到 Flex Consumption 后更新部署文件,以防止配置偏移。 下面是建议的方法:

  1. 不要混合手动部署和基于资源的部署:如果使用Azure CLI或门户在迁移期间创建 Flex Consumption 应用,请在下一部署之前更新资源文件。 否则,你的部署可能会尝试重新创建旧的消耗层级资源。

  2. 更新资源名称或使用生命周期管理:由于你无法就地将消耗层级应用转换为 Flex 消耗层级,因此有两个选项:

    • 新的资源名称:更新部署代码以使用托管计划和函数应用的新名称。 此方法使旧资源保持不变,直到确信迁移成功。
    • 导入现有资源:如果要保留相同的名称,请先删除旧资源,然后让部署创建新的 Flex Consumption 资源。 或者,使用 terraform import 将手动创建的资源导入 Terraform 状态或引用 Bicep 中的现有资源。
  3. 验证状态对齐:更新部署文件后,运行计划或预览操作(terraform plan 或 az deployment group what-if)以确认不会发生意外更改。

  4. 更新 CI/CD 管道:如果部署管道引用旧的消耗计划配置,请更新它们以使用新的 Flex Consumption 资源定义和部署方法。

小窍门

若要最大程度地减少中断,请考虑在过渡期间并行运行旧的消耗应用和新 Flex Consumption 应用。 更新部署以管理新的 Flex Consumption 应用,验证它是否正常工作,然后从Azure和部署文件中删除旧的消耗应用资源。

删除原始应用(可选)

小窍门

别着急。 在验证所有功能是否正常工作时,请保留您的原始应用几天或几周。 消耗计划仅收取实际使用费用,因此保留旧应用(禁用触发器)的成本很少。

如果确信新应用正常工作,可以清理原始应用。 此步骤是可选的 - 某些团队将旧应用保留为引用或回滚选项。

重要

此操作将删除原始函数应用程序。 如果其他应用使用它,消耗计划将保持不变。 在继续之前,请确保:

  • 成功将所有功能迁移到新的 Flex Consumption 应用。
  • 验证没有流量被定向到原先的应用。
  • 备份可能需要引用的任何相关日志、配置或数据。

Copilot 迁移 skill 可以在生产切换和目标验证完成后移除原始应用。 如果准备工作被推迟或源头仍在处理生产工作负载,请保留源应用。 Copilot始终要求在删除任何内容之前进行显式确认。 使用此提示:

delete my original consumption app <ORIGINAL_APP_NAME>

故障排除和恢复策略

大多数迁移完成时不会出现问题。 如果某些内容无法按预期工作,请尝试以下常见问题的解决方案:

問题 解决方案
冷启动性能问题 • 查看并发设置
• 检查缺少的依赖项
缺少绑定 • 验证扩展捆绑包
• 更新绑定配置
权限错误 • 检查标识分配和角色权限
网络连接问题 • 验证访问限制和网络设置
缺少 Application Insights • 重新创建 Application Insights 连接
应用无法启动 请参阅 常规故障排除步骤
触发器不处理事件 请参阅 常规故障排除步骤

如果在迁移生产应用时遇到问题,请在进行故障排除时考虑将迁移回滚到原始应用。

常规故障排除步骤

对于新应用无法启动或函数触发器未处理事件的情况,请使用以下步骤:

  1. 在 Azure 门户的新应用页面中,选择应用页面左窗格中的诊断并解决问题。 依次选择“可用性和性能”、“函数应用关闭或报告错误”检测器。 有关详细信息,请参阅 Azure Functions 诊断概述。

  2. 在应用页中,选择“ 监视>Application Insights>查看 Application Insights 数据 ”,然后选择“ 调查>失败 ”并检查是否存在任何故障事件。

  3. 选择监视>日志并运行此 Kusto 查询以检查这些表是否存在错误:

    traces
        | where severityLevel == 3
        | where cloud_RoleName == "<APP_NAME>"
        | where timestamp > ago(1d)
        | project timestamp, message, operation_Name, customDimensions
        | order by timestamp desc
    

    在这些查询中,将 <APP_NAME> 替换为新应用的名称。 这些查询用于检查过去一天中出现的错误(where timestamp > ago(1d))。

  4. 返回应用页,选择“设置>”,并验证是否已正确传输所有关键应用程序设置。 查找可能未正确迁移的任何已弃用设置,或者查找任何拼写错误或不正确的连接字符串。 验证 默认主机存储连接。

  5. 选择“设置标识”>,然后仔细检查预期标识是否存在,以及它们是否分配给正确的角色。

  6. 在代码中,确保所有绑定配置正确,特别注意连接字符串名称、存储队列和容器名称,以及事件中心触发器中的使用者组设置。

关键生产应用的回滚步骤

如果无法解决问题,请考虑在继续进行故障排除时还原到原始应用。

  1. 如果原始应用已停止,请重启它:

    请求 Copilot 重启原始应用程序并恢复迁移。

    restart my original consumption app <ORIGINAL_APP_NAME>
    
  2. 如果创建新的队列、主题或容器,请确保将客户端重定向回原始资源。

  3. 如果修改了 DNS 或自定义域,请将这些更改还原为指向原始应用。

提供反馈

如果使用本文遇到迁移问题或想要提供有关本指南的其他反馈,请使用以下方法之一获取帮助或提供反馈: