如何解决Docker构建时无法复制宿主机/opt下文件的问题？

错误原因 #

你判断的没错，Docker的COPY指令只能读取构建上下文目录（即执行docker build时最后指定的目录，这里是当前目录.）内的文件/子目录，宿主机的/opt这类外部路径不在构建上下文范围内，所以会提示文件不存在。

解决方案 #

根据你的场景（SDK存放在宿主机/opt供多用户共享），推荐以下几种实用方法：

方法1：将SDK临时复制到构建上下文（简单直接）

• 先把共享的SDK复制到Dockerfile所在目录：

  cp /opt/my-sdk.tar.gz ./
  

• 修改Dockerfile的COPY指令：

  RUN mkdir /sdk
  COPY my-sdk.tar.gz /sdk/
  RUN cd /sdk && tar xvf my-sdk.tar.gz
  

• 重新执行构建命令：

  docker build -t myImage .
  

缺点：需要复制文件，多用户使用时可能会有多个副本，适合临时场景

方法2：使用--build-context指定额外上下文（推荐，适合共享场景）

Docker 23.0及以上版本支持通过--build-context参数将宿主机的任意路径加入构建上下文，无需复制文件：

• 不用修改原Dockerfile的RUN指令，仅修改COPY部分：

  RUN mkdir /sdk
  COPY --from=sdk my-sdk.tar.gz /sdk/
  RUN cd /sdk && tar xvf my-sdk.tar.gz
  

• 执行构建时指定sdk上下文指向宿主机/opt：

  docker build --build-context sdk=/opt -t myImage .
  

优点：完全保留SDK的共享位置，无需复制，适合多用户共用的场景

方法3：使用BuildKit挂载宿主机路径（无需修改上下文）

利用Docker BuildKit的挂载功能，在构建阶段临时挂载宿主机/opt目录到容器内：

• 修改Dockerfile：

  RUN mkdir /sdk
  # 临时挂载宿主机/opt到容器的/host-opt目录，完成拷贝后自动卸载
  RUN --mount=type=bind,source=/opt,target=/host-opt \
      cp /host-opt/my-sdk.tar.gz /sdk/ && \
      cd /sdk && tar xvf my-sdk.tar.gz
  

• 执行构建命令（如果BuildKit未默认开启，需加环境变量）：

  DOCKER_BUILDKIT=1 docker build -t myImage .
  

优点：无需移动或复制SDK文件，构建完成后挂载自动消失，不影响镜像内容

注意事项 #

• 不要直接使用COPY /opt/my-sdk.tar.gz /sdk，因为Docker会把这个绝对路径解析为构建上下文内的绝对路径，而非宿主机的/opt。
• 方法2要求Docker版本≥23.0，可通过docker --version查看版本。
• 方法3依赖BuildKit，目前Docker默认已开启，若未开启可通过设置环境变量DOCKER_BUILDKIT=1启用。

内容的提问来源于stack exchange，提问作者Clément