你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
请使用本指南,从传统的 Functions on Azure 容器应用 V1 托管模型迁移到推荐的 Functions on Azure 容器应用 V2 托管模型。 你了解迁移的原因、哪些更改以及如何以最小风险执行转换。
注释
使用 Azure Functions on Azure 容器应用 v1 迁移助手,帮助将功能应用从 v1 模型迁移到 v2 模型。
可以使用两种部署模型在 Azure 容器应用中托管 Azure Functions:
Functions on Azure 容器应用 V1:旧版代理模型,使用 Function App(
Microsoft.Web资源提供程序)以及一个在后台运行的容器应用。Azure 容器应用 V2 上的 Functions:创建单个带
kind=functionapp的 Azure 容器应用资源 (Microsoft.App) 的原生部署模型。
当你迁移到 Azure 容器应用 V2 上的 Functions,你会简化管理,解锁原生功能,并与 Azure Functions 的未来路线图保持一致。
模型比较
| Area | Azure 容器应用上的 Functions V1(旧版) | Azure 容器应用 上的 Functions V2(推荐) |
|---|---|---|
| 资源模型 | 与隐藏容器应用配对的代理函数应用 | 单个本机容器应用(kind=functionapp) |
| 原生功能 (修订、机密、运行状况探测、自定义域、挎斗) |
不支持 | 已支持 |
| 缩放控件 (冷却,轮询间隔) |
受限制 | 全面容器应用扩展选项 |
| 日志记录和故障排除 | 间接。 无实时控制台 | 直接。 包括实时日志和诊断 |
| Dapr 集成 | 在某些孤立的 .NET 场景中有问题 | 通过标准模式支持 |
| 身份验证(简易身份验证) | 不可用 | 可用 |
| 证书和自定义域 | 不可用 | 可用 |
| 指标和警报 | 基本 | 完整的本地度量指标和警报 |
| 未来的路线图 (函数列表、键、调用计数) |
未规划 | 已计划 |
| 操作复杂性 | 双资源管理 | 单个资源 |
| 建议用于新部署 | 否 | 是的 |
Azure 容器应用 V1 上函数的限制
Azure 容器应用 V1 上的函数存在若干限制,影响可扩展性、管理和功能可用性。 理解这些限制有助于澄清迁移到 Azure 容器应用 V2 上的 Functions 的好处。
功能差距
以下功能在 Azure 容器应用 V1 应用中不可用:
- 轻松身份验证
- 健康探测
- 自定义域
- 挎斗容器
- 托管证书
- 容器应用机密
- 粒度缩放设置
- 多版本流量分割
故障排除限制条件
对于 Azure 容器应用 V1 应用上的 Functions,你无法直接访问容器,也无法获得实时控制台输出。 相反,建议使用Log Analytics进行基础设施诊断,使用Application Insights进行应用日志。
Dapr 集成问题
由于依赖项和初始化排序约束,Dapr 和 .NET 隔离函数在生成或运行时期间可能会发生冲突。
Azure 容器应用 V2 上的 Functions 的优势
Azure 容器应用 V2 上的函数直接创建一个原生容器应用资源。 此方法会删除代理间接,并启用完整的 Azure 容器应用功能。
主要优势:
- 为身份负载分流启用简易验证。
- 配置运行状况探测以提高系统弹性。
- 设置自定义域并使用托管证书。
- 使用单个资源减少运营开销。
- 以原生方式存储机密并挂载挎斗容器。
- 获取更清晰的指标、警报和实时日志流式处理。
- 使用多版本部署并安全地分流流量。
- 应用精细缩放规则(轮询间隔、冷却)。
注释
不需更改代码。 可以重复使用现有的容器映像。
旧版直接映像部署(不受支持)
某些部署使用标准容器应用,不使用 kind=functionapp 且手动运行函数映像。
重要
不支持此方法。 它缺乏自动扩展规则,也无法接收即将推出的 Azure 容器应用 V2 平台功能,如函数列表、密钥和调用计数。
推荐:迁移至Azure 容器应用 v2的Functions。
先决条件
迁移前:
- Azure 订阅和创建资源的权限。
- [Azure CLI](/cli/azure/install-azure-cli-windows?view=azure-cli-latest(最新版本)已安装。
- 所需的扩展:
az extension add --name containerapp(az extension add --name functionapp如果适用)。 - 访问你在 Azure 容器应用 V1 部署中使用的容器镜像。
- 环境变量、机密、存储绑定和网络设置的清单。
迁移过程
1. 准备
- 确认你当前的部署是 Functions on Azure 容器应用 V1 应用。
- 导出所有配置数据,包括环境变量、机密、连接字符串和自定义绑定。
- 查看环境配额(CPU、内存、最大实例),并根据需要进行调整。
- 确认注册表中的映像可用性。
2. 创建一个 Functions on Azure 容器应用 V2 应用
创建或重复使用 Azure 容器应用环境。
使用同一映像部署新的 Azure 容器应用 V2 上的 Functions 应用。
az containerapp create \ --name my-func-v2 \ --resource-group <RESOURCE_GROUP_NAME> \ --environment <ENVRONMENT_NAME> \ --image myregistry.azurecr.io/<IMAGE_NAME>:<TAG_NAME> \ --kind functionapp \ --ingress external --target-port <TARGET_PORT>重新应用配置详细信息,包括机密、环境变量、标识、网络。
根据需要启用身份验证或自定义域。
根据需要定义缩放规则(HTTP、CPU、队列触发器的关联)。
3. 验证
调用 HTTP 触发的函数(curl 或浏览器)。
测试每个触发器类型(事件中心、服务总线、计时器)。
确认 Application Insights 的遥测数据和 Log Analytics 的日志。
检查负载下的缩放行为(自动缩放规则触发)。
验证机密和连接字符串是否解析正确。
确认运行状况探测状态和容器修订详情。
4.更新 DNS 或自定义域(可选)
如果你使用的是自定义域,请将其映射到 Azure 容器应用 V2 上新版 Functions 的主机名(CNAME 或 A 记录)。
重新绑定 SSL/TLS 证书(托管或上传)。
测试域解析和 TLS 握手。
在内部通报终结点的更改。
5. 迁移
转移生产流量(更新 DNS TTL 或路由规则)。
监视延迟、错误和调用计数。
根据需要调整缩放参数(冷却、最小/最大实例)。
跟踪日志,记录前几个小时的异常现象。
6. 清理
停用旧版 Azure 容器应用 上的 Functions V1 应用及相关资源。
注意
在删除之前,请确认不再有任何生产流量仍指向 Azure 容器应用 V1 上的 Functions 终结点。
删除未使用的机密或存储引用。
更新内部文档和操作手册。
验证清单
| Item | 通过标准 |
|---|---|
| 触发器触发 | 所有配置的触发器都成功执行 |
| 日志和遥测 | Application Insights 显示函数调用; 实时日志流 |
| 规模化 | 实例计数根据规则配置进行调整 |
| 身份验证(如果已启用) | 受保护的终结点返回预期的状态代码 |
| 域名 | 自定义域名解析使用有效证书 |
| Secrets | 敏感值加载时没有错误 |
运营增强功能(可选)
提高迁移后的可靠性: