Azure Pipelines构建多阶段Dockerfile指定stage跳过非依赖阶段方法

解决方案 #

你遇到的指定--target仍构建无关阶段的问题，可按以下顺序排查修复：

1. 开启Docker BuildKit构建引擎

旧版Docker默认的传统构建器不会严格裁剪依赖链，会遍历所有定义的阶段执行镜像拉取、缓存检查等操作，开启BuildKit后会严格按照目标阶段的依赖路径构建，完全跳过无关阶段。
你可以在流水线中设置环境变量开启BuildKit：

# 全局变量或者对应任务的env字段添加
variables:
  DOCKER_BUILDKIT: 1

如果是Bash任务直接运行命令，也可以在命令前加变量：

DOCKER_BUILDKIT=1 docker build --target cloud --tag $REGISTRY_NAME/$IMAGE_NAME:$TAG_NAME .

2. 排查YAML配置缩进错误

你提供的Docker任务YAML存在缩进问题，arguments字段没有正确缩进在inputs下，会导致参数不生效：

# 正确缩进示例
- task: Docker@2
  displayName: Build Docker image
  inputs:
    command: build
    repository: $(IMAGE_NAME)
    tags: $(TAG_NAME)
    arguments: '--target cloud'

3. 区分缓存复用和实际构建

如果你之前构建过dev-deps、development阶段，本地/流水线构建节点已经有对应的缓存层，日志中出现的Using cache相关行只是复用缓存，不是实际重新构建这两个阶段。你可以执行docker system prune -af清理缓存后重新构建，确认是否还会执行无关阶段的RUN/COPY等指令。

4. 确认Dockerfile阶段依赖无错误

检查cloud阶段的FROM指令是否确实指向runtime-deps，没有手误写成dev-deps或其他依赖dev阶段的镜像。

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