Dockerfile CMD、ENTRYPOINT 区别

ENTRYPOINT与CMD都可以对iamge配置启动命令。但两者之间还是有一些细微的区别。多数情况下需要用户在二者中选择其一使用，但也可以共同使用两者。下面将具体分析二者不同的使用场景。

ENTRYPOINT or CMD

---

最终，ENTRYPOINT与CMD都提供了一个方法，让用户指定容器默认启动命令。事实上如果你希望你的image是可执行的（启动docker run时不额外指定启动命令就可以运行），那么你必须在Dockerfile中使用ENTRYPOINT或CMD。

尝试运行一个没有使用ENTRYPOINT或CMD指令的image，启动时会报错：

$ docker run alpine
FATA[0000] Error response from daemon: No command specified

你能在Docker Hub上找到的大多数linux版本基础镜像都使用了/bin/sh或/bin/bash这样的shell命令来作为CMD启动命令。这意味着，任何人运行这些image时，都会默认进入到交互式shell界面中（假设运行时指定了-t/-i参数）

这对通用的基础镜像是十分方便的，但是当你希望运行自己的image时（即非通用基础image时），更多时候需要指定一个更具体的可执行文件或命令来作为CMD或ENTRYPOINT参数。

在 Dockerfile 中，CMD 和 ENTRYPOINT 都用于指定容器启动时要执行的命令。它们之间的主要区别是：

- CMD 用于定义容器启动时要执行的命令和参数，它设置的值可以被 Dockerfile 中的后续指令覆盖，包括在运行容器时传递的参数。

- Entrypoint是指定容器启动时要执行的默认命令，它在运行容器时不能被覆盖。而Cmd是指定容器启动时要执行的默认命令参数，它可以被覆盖。通常情况下，Entrypoint用于指定容器启动时要运行的应用程序，而Cmd用于指定应用程序的默认参数。 

1、CMD 指令　

---

CMD在容器运行的时候提供一些命令及参数，用法如下：

• CMD ["executable","param1","param2"] (exec form, this is the preferred form)

• CMD ["param1","param2"] (as default parameters to ENTRYPOINT)

• CMD command param1 param2 (shell form)

第一种用法：运行一个可执行的文件并提供参数。(可执行程序+参数)

第二种用法：为ENTRYPOINT指定参数。（cmd指定参数）

第三种用法(shell form)：是以”/bin/sh -c”的方法执行的命令。（执行shell命令）

如你指定:

CMD [“/bin/echo”, “this is a echo test ”]

build后运行(假设镜像名为ec):

docker run ec

就会输出:

this is a echo test

是不是感觉很像开机启动项，你可以暂时这样理解。

注意点：

docker run命令如果指定了参数会把CMD里的参数覆盖： （这里说明一下，如：docker run -it ubuntu /bin/bash 命令的参数是指/bin/bash而非 -it ,-it只是docker 的参数，而不是容器的参数，以下所说参数均如此。）

同样是上面的ec镜像启动：

docker run ec /bin/bash

就不会输出： this is a echo test 因为CMD命令被”/bin/bash”覆盖了。

- ENTRYPOINT 也用于定义容器启动时要执行的命令，但不像 CMD，它的值不会被 Dockerfile 中的后续指令覆盖，只能在运行容器时添加参数来覆盖它。也就是说，ENTRYPOINT 设置的命令一般是容器镜像所要执行的主要命令，CMD 则是选项和参数。

换句话说，CMD 是为 ENTRYPOINT 提供默认选项，ENTRYPOINT 则是容器镜像中主要执行的命令。在 Dockerfile 中定义 ENTRYPOINT 可以使您的镜像更像一个可执行文件，而在运行容器时传递参数可以以更灵活的方式执行此命令。

2、ENTRYPOINT 指令

ENTRYPOINT指令适合用于：希望容器最终运行时所执行的命令与Dockerfile内配置的命令相同的场景下。也就是说，不希望用户重写image启动命令。　

字面意思是进入点，而它的功能也恰如其意。它可以让你的容器功能表现得像一个可执行程序一样。

