008-Dockerfile-ENTRYPOINT

小咪咪 2022-10-01 06:53 172阅读 0赞

## 语法 ##

### 语法 1 ###

ENTRYPOINT ["executable", "param1", "param2"] (exec 形式，推荐)

### 语法 2 ###

ENTRYPOINT command param1 param2 (shell 形式)

## 作用 & 描述 ##

ENTRYPOINT 允许你配置容器的可执行文件运行容器。

例如: 以下将使用其默认 content 启动 nginx，侦听 80 端口:

docker run -i -t --rm -p 80:80 nginx

docker run 的命令行参数将附加在 exec 形式的 ENTRYPOINT 后，并将覆盖使用 CMD 指定的所有元素。这允许将参数传递给入口点。你可以使用 docker run --entrypoint flag 覆盖 ENTRPOINT 指令。

shell 形式可以防止使用任何 CMD 或运行命令行参数，但缺点是 ENTRYPOINT 将作为 /bin/sh -c 的子命令启动，它不传递信号。这意味着可执行文件不是容器的 PID 1 - 并且不会收到 Unix 信号 - 因此你的可执行文件不会从 docker stop 接收 SIGTERM。

只有 Dockerfile 中的最后一个 ENTRYPOINT 指令才会生效。

## Exec 形式 ENTRYPOINT 示例 ##

你可以使用 ENTRYPOINT 形式设置相当稳定的默认命令和参数，然后使用任一形式的 CMD 来设置可能更改的其它默认值。

FROM ubuntu
    ENTRYPOINT ["top", "-b"]
    CMD ["-c"]

运行容器时，你可以看到 top 是唯一的进程。  
要进一步检查结果，可以使用 docker exec:

$ docker exec -it test ps aux
    USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
    root         1  2.6  0.1  19752  2352 ?        Ss+  08:24   0:00 top -b -H
    root         7  0.0  0.1  15572  2164 ?        R+   08:25   0:00 ps aux

你可以优雅地请求使用 docker stop test 来关闭 top  
以下 Dockerfile 显示使用 ENTRYPOINT 在前台运行 Apache(即，作为 PID 1):

FROM debian:stable
    RUN apt-get update && apt-get install -y --force-yes apache2
    EXPOSE 80 443
    VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
    ENTRYPOINT ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]

如果需要为单个可执行文件编写启动脚本，可以使用 exec 和 gosu 命令确保最终的可执行文件接收 Unix 信号:

#!/usr/bin/env bash
    set -e
    
    if [ "$1" = 'postgres' ]; then
        chown -R postgres "$PGDATA"
    
        if [ -z "$(ls -A "$PGDATA")" ]; then
            gosu postgres initdb
        fi
    
        exec gosu postgres "$@"
    fi
    
    exec "$@"

最后，如果你需要在关机时进行一些额外的清理(或与其它容器通信)，或者协调多个可执行文件，你可能需要确保 ENTRYPOINT 脚本接收 UNinx 信号，传递它们，然后做了一些工作:

#!/bin/sh
    # Note: I've written this using sh so it works in the busybox container too
    
    # USE the trap if you need to also do manual cleanup after the service is stopped,
    #     or need to start multiple services in the one container
    trap "echo TRAPed signal" HUP INT QUIT TERM
    
    # start service in background here
    /usr/sbin/apachectl start
    
    echo "[hit enter key to exit] or run 'docker stop <container>'"
    read
    
    # stop service and clean up here
    echo "stopping apache"
    /usr/sbin/apachectl stop
    
    echo "exited $0"

如果你使用 docker run -it --rm -p 80:80 --name test apache 运行这个镜像，你可以用 docker exec 或 docker top 检查容器的进程，然后让脚本停止 Apache:

$ docker exec -it test ps aux
    USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
    root         1  0.1  0.0   4448   692 ?        Ss+  00:42   0:00 /bin/sh /run.sh 123 cmd cmd2
    root        19  0.0  0.2  71304  4440 ?        Ss   00:42   0:00 /usr/sbin/apache2 -k start
    www-data    20  0.2  0.2 360468  6004 ?        Sl   00:42   0:00 /usr/sbin/apache2 -k start
    www-data    21  0.2  0.2 360468  6000 ?        Sl   00:42   0:00 /usr/sbin/apache2 -k start
    root        81  0.0  0.1  15572  2140 ?        R+   00:44   0:00 ps aux
    $ docker top test
    PID                 USER                COMMAND
    10035               root                {run.sh} /bin/sh /run.sh 123 cmd cmd2
    10054               root                /usr/sbin/apache2 -k start
    10055               33                  /usr/sbin/apache2 -k start
    10056               33                  /usr/sbin/apache2 -k start
    $ /usr/bin/time docker stop test
    test
    real	0m 0.27s
    user	0m 0.03s
    sys	0m 0.03s

