Docker容器内访问构建目录文件方法及脚本执行失败排查

一、脚本找不到的原因 #

你的Dockerfile出现./setup-python.sh: not found错误，核心原因是ADD指令不会解析shell环境变量：

• RUN指令中的$HOME会被shell（如/bin/sh）解析为root用户主目录/root；
• 但ADD ./setup-python.sh $HOME/里，Docker引擎不会把$HOME当成变量解析，而是直接将脚本复制到当前WORKDIR下的$HOME子目录中（默认WORKDIR为/时，脚本实际路径是/$HOME/setup-python.sh）；
• 后续RUN cd $HOME && ./setup-python.sh切换到了/root目录，但脚本根本不在这个目录，因此提示找不到。

另外两个次要可能性（优先级低于路径问题）：

• 脚本文件setup-python.sh不在Dockerfile所在的构建上下文目录中，导致ADD指令未完成复制；
• 脚本无执行权限，但这种情况错误提示会是Permission denied而非not found。

二、修复方法 #

你可以通过以下方式修正：

1. 使用绝对路径替代$HOME #

直接指定目标路径为/root/，避免变量解析问题：

FROM ubuntu:20.04
RUN echo "HOME is $HOME"
ADD ./setup-python.sh /root/
RUN cd /root && ./setup-python.sh

2. 先设置WORKDIR为root主目录 #

将工作目录切换到/root，后续ADD的文件会直接存入该目录：

FROM ubuntu:20.04
WORKDIR /root
RUN echo "HOME is $HOME"
ADD ./setup-python.sh .
RUN ./setup-python.sh

3. 补充：确保脚本有可执行权限 #

如果脚本本身无执行权限，复制后可通过RUN指令添加权限：

FROM ubuntu:20.04
WORKDIR /root
ADD ./setup-python.sh .
RUN chmod +x ./setup-python.sh && ./setup-python.sh

三、容器内访问构建目录文件的方法 #

Docker构建时的上下文目录（Dockerfile所在根目录）中的文件，无法被容器直接访问，必须通过以下方式引入：

• 使用COPY或ADD指令：将上下文目录中的文件复制到容器指定路径，容器内进程即可通过该路径访问；
  示例：COPY ./python-setup.py /app/ 会把上下文目录的python-setup.py复制到容器/app/目录；
• 构建阶段通过RUN指令处理：如果仅在构建过程中需要使用上下文文件，复制后可直接在RUN指令中调用；
• 注意：构建上下文的文件会被Docker引擎读取，建议通过.dockerignore排除无关文件，减少上下文大小。

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