---

name: azd-deployment description: "使用远程构建、托管身份和幂等基础设施将容器化前端+后端应用部署到Azure Container Apps。" risk: critical source: community date_added: "2026-02-27"

Azure Developer CLI (azd) Container Apps部署

使用远程构建、托管身份和幂等基础设施将容器化前端+后端应用部署到Azure Container Apps。

快速开始

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

核心文件结构

project/
├── azure.yaml              # azd服务定义 + 钩子
├── infra/
│   ├── main.bicep          # 根基础设施模块
│   ├── main.parameters.json # 从环境变量注入参数
│   └── modules/
│       ├── container-apps-environment.bicep
│       └── container-app.bicep
├── .azure/
│   ├── config.json         # 默认环境指针
│   └── <env-name>/
│       ├── .env            # 环境特定值（azd管理）
│       └── config.json     # 环境元数据
└── src/
    ├── frontend/Dockerfile
    └── backend/Dockerfile

azure.yaml配置

最小配置

name: azd-deployment
services:
  backend:
    project: ./src/backend
    language: python
    host: containerapp
  frontend:
    project: ./src/frontend
    language: js
    host: containerapp

关键命令

| 命令 | 用途 | |------|------| | azd up | 预配 + 构建 + 部署（一体化） | | azd provision | 仅预配基础设施 | | azd deploy | 仅构建和部署应用 | | azd down | 删除所有Azure资源 | | azd env set KEY VALUE | 设置环境变量 | | azd monitor | 打开Application Insights |

远程构建

Azure Container Apps支持远程构建，无需本地Docker：

services:
  backend:
    docker:
      remoteBuild: true

托管身份

使用系统分配的托管身份进行服务间认证：

resource app 'Microsoft.App/containerApps@2023-05-01' = {
  identity: {
    type: 'SystemAssigned'
  }
}

多环境管理

azd env new dev
azd env new staging  
azd env new prod
azd env select prod    # 切换活跃环境
azd env list           # 列出所有环境