部署Azure Docker Compose Web服务时如何替换不支持的build属性？

Azure Docker Compose Web服务计划确实不支持直接在docker-compose.yml中使用build属性，核心解决思路是预先构建镜像并推送到容器注册表，再用image属性替代build，具体步骤如下：

1. 准备容器注册表 #

优先选用Azure Container Registry（ACR），和Azure服务集成更顺畅；也可使用Docker Hub等第三方注册表。若用ACR，需先在Azure中完成注册表实例的创建。

2. 构建服务镜像 #

在本地或CI/CD环境中，对每个需要构建的服务执行docker build命令，同时打上包含注册表地址的镜像标签：

docker build -t <你的ACR名称>.azurecr.io/<服务镜像名>:<版本号> ./<服务源码目录>

示例：构建名为web-api的服务，源码在./api目录，ACR名称为myacr，版本号用v1：

docker build -t myacr.azurecr.io/web-api:v1 ./api

需传递构建参数时，添加--build-arg：

docker build --build-arg ENV=production -t myacr.azurecr.io/web-api:v1 ./api

3. 推送镜像到注册表 #

先登录目标注册表：

• 登录ACR：az acr login --name <你的ACR名称>（需提前安装并登录Azure CLI）
• 登录Docker Hub：docker login docker.io

执行推送命令：

docker push <你的ACR名称>.azurecr.io/<服务镜像名>:<版本号>

4. 修改Docker Compose文件 #

删除原有的build配置块，替换为image属性，指向已推送的镜像地址。

原Compose示例（含build）： #

services:
  web-frontend:
    build: ./frontend
    ports:
      - "80:80"
  web-api:
    build: ./api
    ports:
      - "5000:5000"

修改后的Compose示例（用image替代）： #

services:
  web-frontend:
    image: myacr.azurecr.io/web-frontend:v1
    ports:
      - "80:80"
  web-api:
    image: myacr.azurecr.io/web-api:v1
    ports:
      - "5000:5000"

5. 配置注册表访问权限 #

若使用ACR，推荐通过托管标识授予拉取权限：

1. 进入Web应用→身份→系统分配身份，确保状态为“开启”
2. 进入ACR实例→访问控制（IAM）→添加角色分配，选择AcrPull角色，将Web应用的托管标识作为成员添加

若使用第三方注册表，需在Web应用的配置→应用设置中添加DOCKER_REGISTRY_SERVER_USERNAME和DOCKER_REGISTRY_SERVER_PASSWORD两个配置项，对应注册表的账号密码。

6. 部署修改后的Compose文件 #

使用Azure CLI执行部署命令：

az webapp deploy --resource-group <你的资源组名称> --name <Web应用名称> --compose-file docker-compose.yml

也可直接在Azure门户的Web应用→部署中心→Docker Compose选项中上传修改后的docker-compose.yml完成部署。

额外注意事项 #

• 镜像版本号建议使用Git commit哈希或语义化版本，避免因镜像缓存导致部署内容不一致
• 多服务应用需确保每个服务的镜像都正确推送，且Compose文件中的image地址完全匹配
• 可结合Azure DevOps或GitHub Actions实现自动化构建、推送镜像及部署更新

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