JSONArgsRecommended
目录
输出
JSON arguments recommended for ENTRYPOINT/CMD to prevent unintended behavior related to OS signals描述
ENTRYPOINT 和 CMD 指令都支持两种不同的参数语法
- Shell 形式：
CMD my-cmd start - Exec 形式：
CMD ["my-cmd", "start"]
当你使用 shell 形式时，可执行文件作为 shell 的子进程运行，这不会传递信号。这意味着在容器中运行的程序无法检测到 OS 信号，例如 SIGTERM 和 SIGKILL，也无法正确响应它们。
示例
❌ 错误：ENTRYPOINT 命令无法接收 OS 信号。
FROM alpine
ENTRYPOINT my-program start
# entrypoint becomes: /bin/sh -c my-program start为确保可执行文件能够接收 OS 信号，请对 CMD 和 ENTRYPOINT 使用 exec 形式，这允许你在容器中将可执行文件作为主进程（PID 1）运行，从而避免了 shell 父进程。
✅ 正确：ENTRYPOINT 接收 OS 信号。
FROM alpine
ENTRYPOINT ["my-program", "start"]
# entrypoint becomes: my-program start请注意，将程序作为 PID 1 运行意味着该程序现在具有与 Linux 中 PID 1 相关的特殊职责和行为，例如回收子进程。
变通方案
在某些情况下，你可能仍然希望在 shell 下运行容器。使用 exec 形式时，shell 功能（如变量扩展、管道（|）和命令链（&&、||、;））不可用。要使用这些功能，你需要使用 shell 形式。
以下是一些实现方法。请注意，这仍然意味着可执行文件作为 shell 的子进程运行。
创建包装脚本
你可以创建一个入口点脚本来包装你的启动命令，并使用 JSON 格式的 ENTRYPOINT 命令执行该脚本。
✅ 正确：ENTRYPOINT 使用 JSON 格式。
FROM alpine
RUN apk add bash
COPY --chmod=755 <<EOT /entrypoint.sh
#!/usr/bin/env bash
set -e
my-background-process &
my-program start
EOT
ENTRYPOINT ["/entrypoint.sh"]明确指定 shell
你可以使用 SHELL Dockerfile 指令明确指定要使用的 shell。这将抑制警告，因为设置 SHELL 指令表示使用 shell 形式是经过深思熟虑的决定。
✅ 正确：shell 已明确定义。
FROM alpine
RUN apk add bash
SHELL ["/bin/bash", "-c"]
ENTRYPOINT echo "hello world"