如何在Dockerfile中实现带条件判断的COPY指令执行

错误原因 #

RUN 是运行在容器内部shell环境的指令，COPY 是Docker守护进程在构建阶段执行的原生指令，二者属于不同执行上下文，因此不能在RUN的shell脚本中嵌套使用COPY指令。

解决方案 #

方案一：通用兼容方案（适配所有Docker版本） #

无需依赖额外构建特性，兼容性最高：

• 先将目标目录内容统一复制到容器内临时路径
• 在RUN指令中根据构建参数判断，将临时路径下的文件移动到对应目标路径
  示例代码：

# 声明构建参数，构建时通过--build-arg传入参数值
ARG PARAM

# 统一复制源文件到临时目录
COPY /somefolder/* /tmp/somefolder/

# 按参数判断移动到对应路径
RUN if [ "$PARAM" = "dev" ]; then \
      cp -r /tmp/somefolder/* ./; \
    else \
      cp -r /tmp/somefolder/* .; \
    fi

注意：./和.在Unix系统中属于完全等价的相对路径，如果你实际场景中两个目标路径不同，替换上述代码中对应的目标路径即可。

方案二：BuildKit原生条件语法（Docker 18.09+支持） #

如果你的Docker版本>=18.09且开启了BuildKit（Docker 23.0+已默认开启），可以直接使用Dockerfile原生条件指令，构建效率更高、镜像层更干净：
示例代码：

# 首行指定支持条件语法的Dockerfile版本
# syntax=docker/dockerfile:1.4

ARG PARAM

# 原生条件判断执行对应COPY逻辑
IF [ "$PARAM" = "dev" ]
  COPY /somefolder/* ./
ELSE
  COPY /somefolder/* .
ENDIF

构建命令示例 #

构建时传入构建参数即可触发对应逻辑：
docker build --build-arg PARAM=dev .

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