使用 ENTRYPOINT 统一微服务启动入口可避免部署混乱、健康检查失败等问题，通过 entrypoint.sh 封装环境校验、配置注入、信号转发等逻辑，并配合 CMD 提供默认参数，支持多语言服务标准化启动与运维集成。
用 ENTRYPOINT 统一微服务启动入口，能有效避免因启动命令不一致导致的部署混乱、健康检查失败或调试困难等问题。核心思路是把服务的执行逻辑“固化”在镜像中，而把可变参数（如配置文件路径、环境标识）留给 docker run 时传入。
ENTRYPOINT + CMD 协同工作更灵活
ENTRYPOINT 定义容器启动时**必执行的主程序或脚本**，CMD 则提供它的**默认参数**。两者配合，既保证入口统一，又保留运行时覆盖能力。
- 推荐写法：
ENTRYPOINT ["./entrypoint.sh"]+CMD ["--env=prod"] - 运行时可覆盖 CMD：
docker run mysvc --env=staging，实际执行的是./entrypoint.sh --env=staging - 若只用
CMD，不同团队可能写CMD ["npm", "start"]或CMD ["python", "app.py"]，缺乏约束
entrypoint.sh 封装通用启动逻辑
一个轻量 shell 脚本就能承载标准化动作：环境校验、配置注入、权限准备、信号转发等。
- 检查必要环境变量：
if [ -z "$SERVICE_NAME" ]; then echo "Missing SERVICE_NAME"; exit 1; fi - 生成配置文件（如从 env 渲染模板）：
envsubst /etc/app/config.yaml - 确保非 root 用户安全运行：
exec gosu appuser "$@"（需提前安装 gosu） - 关键：最后一行必须用
exec "$@"，让主进程接收 SIGTERM，支持优雅退出
多语言服务也能共用同一入口规范
无论 Go、Java、Python 还是 Node.js 服务，都通过 entrypoint.sh 启动，屏蔽底层差异。
- Go 服务：脚本里执行
./myapp --config=/etc/app/config.yaml - Java 服务：脚本里执行
java -jar app.jar --spring.config.location=file:/etc/app/application.yml - Node.js 服务：脚本里执行
node server.js --port=$PORT - 所有服务对外暴露相同行为：接受
--env、--config等统一参数，日志格式和错误码也趋于一致
CI/CD 和运维工具更易集成
当所有镜像都遵循 ENTRYPOINT ["./entrypoint.sh"]，K8s 的 liveness/readiness 探针、运维脚本、批量巡检工具就能复用同一套调用逻辑。
- K8s 中可统一写：
livenessProbe.exec.command: ["./entrypoint.sh", "--health-check"] - 灰度发布脚本只需关注参数差异，不用为每个服务单独适配启动命令
- 审计时一眼识别镜像是否符合标准——查 Dockerfile 是否含规范 ENTRYPOINT 即可
