linux - shell形式的docker入口点可以使用运行时命令args吗？

Question

这是带有shell形式入口点的示例dockerfile:

FROM ubuntu
ENTRYPOINT /bin/echo "(shell) ENTRYPOINT@image ($0)"

以下是我从各种运行中看到的一些输出:

$ docker run -it sc-test:v4
(shell) ENTRYPOINT@image (/bin/sh)
$ docker run -it sc-test:v4 /bin/echo
(shell) ENTRYPOINT@image (/bin/echo)
$ docker run -it sc-test:v4 /bin/cat
(shell) ENTRYPOINT@image (/bin/cat)
$ docker run -it sc-test:v4 /bin/dog
(shell) ENTRYPOINT@image (/bin/dog)
$ docker run -it sc-test:v4 "/bin/dog ($0)"
(shell) ENTRYPOINT@image (/bin/dog (-bash))

根据docker文档 here，我们可以看到命令args被忽略。
但是， $0的值随提供的args改变。有人可以解释为什么会这样吗？谢谢!

Answer 1

Docker文档中该部分中的表在技术上不正确:当存在shell形式的入口点时，Docker实际上不会删除或忽略命令部分。实际发生的情况(您的示例演示了)是:

如果ENTRYPOINT或CMD(或两者)是 shell 程序形式，则将其包装在["/bin/sh", "-c", "..."]中。

ENTRYPOINT和CMD列表串联在一起形成单个命令列表。

让我们举第三个例子。用Dockerfile语法，

ENTRYPOINT /bin/echo "(shell) ENTRYPOINT@image ($0)"
CMD ["/bin/cat"]

生成的组合命令为(为清晰起见，以JSON数组语法扩展)

[
  "/bin/sh",
  "-c",
  "/bin/echo \"(shell) ENTRYPOINT@image ($0)\"",
  "/bin/cat"
]

那么，如果给 sh -c多个参数，它会做什么？ POSIX spec for the sh command将语法记录为

sh -c command_string [command_name [argument...]]

和其他文件

-c: Read commands from the command_string operand. Set the value of special parameter 0 [...] from the value of the command_name operand and the positional parameters ($1, $2, and so on) in sequence from the remaining argument operands. No commands shall be read from the standard input.

那就是您在示例中看到的。如果 ENTRYPOINT是裸字符串，而 CMD是JSON数组，则在 ENTRYPOINT string命令中， CMD中的参数可以用作 $0， $1等。如果两者都是裸字符串，则两者都包裹在 sh -c中，您将得到类似以下内容的信息:

ENTRYPOINT /bin/echo "$0 is /bin/sh, $1 is -c, and then $2"
CMD the rest of the line

在第一个示例中，命令部分为空，在这种情况下(仍然来自POSIX sh文档)

If command_name is not specified, special parameter 0 shall be set to [...] normally a pathname used to execute the sh utility.

您的最后一个示例更加微妙:

docker run -it sc-test:v4 "/bin/dog ($0)"

由于该字符串已被双引号引起来，因此您的本地shell会在其中扩展 $0引用，这就是 bash进入其中的方式；然后，由于它是单个(带引号)的单词，因此它成为 sh -c的单个command_name参数。

还有两种将 ENTRYPOINT和 CMD一起使用的正常模式。我更喜欢将模式 CMD用作完整的shell命令，然后 ENTRYPOINT进行一些首次设置，然后运行类似 exec "$@"的命令来运行该命令。还有一个“容器作为命令”模式，其中 ENTRYPOINT具有完整的命令(可能包含涉及的JVM参数)和 CMD附加选项。在这些情况下， ENTRYPOINT必须为JSON数组语法:

ENTRYPOINT ["/script-that-exec-dollar-at.sh"]
CMD ["the_command", "--option"]

由于 ENTRYPOINT字符串不直接引用 $0， $1等，因此 CMD包装器实际上会忽略 sh -c参数。如果您有 ENTRYPOINT script.sh，它将由 sh -c作为不带参数的子进程调用，并且 CMD将丢失。
对于Docker文档来说，说“如果 ENTRYPOINT是一个字符串，那么 CMD将被忽略”可能比尝试解释它的微妙之处更为清楚。