如何实现Docker构建时的条件式COPY本地文件至镜像？

由于COPY是Docker的构建阶段指令，无法直接在RUN的shell条件分支中执行，你可以通过以下两种方案实现需求：

方案一：使用构建时绑定挂载（推荐，Docker 18.09+支持） #

这种方法无需额外脚本，直接在Dockerfile中通过构建时挂载访问本地文件，判断后选择拷贝或下载：

# 替换为你的业务基础镜像
FROM ubuntu:22.04
WORKDIR /app

# 安装文件下载工具（根据基础镜像调整，如用curl替换wget）
RUN apt-get update && apt-get install -y --no-install-recommends wget \
    && rm -rf /var/lib/apt/lists/*

# 核心逻辑：挂载本地构建上下文，判断文件存在性后执行对应操作
RUN --mount=type=bind,source=./,target=/local-build \
    if [ -f /local-build/large_package.tar.gz ]; then \
        cp /local-build/large_package.tar.gz ./; \
    else \
        wget https://your-package-url.com/large_package.tar.gz -O large_package.tar.gz; \
    fi

# 后续处理：解压、清理等操作
RUN tar -xzf large_package.tar.gz && rm large_package.tar.gz

构建命令 #

直接执行常规构建即可：

docker build .

方案二：构建参数+多阶段构建（兼容低版本Docker） #

如果你的Docker版本不支持构建时挂载，可以通过本地脚本传递参数，结合多阶段构建实现：

1. 本地构建脚本（build.sh） #

#!/bin/bash
PACKAGE_FILE="./large_package.tar.gz"
if [ -f "$PACKAGE_FILE" ]; then
    docker build --build-arg USE_LOCAL=true .
else
    docker build --build-arg USE_LOCAL=false .
fi

添加执行权限：

chmod +x build.sh

2. Dockerfile示例 #

ARG USE_LOCAL=false
ARG PACKAGE_URL="https://your-package-url.com/large_package.tar.gz"
ARG LOCAL_PACKAGE="./large_package.tar.gz"

# 第一阶段：轻量级镜像处理文件获取
FROM alpine AS package-fetcher
WORKDIR /tmp
ARG USE_LOCAL
ARG PACKAGE_URL
ARG LOCAL_PACKAGE

RUN if [ "$USE_LOCAL" = "true" ]; then \
        cp /build-context/$LOCAL_PACKAGE ./large_package.tar.gz; \
    else \
        wget $PACKAGE_URL -O large_package.tar.gz; \
    fi

# 第二阶段：正式业务镜像构建
FROM ubuntu:22.04
WORKDIR /app

# 从第一阶段拷贝已获取的包文件
COPY --from=package-fetcher /tmp/large_package.tar.gz ./

# 安装依赖并处理包
RUN apt-get update && apt-get install -y --no-install-recommends tar \
    && rm -rf /var/lib/apt/lists/* \
    && tar -xzf large_package.tar.gz && rm large_package.tar.gz

构建命令 #

执行本地脚本启动构建：

./build.sh

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