容器功能表现得像一个可执行程序一样，这是什么意思呢？直接给个例子好说话，使用下面的ENTRYPOINT构造镜像：

ENTRYPOINT ["/bin/echo"]

那么docker build出来的镜像以后的容器功能就像一个/bin/echo程序，比如我build出来的镜像名称叫imageecho，那么我可以这样用它：

docker  run  -it  imageecho  “this is a test”

这里就会输出”this is a test”这串字符，而这个imageecho镜像对应的容器表现出来的功能就像一个echo程序一样。 你添加的参数“this is a test”会添加到ENTRYPOINT后面，就成了这样　/bin/echo “this is a test” 。现在你应该明白进入点的意思了吧。

例子：

ENTRYPOINT ["/bin/cat"]

构造出来的镜像你可以这样运行(假设名为st)：这样相当： /bin/cat /etc/fstab 这个命令的作用。运行之后就输出/etc/fstab里的内容。

ENTRYPOINT

• ENTRYPOINT 也是在 Dockerfile 中定义的，它用于指定容器启动时始终执行的命令，这个命令不那么容易被 docker run 的命令行参数覆盖，除非以组合的形式追加参数。

• ENTRYPOINT 也有两种格式，与 CMD 相似：

  • ENTRYPOINT ["executable", "param1"]：exec形式，优先级高于 CMD，并且无论是否提供 docker run 后的命令，都会执行此命令，并将 docker run 后的参数追加到 ENTRYPOINT 后。（其实就是一个可执行的程序）ENTRYPOINT ["/bin/sh","-c","java $JAVA_OPTS -jar /demo.jar --server.port=8000"]

  • ENTRYPOINT command param1：shell格式。ENTRYPOINT java $JAVA_OPTS -jar /demo.jar --server.port=8000

• 使用 ENTRYPOINT 可以确保每次容器启动时都执行同一命令，这有助于将容器设计得更加“应用导向”，使得容器的行为更一致。当同时设置了 CMD 和 ENTRYPOINT 时，CMD 的内容会被视为 ENTRYPOINT 的参数。

正确写法：shell格式，可以跟着很多参数，其实就是在linux执行的命令

ENV JAVA_OPTS="-Xmx512m -Xms512m" 

ENTRYPOINT  java $JAVA_OPTS -jar /demo.jar --server.port=8000

ENTRYPOINT ["/bin/sh","-c","java $JAVA_OPTS -jar /demo.jar --server.port=8000"]

/bin/sh是可执行程序，exec形式

错误写法：exec形式，就两部分内容，一个是可执行程序，一个是参数，java不是可执行程序

ENTRYPOINT  ["java",$JAVA_OPTS, "-jar", "/demo.jar","--server.port=8000"]

ENTRYPOINT：

entrypoint才是让容器面向应用的一个主要因素，容器镜像是面向应用的，一般生产系统里面不会有centos镜像跑在那，要不是http server，以及各种各样的服务。

所以容器镜像是面向某个应用的，entrypoint指定启动容器的时候要启动哪些服务，有了这个之后，容器镜像在加载之后不仅仅是一个操作系统，它可以是操作系统+应用，又可以是没有操作系统只有应用，所以是面向应用构建的容器镜像。

entrypoint一般是dockerfile的最后一条指令。

entrypoint最佳实践是：entrypoint定义主命令，cmd来定义它主要参数，这样在容器启动时候就是启动entrypoint这个命令并且附加cmd的参数。

[root@jenkins dockerfile]# cat Dockerfile
FROM openjdk:8-jdk-alpine 
LABEL maintainer lucas

ENV TZ=Asia/Shanghai
ENV JAVA_OPTS="-Xmx512m -Xms512m"


COPY demo.jar  / 
WORKDIR /

EXPOSE 8000


ENTRYPOINT ["/bin/sh"]
CMD ["-c","java $JAVA_OPTS -jar /demo.jar","--server.port=8000"]


[root@jenkins dockerfile]# docker build -f ./Dockerfile -t java-demo  .