注意：

你可以使用 --entrypoint 覆盖 ENTRYPOINT 设置，但这只能将二进制设置为 exec(不使用 sh -c)

注意:

exec 形式被解析为 JSON 数组，这意味着你使用双引号(")来围绕单词而不是单引号(’)

注意：

与 shell 表单不同，exec 形式不会调用 shell 命令。这意味着不会发生正常的 shell 处理。例如，ENTRYPOINT \[“echo”, “$HOME”\] 不会对 $HOME 执行变量替换。如果你想要 shell 处理，那么要么使用 shell 形式，要么直接执行 shell，例如: ENTRYPOINT \[“sh”, “-c”, “echo $HOME”\]。当使用 exec 形式并直接执行 shell 时(如果shell形式的情况)，它是执行环境变量扩展的 shell，而不是 docker。

## shell 形式 ENTRYPOINT 示例 ##

你可以为 ENTRYPOINT 指定一个纯字符串，它将在 /bin/sh -c 中执行。此形式将使用 shell 处理来替换 shell 环境变量，并将忽略任何 CMD 或docker运行命令行参数。要确保docker stop能正确发出任何长时间运行的ENTRYPOINT可执行文件，你需要记住用 exec 启动它:

FROM ubuntu
    ENTRYPOINT exec top -b

运行此镜像时，你讲看到单个 PID 1 进程.  
使用 docker stop 可以干净的退出:

$ /usr/bin/time docker stop test
    test
    real	0m 0.20s
    user	0m 0.02s
    sys	0m 0.04s

如果您忘记将exec添加到ENTRYPOINT的开头：

FROM ubuntu
    ENTRYPOINT top -b
    CMD --ignored-param1

然后，您可以运行它（为下一步命名）：

$ docker run -it --name test top --ignored-param2
    Mem: 1704184K used, 352484K free, 0K shrd, 0K buff, 140621524238337K cached
    CPU:   9% usr   2% sys   0% nic  88% idle   0% io   0% irq   0% sirq
    Load average: 0.01 0.02 0.05 2/101 7
      PID  PPID USER     STAT   VSZ %VSZ %CPU COMMAND
        1     0 root     S     3168   0%   0% /bin/sh -c top -b cmd cmd2
        7     1 root     R     3164   0%   0% top -b

您可以从top的输出中看到指定的ENTRYPOINT不是PID 1。  
如果然后运行docker stop test，容器将不会干净地退出 - stop命令将被强制在超时后发送SIGKILL：

$ docker exec -it test ps aux
    PID   USER     COMMAND
        1 root     /bin/sh -c top -b cmd cmd2
        7 root     top -b
        8 root     ps aux
    $ /usr/bin/time docker stop test
    test
    real	0m 10.19s
    user	0m 0.04s
    sys	0m 0.03s

## 了解CMD和ENTRYPOINT如何相互作用 ##

CMD 和 ENTRYPOINT 指令都定义了在运行容器时执行的命令。 很少有规则描述他们的合作。

1. Dockerfile 应至少指定一个 CMD 或 ENTRYPOINT 命令。
    2. 使用容器作为可执行文件时，应定义 ENTRYPOINT。
    3. CMD 应该用作为 ENTRYPOINT 命令定义默认参数或在容器中执行 ad-hoc 命令的方法。
    4. 使用备用参数运行容器时，将覆盖 CMD。

下表显示了针对不同 ENTRYPOINT/CMD 组合执行的命令：

<table> 
 <thead> 
  <tr> 
   <th>—</th> 
   <th>No ENTRYPOINT</th> 
   <th>ENTRYPOINT exec_entry p1_entry</th> 
   <th>ENTRYPOINT [“exec_entry”, “p1_entry”]</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>No CMD</td> 
   <td>error, not allowed</td> 
   <td>/bin/sh -c exec_entry p1_entry</td> 
   <td>exec_entry p1_entry</td> 
  </tr> 
  <tr> 
   <td>CMD [“exec_cmd”, “p1_cmd”]</td> 
   <td>exec_cmd p1_cmd</td> 
   <td>/bin/sh -c exec_entry p1_entry</td> 
   <td>exec_entry p1_entry exec_cmd p1_cmd</td> 
  </tr> 
  <tr> 
   <td>CMD [“p1_cmd”, “p2_cmd”]</td> 
   <td>p1_cmd p2_cmd</td> 
   <td>/bin/sh -c exec_entry p1_entry</td> 
   <td>exec_entry p1_entry p1_cmd p2_cmd</td> 
  </tr> 
  <tr> 
   <td>CMD exec_cmd p1_cmd</td> 
   <td>/bin/sh -c exec_cmd p1_cmd</td> 
   <td>/bin/sh -c exec_entry p1_entry</td> 
   <td>exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd</td> 
  </tr> 
 </tbody> 
</table>