如何通过构建参数动态选择基础镜像进行COPY操作？

错误根源 #

Docker传统构建引擎在解析COPY --from=base_${BUILD}时，未正确替换变量，将base_${BUILD}当作镜像名而非构建阶段名，触发镜像名格式错误。

方法1：启用Docker BuildKit构建 #

Docker BuildKit对变量解析和阶段引用的支持更完善，能正确处理动态阶段名的替换。

临时启用（单次构建） #

DOCKER_BUILDKIT=1 docker build --build-arg BUILD=default .

全局启用（永久生效） #

修改/etc/docker/daemon.json文件：

{
  "features": {
    "buildkit": true
  }
}

保存后重启Docker服务即可。

方法2：调整ARG作用域与阶段引用 #

确保BUILD参数在当前阶段被重新声明，让Docker能正确识别变量：

修改后的Dockerfile：

ARG PY_VER=3.12
ARG BUILD=default

# Build stage
FROM python:${PY_VER}-slim AS base_default
RUN pip install --no-cache-dir --upgrade gunicorn

# 可扩展其他BUILD对应的阶段，比如：
# FROM python:${PY_VER}-slim AS base_another
# RUN pip install --no-cache-dir --upgrade gunicorn flask

# Deploy stage
FROM python:${PY_VER}-slim AS deploy
# 必须在当前阶段重新声明ARG，确保变量作用域覆盖当前阶段
ARG PY_VER
ARG BUILD

# 变量拼接阶段名，BuildKit会正确解析为构建阶段
COPY --from=base_${BUILD} /usr/local/bin/gunicorn /usr/local/bin/gunicorn
COPY --from=base_${BUILD} /usr/local/lib/python${PY_VER}/site-packages/ /usr/local/lib/python${PY_VER}/site-packages/

CMD ["gunicorn", "-h"]

方法3：条件式复制（兼容旧版Docker） #

如果无法升级Docker或启用BuildKit，可通过RUN结合条件判断实现动态复制：

ARG PY_VER=3.12
ARG BUILD=default

# 定义所有可能的base阶段
FROM python:${PY_VER}-slim AS base_default
RUN pip install --no-cache-dir --upgrade gunicorn

FROM python:${PY_VER}-slim AS base_another
RUN pip install --no-cache-dir --upgrade gunicorn flask

# Deploy stage
FROM python:${PY_VER}-slim AS deploy
ARG PY_VER
ARG BUILD

# 默认复制default阶段内容
COPY --from=base_default /usr/local/bin/gunicorn /usr/local/bin/gunicorn
COPY --from=base_default /usr/local/lib/python${PY_VER}/site-packages/ /usr/local/lib/python${PY_VER}/site-packages/

# 根据BUILD参数覆盖复制对应阶段内容
RUN if [ "${BUILD}" = "another" ]; then \
    cp -r --from=base_another /usr/local/bin/flask /usr/local/bin/ && \
    cp -r --from=base_another /usr/local/lib/python${PY_VER}/site-packages/flask* /usr/local/lib/python${PY_VER}/site-packages/; \
fi

CMD ["gunicorn", "-h"]

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