从Azure容器注册表向Azure Function部署Docker容器的CD流程故障

问题场景 #

通过Azure DevOps实现Docker容器化Azure Function的持续部署：

• 代码提交至Azure DevOps触发CI流水线，成功将镜像推送至Azure容器注册表（ACR）
• CD流水线尝试自动更新Azure Function时失败，出现部署错误且Function内无代码显示
• 仅手动修改Azure Function部署中心的镜像标签，才能完成有效部署

排查与修复步骤 #

1. 镜像标签一致性校验 #

• 确保CI流水线推送ACR的镜像标签（如$(Build.BuildId)）与CD流水线部署时指定的标签完全一致
• 在CD流水线的部署任务中，添加步骤打印镜像完整路径（echo $(ACR_NAME).azurecr.io/$(IMAGE_NAME):$(TAG)），验证是否与ACR中存在的镜像匹配
• 避免使用易冲突的标签（如latest），建议使用唯一的构建ID或Git提交哈希作为标签

2. ACR权限验证 #

• 确认Azure Function的系统分配身份（或用户分配身份）已被授予ACR的AcrPull角色权限
• 检查部署中心的容器配置：确保ACR服务器地址、身份验证方式（托管身份/用户名密码）配置正确
• 若使用用户名密码，确认凭据未过期且拥有ACR的拉取权限

3. CD部署任务配置检查 #

• 使用Azure DevOps的Azure Function App on Container Deploy任务时，确认：
  • App Type选择Function App on Linux (Docker)
  • Docker Image填写完整的ACR镜像路径（含标签）
  • 若使用部署槽，勾选Deploy to slot并指定正确的槽名称，避免槽配置冲突
• 不要在单次部署任务中同时修改镜像和应用设置，拆分任务分步执行以排除冲突

4. 部署日志分析 #

• 登录Azure门户，进入目标Function App，查看「部署中心」→「日志」中的详细错误信息
• 查看「日志流」中的容器启动日志，排查镜像拉取失败、启动命令错误、端口不匹配等问题

5. 镜像有效性测试 #

• 本地拉取ACR镜像并运行，验证容器是否能正常启动，确认Function代码已正确打包进镜像
• 检查Dockerfile：确保启动命令为func start，端口配置与Azure Function的设置一致（默认80）

内容的提问来源于stack exchange，提问作者Daniela