理解CMD 和 ENTRYPOINT 是如何互相作用的

2024-03-01 16:20

本文主要是介绍理解CMD 和 ENTRYPOINT 是如何互相作用的,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

官方文档: Dockerfile reference - Understand how CMD and ENTRYPOINT interact

目录

  • Understand how CMD and ENTRYPOINT interact
    • 官方文档原文
    • Docker run 覆写设置说明
      • 准备验证镜像 nginx:latest
      • 情景1: ENTRYPOINT 与 CMD均使用默认值
      • 情景2: ENTRYPOINT 与 CMD同时空值
      • 情景3: ENTRYPOINT有值 与 CMD为空值
      • 情景4: ENTRYPOINT 与 CMD 同时有值
      • 情景5: ENTRYPOINT为空值 与 CMD 有值
      • 情景6: ENTRYPOINT默认值 与 CMD 有值

Understand how CMD and ENTRYPOINT interact

理解CMD 和 ENTRYPOINT 是如何互相作用的

官方文档原文

Both CMD and ENTRYPOINT instructions define what command gets executed when running a container. There are few rules that describe their co-operation.

CMD和ENTRYPOINT指令都定义了运行容器时执行的命令。几乎没什么规则可以描述他们的合作关系。

  1. Dockerfile should specify at least one of CMD or ENTRYPOINT commands.

  2. ENTRYPOINT should be defined when using the container as an executable.

  3. CMD should be used as a way of defining default arguments for an ENTRYPOINT command or for executing an ad-hoc command in a container.

  4. CMD will be overridden when running the container with alternative arguments.

1. Dockerfile要求 CMD 与 ENTRYPOINT 两个命令中至少声明一个。
2.当容器是可执行时,应该定义 ENTRYPOINT。
3.CMD可被定义作为ENTRYPOINT命令的缺省参数或者在容器中执行的一个临时命令。
4.C当使用替代参数运行容器时,CMD将被覆盖

The table below shows what command is executed for different ENTRYPOINT / CMD combinations:

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

在这里插入图片描述

说明上表中定义方式参见官方文档:Dockerfile reference - Shell and exec form

Note
If CMD is defined from the base image, setting ENTRYPOINT will reset CMD to an empty value. In this scenario, CMD must be defined in the current image to have a value.

如果基础镜像中定义了 CMD,设置了 ENTRYPOINT,会把 CMD 重置成空值。这种情况下,CMD必须在当前镜像定义一个值:

Docker run 覆写设置说明

上表中是个矩阵表,从两个维度组合CMD 和 ENTRYPOINT的命令。对应上述4条规则,验证docker run命令下使用情况。

官方文档: Running containers - Overriding image defaults

准备验证镜像 nginx:latest

  • 查看官方nginx:latest镜像的ENTRYPOINT 和 CMD 参数信息
    • “Entrypoint”: [
      /docker-entrypoint.sh
      ],
    • “Cmd”: [ “/bin/sh”,
      “-c”,
      "#(nop) ",
      “CMD [“nginx” “-g” “daemon off;”]
      ],
// nginx镜像已提前拉到本地
[root@centos7-10 ~]# docker image inspect nginx:latest 
[{"Id": "sha256:605c77e624ddb75e6110f997c58876baa13f8754486b461117934b24a9dc3a85","RepoTags": ["nginx:latest"],"RepoDigests": ["nginx@sha256:0d17b565c37bcbd895e9d92315a05c1c3c9a29f762b011a10c54a66cd53c9b31"],"Parent": "","Comment": "","Created": "2021-12-29T19:28:29.892199479Z","Container": "ca3e48389f7160bc9d9a892d316fcbba459344ee3679998739b1c3cd8e56f7da","ContainerConfig": {
......"Cmd": ["/bin/sh","-c","#(nop) ","CMD [\"nginx\" \"-g\" \"daemon off;\"]"],"Image": "sha256:82941edee2f4d17c55563bb926387c3ae39fa1a99777f088bc9d3db885192209","Volumes": null,"WorkingDir": "","Entrypoint": ["/docker-entrypoint.sh"],......}}
]

情景1: ENTRYPOINT 与 CMD均使用默认值

  • 运行一个容器,ENTRYPOINT 和 CMD 均使用默认值
    1. docker run运行nginx:latest,
    2. 使用镜像 ENTRYPOINT 和 CMD 的默认值
    3. 查看容器的COMMAND,组合ENTRYPOINT 与 CMD 的默认值: “/docker-entrypoint.sh nginx -g ‘daemon off;’” ,CMD值作为ENTRYPOINT的命令参数。