[root@jenkins dockerfile]# docker ps
CONTAINER ID   IMAGE              COMMAND                  CREATED         STATUS         PORTS                                       NAMES
85a24d6f5a38   java-demo:latest   "/bin/sh -c 'java $J…"   8 seconds ago   Up 6 seconds   0.0.0.0:8000->8000/tcp, :::8000->8000/tcp   java-demo


[root@jenkins dockerfile]# ps -ef | grep java
root       4324   4304 48 15:35 pts/0    00:00:09 java -Xmx512m -Xms512m -jar /demo.jar

ENTRYPOINT有两种写法：

写法一：

1	ENTRYPOINT ["executable", "param1", "param2"] (the preferred exec form)

写法二：

1	ENTRYPOINT command param1 param2 (shell form)

你也可以在docker run 命令时使用–entrypoint指定（但是只能用写法一）。

下面是我把ENTRYPOINT设为[“/bin/sh -c”]时候运行的情况：

# docker run -it t2 /bin/bash
root@4c8549e7ce3e:/# ps
PID TTY TIME CMD
1 ? 00:00:00 　sh
9 ? 00:00:00 　bash
19 ? 00:00:00 　ps

可以看到PID为1的进程运行的是sh，而bash只是sh的一个子进程，/bin/bash只是作为 /bin/sh -c后面的参数。

CMD可以为ENTRYPOINT提供参数，ENTRYPOINT本身也可以包含参数，但是你可以把那些可能需要变动的参数写到CMD里而把那些不需要变动的参数写到ENTRYPOINT里面例如：

1 2 3

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

把可能需要变动的参数写到CMD里面。然后你可以在docker run里指定参数，这样CMD里的参数(这里是-c)就会被覆盖掉而ENTRYPOINT里的不被覆盖。

 

--------------------------------------------------------------------------------------------------------------------------------

在Docker中，CMD和ENTRYPOINT都是用于指定容器启动时要执行的命令或脚本。它们之间的区别如下：

CMD用于指定容器启动时要执行的命令。它可以有三种不同的形式：

• CMD ["executable","param1","param2"]（使用JSON数组形式）：推荐使用这种形式，它会直接执行指定的可执行文件，并传递参数。

• CMD command param1 param2（使用命令形式）：这种形式会将命令传递给shell进行解释执行。

• CMD ["param1","param2"]（使用JSON数组形式）：这种形式会将指定的参数传递给ENTRYPOINT指定的可执行文件。

在Dockerfile中，可以使用多个CMD指令，但只有最后一个CMD指令会生效。如果容器启动时没有指定要执行的命令，将会执行最后一个CMD指令中指定的命令。

ENTRYPOINT：ENTRYPOINT用于指定容器启动时要执行的可执行文件。它可以有两种不同的形式：

• ENTRYPOINT ["executable", "param1", "param2"]（使用JSON数组形式）：推荐使用这种形式，它会直接执行指定的可执行文件，并传递参数。

• ENTRYPOINT command param1 param2（使用命令形式）：这种形式会将命令传递给shell进行解释执行。

在Dockerfile中，只能使用一个ENTRYPOINT指令。如果同时存在CMD指令，CMD中的参数将会作为ENTRYPOINT指定的可执行文件的参数进行传递。

总结起来：

• CMD 是容器启动时如果没有指定命令时的默认行为，它的灵活性较高，易于被 docker run 后的命令覆盖。

• ENTRYPOINT 更像是容器的核心功能定义，常用于定义容器的主应用程序，并且能接收 docker run 的参数，这样可以确保容器启动时总是执行预期的程序，并且可以处理任何额外的参数。

综上所述，两者可以配合使用，共同决定容器启动时的具体行为，从而更好地控制容器的应用场景和定制程度。

CMD用于指定容器启动时要执行的命令参数，而ENTRYPOINT用于指定容器启动时要执行的可执行文件。可以将ENTRYPOINT看作是容器的入口点，而CMD则是对ENTRYPOINT指定的可执行文件的参数进行补充。