Docker配置CAMISIM：为多Python脚本设置有效ENTRYPOINT

一、为什么Docker里需要用ADD/COPY移动文件？ #

Docker容器的文件系统是独立于宿主机的隔离环境，你拉取Git仓库到容器后，如果不把脚本所在目录放到容器的标准可执行路径，或者没有明确指定脚本的绝对路径，容器根本找不到这些文件。官方用ADD是为了把脚本放到容器内的固定位置（比如/usr/local/bin或工具专属目录），确保系统能定位到可执行文件。

你本地运行没问题是因为脚本在宿主机的PATH范围内，或者你是在脚本所在目录执行的，但容器默认的工作目录和PATH不一定包含Git克隆的目录。

二、加了PATH仍找不到脚本的常见原因 #

1. PATH设置时机错误：如果是在RUN命令里临时export PATH，这个环境变量不会传递到容器运行时。必须用ENV命令设置，才能让容器启动时生效。示例：

   ENV PATH="/path/to/camisim/scripts:${PATH}"
   

2. 脚本缺少可执行权限或shebang头：Python脚本如果没执行chmod +x添加权限，或者第一行没有#!/usr/bin/env python3的shebang声明，就算PATH包含该目录，直接执行脚本名也会报错。
3. 工作目录不匹配：如果脚本里用相对路径引用了依赖文件（比如配置、参考数据），就算脚本能被找到，依赖文件也会因工作目录不对而无法读取，看起来像是脚本不存在的错误。

三、多Python脚本的Docker运行方案 #

不要把ENTRYPOINT直接设为python3或单个脚本，推荐两种可行方案：

方案1：ENTRYPOINT+CMD组合调用 #

# 将CAMISIM脚本目录加入全局PATH
ENV PATH="/camisim/scripts:${PATH}"
# 把python3设为ENTRYPOINT，CMD默认指定常用脚本
ENTRYPOINT ["python3"]
CMD ["run_camisim.py"]

运行时可切换脚本：

docker run your-image another_script.py --arg1 value1

注意：确保脚本在容器的PATH范围内，或直接用绝对路径指定脚本。

方案2：用bash封装脚本做统一入口 #

创建camisim_wrapper.sh：

#!/bin/bash
# 接收脚本名和参数，用绝对路径调用对应Python脚本
python3 "/camisim/scripts/$1" "${@:2}"

然后在Dockerfile中配置：

COPY camisim_wrapper.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/camisim_wrapper.sh
ENTRYPOINT ["camisim_wrapper.sh"]
CMD ["run_camisim.py"]

运行时切换脚本：

docker run your-image another_script.py --param value

四、与Metadbgwas镜像的差异 #

Metadbgwas用主sh脚本做ENTRYPOINT能正常运行，核心原因是：

1. 它的主sh脚本本身就处理了所有子命令/脚本调用，不需要用户直接切换Python脚本；
2. 仓库内的脚本要么已添加shebang和可执行权限，要么主sh脚本用绝对路径调用了这些脚本；
3. 它的Dockerfile大概率已将脚本目录加入PATH，或者主sh脚本放在了标准可执行路径（比如/usr/local/bin）。

而CAMISIM是多个独立的Python脚本，需要用户直接调用不同脚本，所以不能像Metadbgwas那样仅靠单个主sh脚本做ENTRYPOINT，必须处理好多脚本的路径定位和调用逻辑。

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