[root@centos7-10 ~]# docker run -itd --rm nginx:latest 
514842c73f365f38f803252b9ee6b92d0665d7448c5a782dab7d1002671997b7
[root@centos7-10 ~]# docker ps -a --no-trunc 
CONTAINER ID                                                       IMAGE          COMMAND                                          CREATED          STATUS                      PORTS     NAMES
514842c73f365f38f803252b9ee6b92d0665d7448c5a782dab7d1002671997b7   nginx:latest   "/docker-entrypoint.sh nginx -g 'daemon off;'"   28 seconds ago   Up 26 seconds               80/tcp    stupefied_booth

情景2: ENTRYPOINT 与 CMD同时空值

  • 运行一个容器,ENTRYPOINT 和 CMD 同时空值的情况
    1. docker run运行nginx:latest,
    2. 覆写设置Entrypoint值为空。该设置操作会清空镜像默认CMD的值
    3. CMD为空值
    4. 容器运行禁止ENTRYPOINT 与 CMD 同时为空值,给出错误提示!
[root@centos7-10 ~]# docker run -it --entrypoint="" nginx:latest 
docker: Error response from daemon: No command specified.
See 'docker run --help'.

情景3: ENTRYPOINT有值 与 CMD为空值

  • 运行一个容器,ENTRYPOINT有值,CMD 为空值的情况
    1. docker run运行nginx:latest,
    2. 覆写设置Entrypoint=/bin/bash。该设置操作会清空镜像默认CMD的值
    3. CMD为空值
    4. 查看容器的COMMAND,显示ENTRYPOINT的值:“/bin/bash”
// 运行容器
[root@centos7-10 ~]# docker run -it --entrypoint /bin/bash nginx:latest 
root@d8f22cc19655:/# 
// 容器的COMMAND,显示 /bin/bash
[root@centos7-10 ~]# docker ps -a --no-trunc 
CONTAINER ID                                                       IMAGE          COMMAND       CREATED          STATUS          PORTS     NAMES
d8f22cc19655647798a7578dc9d07fd928388e3f575e18b0c4864d747f68c67d   nginx:latest   "/bin/bash"   36 seconds ago   Up 35 seconds   80/tcp    wonderful_shaw
[root@centos7-10 ~]# 

情景4: ENTRYPOINT 与 CMD 同时有值

  • 运行一个容器,ENTRYPOINT 与 CMD 均有值的情况
    1. docker run运行nginx:latest,
    2. 覆写设置Entrypoint=/bin/bash。该设置操作会清空镜像默认CMD的值
    3. 覆写设置CMD=“-c ls -a”
    4. 查看容器的COMMAND,组合ENTRYPOINT 与 CMD 的值: “/bin/bash -c ls -a” ,CMD值作为ENTRYPOINT的命令参数。
// 运行容器,--entrypoint /bin/bash,CMD -c ls -a 
[root@centos7-10 ~]# docker run -it --entrypoint /bin/bash nginx:latest -c ls -a 
bin  boot  dev  docker-entrypoint.d  docker-entrypoint.sh  etc  home  lib  lib64  media  mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var
// COMMAND /bin/bash -c ls -a
[root@centos7-10 ~]# docker ps -a --no-trunc 
CONTAINER ID                                                       IMAGE          COMMAND                CREATED          STATUS                      PORTS     NAMES
c3a03c567fac4133b803d66e330adb7bea31bdfdc1153eb8b9d0d5b2cbf6c15d   nginx:latest   "/bin/bash -c ls -a"   10 seconds ago   Exited (0) 9 seconds ago              clever_wilson

情景5: ENTRYPOINT为空值 与 CMD 有值

  • 运行一个容器,ENTRYPOINT为空值 与 CMD 有值的情况
    1. docker run运行nginx:latest,
    2. 覆写设置Entrypoint=“”。该设置操作会清空镜像默认CMD的值
    3. 覆写设置CMD=“/bin/bash -c ls -a”
    4. 查看容器的COMMAND,显示CMD的值: “/bin/bash -c ls -a”
// 运行容器,Entrypoint="",CMD /bin/bash -c ls -a
[root@centos7-10 ~]# docker run -it --entrypoint="" nginx:latest /bin/bash -c ls -a 
bin  boot  dev  docker-entrypoint.d  docker-entrypoint.sh  etc  home  lib  lib64  media  mnt  opt  proc  root  run  sbin  srv  sys  tmp  usr  var
// COMMAND /bin/bash -c ls -a
[root@centos7-10 ~]# docker ps -a --no-trunc 
CONTAINER ID                                                       IMAGE          COMMAND                  CREATED              STATUS                          PORTS     NAMES
0261ca0bf5b1d802092da12f0d9339300e47e7cffd24b6e29b724a510adaec10   nginx:latest   "/bin/bash -c ls -a"     About a minute ago   Exited (0) About a minute ago             hopeful_hofstadter

