### Docker ENTRYPOINT 指令的用法 #### 什么是 ENTRYPOINT？ `ENTRYPOINT` 是 Dockerfile 中的一个指令，用于设置容器启动时默认执行的命令或脚本。它具有较高的优先级，在大多数情况下不会被轻易覆盖。 --- #### `ENTRYPOINT` 的两种形式 `ENTRYPOINT` 支持两种书写方式： 1. **Exec 形式** 这是最推荐的形式，因为它避免了 Shell 解析器的影响。 ```dockerfile ENTRYPOINT ["executable", "param1", "param2"] ``` 此种形式下，`executable` 将作为主进程运行，并接收后续传递的参数[^3]。 2. **Shell 形式** 如果需要通过 Shell 执行某些预处理逻辑，则可以采用此形式： ```dockerfile ENTRYPOINT command param1 param2 ``` 不过需要注意的是，这种方式可能会因为 Shell 环境的不同而引入不确定性[^3]。 --- #### `ENTRYPOINT` 和 `CMD` 的关系 当两者联合使用时，`CMD` 提供的内容会被当作参数追加到 `ENTRYPOINT` 命令之后。例如： ```dockerfile ENTRYPOINT ["python3", "app.py"] CMD ["--port", "8080"] ``` 在这种配置下，最终执行的实际命令为： ```bash python3 app.py --port 8080 ``` 如果在运行容器时指定了新的参数（如 `docker run my_image --port 9090`），则这些新参数会替换原有的 `CMD` 参数[^2]。 --- #### 示例：Node.js 应用的 Entry Point 脚本 以下是一个完整的 Node.js 应用示例，展示如何利用 `ENTRYPOINT` 来增强容器的功能性： ```dockerfile FROM node:16-alpine WORKDIR /app COPY package*.json ./ RUN npm install COPY . . # 创建 entrypoint.sh 并赋予可执行权限 COPY entrypoint.sh /usr/local/bin/ RUN chmod +x /usr/local/bin/entrypoint.sh ENTRYPOINT ["entrypoint.sh"] CMD ["npm", "start"] ``` 其中，`entrypoint.sh` 文件可能如下所示： ```bash #!/bin/sh # 初始化数据库连接或其他环境变量 export NODE_ENV=production # 输出日志以便调试 echo "Starting application with environment $NODE_ENV" exec "$@" ``` 在此场景中，`"$@"` 表示将所有接收到的参数原样转发给目标程序，从而实现高度灵活的行为控制[^1]。 --- #### 注意事项 - 若希望完全忽略原始的 `ENTRYPOINT` 设置并强制指定一个新的入口点，可以在运行时显式声明 `--entrypoint` 参数。例如： ```bash docker run --entrypoint="/bin/bash" my_image ``` - 在同一个 Dockerfile 中多次定义 `ENTRYPOINT` 时，仅有最后一个生效。 ---