Azure容器应用部署

技能简介

该技能用于通过 Azure Developer CLI (azd) 将容器化应用部署到 Azure Container Apps，支持远程构建、托管身份和幂等部署。

业务背景

该技能帮助团队快速将容器化应用上线Azure Container Apps，无需本地Docker环境即可完成远程构建。通过azd工具链统一管理基础设施代码、应用配置和环境变量，实现开发、测试、生产环境的一致部署，降低运维复杂度，让业务团队专注功能迭代而非底层配置。

落地案例：某电商团队需将订单服务从虚拟机迁移至容器平台。使用该技能初始化azd项目后，编写Bicep模板创建容器应用环境和ACR仓库，启用remoteBuild避免团队成员安装Docker。通过azd env分别管理dev、staging、prod三套环境变量，执行azd up即可完成基础设施预配、镜像构建与服务部署，新成员10分钟内即可独立完成首次上线。

能做什么

• 初始化 azd 项目并生成 azure.yaml 配置
• 编写 Bicep 基础设施代码创建容器应用环境
• 配置 ACR 远程构建，避免本地 Docker 依赖
• 管理本地/.azure/Bicep 三层环境变量
• 排查 azd up 部署失败问题

使用说明

1. 安装 Azure Developer CLI
   参考官方文档安装 azd：winget install Microsoft.Azd（Windows）或 brew install azure/azd/azd（macOS）
2. 登录与初始化

   azd auth login
   azd init                    # 创建 azure.yaml 和 .azure/ 文件夹
   azd env new <env-name>      # 创建环境（dev、staging、prod）
   azd up                      # 预配基础设施 + 构建 + 部署

3. 配置 azure.yaml
   最小配置示例：

   name: my-project
   services:
     backend:
       project: ./src/backend
       language: python
       host: containerapp
       docker:
         path: ./Dockerfile
         remoteBuild: true

4. 设置环境变量

   azd env set AZURE_OPENAI_ENDPOINT "https://my-openai.openai.azure.com"

   Bicep 输出自动写入 .azure/<env>/.env

输入与输出

见下方输入与输出表格。

风险提示

• 手动在 Portal 添加的自定义域名可能在重新部署时丢失，需用 hooks 备份恢复
• remoteBuild 为 true 时，确保 ACR 已存在且有推送权限
• 环境变量默认值语法 ${VAR=default} 仅在 main.parameters.json 中支持
• 多服务部署时，服务名称需与 Bicep 模块输出名称匹配

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/thegovind/azd-deployment/SKILL.md
来源类型：GitHub 仓库