情景6: ENTRYPOINT默认值 与 CMD 有值

  • 运行一个容器,ENTRYPOINT使用默认值 与 CMD 有值的情况
    1. docker run运行nginx:latest,
    2. 忽略设置Entrypoint,使用默认值为 “/docker-entrypoint.sh”
    3. 覆写设置CMD="nginx -v "
    4. 查看容器的COMMAND,组合ENTRYPOINT 与 CMD 的值: ** “/docker-entrypoint.sh nginx -v”** ,CMD值作为ENTRYPOINT的命令参数。
// 运行容器,CMD nginx -v
[root@centos7-10 ~]# docker run -itd nginx:latest nginx -v
94498d179a78b70ba8375b9a5348a7f68b3071991e418fc36f2eb3d0517e61c0
// COMMAND  "/docker-entrypoint.sh nginx -v"
[root@centos7-10 ~]# docker ps -a --no-trunc 
CONTAINER ID                                                       IMAGE          COMMAND                            CREATED          STATUS                      PORTS     NAMES
94498d179a78b70ba8375b9a5348a7f68b3071991e418fc36f2eb3d0517e61c0   nginx:latest   "/docker-entrypoint.sh nginx -v"   39 seconds ago   Exited (0) 38 seconds ago             kind_leavitt

这篇关于理解CMD 和 ENTRYPOINT 是如何互相作用的的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/763068

相关文章

Spring Boot项目部署命令java -jar的各种参数及作用详解

《SpringBoot项目部署命令java-jar的各种参数及作用详解》:本文主要介绍SpringBoot项目部署命令java-jar的各种参数及作用的相关资料,包括设置内存大小、垃圾回收... 目录前言一、基础命令结构二、常见的 Java 命令参数1. 设置内存大小2. 配置垃圾回收器3. 配置线程栈大小

Java编译生成多个.class文件的原理和作用

《Java编译生成多个.class文件的原理和作用》作为一名经验丰富的开发者,在Java项目中执行编译后,可能会发现一个.java源文件有时会产生多个.class文件,从技术实现层面详细剖析这一现象... 目录一、内部类机制与.class文件生成成员内部类(常规内部类)局部内部类(方法内部类)匿名内部类二、

Java实现时间与字符串互相转换详解

《Java实现时间与字符串互相转换详解》这篇文章主要为大家详细介绍了Java中实现时间与字符串互相转换的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录一、日期格式化为字符串(一)使用预定义格式(二)自定义格式二、字符串解析为日期(一)解析ISO格式字符串(二)解析自定义

C++ 中的 if-constexpr语法和作用

《C++中的if-constexpr语法和作用》if-constexpr语法是C++17引入的新语法特性,也被称为常量if表达式或静态if(staticif),:本文主要介绍C++中的if-c... 目录1 if-constexpr 语法1.1 基本语法1.2 扩展说明1.2.1 条件表达式1.2.2 fa

css中的 vertical-align与line-height作用详解

《css中的vertical-align与line-height作用详解》:本文主要介绍了CSS中的`vertical-align`和`line-height`属性,包括它们的作用、适用元素、属性值、常见使用场景、常见问题及解决方案,详细内容请阅读本文,希望能对你有所帮助... 目录vertical-ali

浅析CSS 中z - index属性的作用及在什么情况下会失效

《浅析CSS中z-index属性的作用及在什么情况下会失效》z-index属性用于控制元素的堆叠顺序,值越大,元素越显示在上层,它需要元素具有定位属性(如relative、absolute、fi... 目录1. z-index 属性的作用2. z-index 失效的情况2.1 元素没有定位属性2.2 元素处

Java实现XML与JSON的互相转换详解

《Java实现XML与JSON的互相转换详解》这篇文章主要为大家详细介绍了如何使用Java实现XML与JSON的互相转换,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. XML转jsON1.1 代码目的1.2 代码实现2. JSON转XML3. JSON转XML并输出成指定的

Spring 中 BeanFactoryPostProcessor 的作用和示例源码分析

《Spring中BeanFactoryPostProcessor的作用和示例源码分析》Spring的BeanFactoryPostProcessor是容器初始化的扩展接口,允许在Bean实例化前... 目录一、概览1. 核心定位2. 核心功能详解3. 关键特性二、Spring 内置的 BeanFactory

Spring组件初始化扩展点BeanPostProcessor的作用详解

《Spring组件初始化扩展点BeanPostProcessor的作用详解》本文通过实战案例和常见应用场景详细介绍了BeanPostProcessor的使用,并强调了其在Spring扩展中的重要性,感... 目录一、概述二、BeanPostProcessor的作用三、核心方法解析1、postProcessB

MyBatis的配置对象Configuration作用及说明

《MyBatis的配置对象Configuration作用及说明》MyBatis的Configuration对象是MyBatis的核心配置对象,它包含了MyBatis运行时所需的几乎所有配置信息,这个对... 目录MyBATis配置对象Configuration作用Configuration 对象的主要作用C