Docker学习(二十二)Dockerfile 中 CMD 与 ENTRYPOINT 区别

目录

    • 一、CMD 指令
      • 1.1 常见用法:
      • 1.2 用法1举例:
      • 1.3 docker run 覆盖
    • 二、ENTRYPOINT 指令
      • 2.1 常见用法:
      • 2.2 两种写法:
    • 三、ENTRYPOINT 指令和 CMD 指令正确用法举例

Dockerfile 中的 CMDENTRYPOINT 指令是用于定义容器的默认执行命令的两个指令。尽管它们的作用相同,但它们在使用方式上还是有一些区别。

先说结论:

我们指定容器的启动脚本一般就是使用 ENTRYPOINT 来指定。我们可以把那些可能需要变动的参数写到 CMD 中,而把那些不需要变动的参数写到 ENTRYPOINT 里面。

下面详细介绍一下 CMD 指令 和 ENTRYPOINT 指令:

一、CMD 指令

CMD 指令:在容器运行时提供一些命令及参数。存在多条 CMD 指令时,仅最后一个生效。

1.1 常见用法:

  • 用法1: 运行一个可执行的文件并提供参数:(exec form, this is the preferred form)

    通常是shell命令且以 "/bin/sh -c" 来运行它,此时运行为shell的子进程,能使用shell操作符。

    CMD ["executable","param1","param2"]
    
  • 用法2:ENTRYPOINT 指定参数:(as default parameters to ENTRYPOINT)

    不会以 "/bin/sh -c" 运行(非shell子进程),因此不支持shell操作符如变量替换和通配符(?,*等)。

    CMD ["param1","param2"]
    
  • 用法3:/bin/sh -c 的方法执行的命令:(shell form)

    需要结合ENTRYPOINT指令提供默认参数使用。

    CMD command param1 param2
    

1.2 用法1举例:

我们指定如下命令:

CMD ["/bin/echo","this is a test."]

构建镜像:

doker build -t echo-test .

创建并运行容器:

docker run --name=echo-test echo-test

输出内容:

this is a test.

1.3 docker run 覆盖

当使用 docker run 命令创建容器时,如果指定了参数,就会把 CMD 中指定的命令覆盖掉。例如:

当我们使用如下命令创建并运行容器时:

docker run --name=echo-test echo-test /bin/bash

输出内容:无,因为 CMD 指定的命令被 /bin/bash 覆盖了。

二、ENTRYPOINT 指令

ENTRYPOINT 指令:字面意思是进入点,用于在容器启动时指定默认的执行命令。存在多条 ENTRYPOINT 指令时,仅最后一个生效。

An ENTRYPOINT allows you to configure a container that will run as an executable.

它可以让你的容器功能表现得像一个可执行程序一样。

2.1 常见用法:

ENTRYPOINT 指令 只有一个用法:运行一个可执行的文件并提供参数

我们指定容器的启动脚本一般就是使用 ENTRYPOINT 来指定。我们可以把那些可能需要变动的参数写到 CMD 中,而把那些不需要变动的参数写到 ENTRYPOINT 里面。

2.2 两种写法:

  • 写法一:(the preferred exec form)

    ENTRYPOINT ["executable","param1","param2"]
    
  • 写法二:(shell form)

    ENTRYPOINT command param1 param2
    

注意:

  • 你也可以在 docker run 命令中使用 --entrypoint 指定启动命令,但是只能用写法一;

  • 第二种写法(shell form)会屏蔽掉 docker run 时后面指定的参数和 CMD 中指定的参数。

  • 网上有资料说 ENTRYPOINT 的默认值是 ["/bin/s","-c"],其实不然,当我们使用 ENTRYPOINT ["/bin/sh","-c"] 指令构造一个镜像 sh 时,我们可以这样运行:

    docker run -it sh "while(true) do echo loop; done;"
    

    会一直打印 loop:

    Docker学习(二十二)Dockerfile 中 CMD 与 ENTRYPOINT 区别_第1张图片

    但是如果我们直接运行一个 centos:latest 镜像:

    docker run -it centos:latest "while(true) do echo loop; done;"
    

    会报如下错误:

    在这里插入图片描述

    docker: Error response from daemon: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "while(true) do echo loop;done;": executable file not found in $PATH: unknown.
    

    所以可以得知默认情况下 ENTRYPOINT 并不是 ["/bin/sh","-c"],而应该是默认为空,使用时需要手动指定 "/bin/sh","-c"

    docker run -it centos:latest "/bin/sh" "-c" "while(true) do echo loop; done;"
    

    执行结果如下:

    Docker学习(二十二)Dockerfile 中 CMD 与 ENTRYPOINT 区别_第2张图片

三、ENTRYPOINT 指令和 CMD 指令正确用法举例

假如,我们需要写一个用于构建 nginx 基础镜像的 Dockerfile,我们可以这么写:

FROM centos:latest
RUN yum -q -y update && yum -q -y upgrade \
    &&  yum install -y nginx
    &&  yum clean all
EXPOSE 80
ENTRYPOINT ["nginx"]
CMD ["-c","/etc/nginx.conf"]
  • ENTRYPOINT 指令 指定了镜像的启动方式为 nginx 命令,一般不会被覆盖,需要的话可以通过在 docker run 中指定 --entrypoint 进行覆盖。

    docker run -it -p 81:80 --name=nginx-base --entrypoint /bin/bash nginx-base:v1
    
  • CMD 指令 指定了 nginx 启动时默认使用的配置文件位置,如果有需要,可以在 docker run 命令创建容器时重新指定配置文件的位置。

整理完毕,完结撒花~





参考地址:

1.论docker中 CMD 与 ENTRYPOINT 的区别,https://www.scholat.com/vpost.html?pid=7633
2.Dockerfile文件解释,https://blog.csdn.net/weixin_42688573/article/details/125464719

你可能感兴趣的:(Docker,docker,学习,运维)