Dockerfile 的 ENTRYPOINT 与 CMD

Dockerfile 有两个启动配置, CMDENTRYPOINT , 可以在 Dockerfile 中来配置容器启动时自动执行的命令, 但是这二者有什么区别呢, 接下来总结如下:

首先来看一下 CMD , 有三种格式的配置, 分别是:

  • CMD ["executable","param1","param2"] (exec 格式, 推荐的格式)
  • CMD ["param1","param2"] (作为 ENTRYPOINT 的默认参数)
  • CMD command param1 param2 (shell 格式)

在使用时, 要注意一下问题:

  1. 包含可执行文件时, 为容器指定默认执行命令, 这个是主要用途;
  2. 不包含可执行文件时, 必须提供 ENTRYPOINT 配置, CMD 作为默认参数;
  3. Dockerfile 中只能有一个 CMD 起效, 如果出现了多个, 则最后一个起效;

ENTRYPOINT , 有两种格式的配置, 分别是:

  • ENTRYPOINT [“executable”, “param1”, “param2”] (exec 格式, 推荐)
  • ENTRYPOINT command param1 param2 (shell 格式)

CMDENTRYPOINT 两种配置格式的区别是:

  • exec 格式 推荐这种格式, 使用这种模式时, 可以不需要 shell 进程, 让 Docker 应用的可执行程序成为容器的 PID 1 进程, 可以接收 Unix 信号, 比如执行 docker stop <container> 时能够接收到 SIGTERM
  • shell 格式 会始终调用一个 shell 进程, 成为 /bin/sh -c 的子命令, 可执行程序不能响应 Unix 信号。

注意: ENTRYPOINT 使用 shell 格式 时, 会忽略 CMDrun 传入的参数, 如果要替换默认的 ENTRYPOINT 命令, 则需要在执行 docker run 的时候指定 --entrypoint 参数。

CMDENTRYPOINT 的使用总结如下:

  • 在 Dockerfile 中, 应该至少指定一个 CMDENTRYPOINT
  • 将 Docker 当作可执行程序时, 应该使用 ENTRYPOINT 进行配置;
  • CMD 可以用作 ENTRYPOINT 默认参数, 或者用作 Docker 的默认命令;
  • CMD 可以被 docker run 传入的参数覆盖;
  • docker run 传入的参数会附加到 ENTRYPOINT 之后, 前提是使用了 exec 格式