添加链接 注册    登录
link管理
链接快照平台
  • 输入网页链接，自动生成快照
  • 标签化管理网页链接
相关文章推荐
性感的鸵鸟  ·  解决Dockerfile构建失败问题·  1 月前    · 
勤奋的鸭蛋  ·  RUN Instruction Using ...·  1 月前    · 
坚强的山楂  ·  Binary polynomial ...·  3 月前    · 
彷徨的铁链  ·  唐河往年各校中考分数线！附：最新中招加分政策 ...·  5 月前    · 
玩足球的乒乓球  ·  Mac catalina ...·  5 月前    · 
没读研的小蝌蚪  ·  日语点歌系统、日语歌库、音创歌曲云更新、音创 ...·  5 月前    · 
坏坏的香槟  ·  紫金红葫芦是谁的武器 – 快看漫画问答·  5 月前    · 
link管理  ›  Docker ENTRYPOINT & CMD 理解与实践 - zihengCat
docker命令 redis docker dockerfile
https://zihengcat.github.io/2019/06/12/understanding-and-practicing-docker-entrypoint-cmd/
风流倜傥的单杠
1 年前

前言

Docker 指令 CMD 与 ENTRYPOINT 用于 配置容器启动时的运行命令 ，通常会写在 Dockerfile 中。本文讲解 CMD 与 ENTRYPOINT 这两条指令的异同点，并通过一个实例指导你如何在 Dockerfile 中使用它们。

Docker ENTRYPOINT 指令

ENTRYPOINT 指令的语义为**”容器入口点”**，该指令用于设置容器首次启动时需要执行的命令（Command）及其参数（Parameters）。

任何传递至 docker run <image> ... 的命令行参数都会被附加到 ENTRYPOINT 命令后，并覆盖原有 CMD 指令。

Docker 规定，在 Dockerfile 中使用全大写字母的 ENTRYPOINT 指令， ENTRYPOINT 有两种形式： exec形式 与 shell命令形式 。

  • ENTRYPOINT [“executable”, “param1”, “param2”]

  • ENTRYPOINT command param1 param2

    Docker ENTRYPOINT 指令的最佳实践是：准备一枚 entrypoint.sh 启动脚本，将程序运行的具体逻辑放到启动脚本之中。

    例如，Postgres 官方镜像 Dockerfile 中，就使用了一枚启动脚本作为容器入口点 ENTRYPOINT 。

    COPY ./docker-entrypoint.sh / ENTRYPOINT ["/docker-entrypoint.sh"] CMD ["postgres"]

    注：Postgres Official Image Dockerfile

    Docker ENTRYPOINT 指令也是可以被重载的（虽然不常用），我们可以使用 docker run --entrypoint 重载 ENTRYPOINT 指令。

    Docker CMD 指令

    Docker CMD 指令也可以设置容器启动时需要执行的命令（Command）及其参数（Parameters），但 CMD 指令的主要目的提供可运行容器的默认命令，并为 ENTRYPOINT 指令提供默认参数。 CMD 指令将会在 ENTRYPOINT 后执行。

    CMD 指令有三种形式，如果省略执行命令， CMD 将为 ENTRYPOINT 提供默认参数。

  • CMD [“executable”, “param1”, “param2”]

  • CMD [“param1”, “param2”]

  • CMD command param1 param2

    使用 docker run <image> ... 启动容器，传递至 docker run <image> ... 的命令行参数会覆盖掉原有 CMD 指令。

    Docker CMD 指令的最佳实践为：为 ENTRYPOINT 指令提供默认参数。

    注：在 Dockerfile 中，只允许一条 CMD 指令出现，如果出现了多条，只有最后一条 CMD 指令生效。

    实例：构建 Redis 镜像

    接下来，我们手写一枚 Redis 镜像 Dockerfile ，来理解与实践 CMD 与 ENTRYPOINT 。 

    # -------------------------
#  Dockerfile - Redis 5.0.5
# -------------------------
# ================================
# Using Base OS -> CentOS 7 Latest
# ================================
FROM       docker.io/centos:latest
# =============================================
# LABEL following the standard set of labels by
# The Open Containers Initiative (OCI)
# =============================================
LABEL      org.opencontainers.image.title="DockerImage - Redis" \
           org.opencontainers.image.authors="zihengCat" \
           org.opencontainers.image.version="1.0.0" \
           org.opencontainers.image.licenses="MIT" \
# ==============================================================
RUN        PKG_BASE_DEPS="epel-release \
                          make \
                          gcc \
                          gcc-c++" && \
           REDIS_PKG_PATH="/root/redis-5.0.5.tar.gz" && \
           REDIS_PKG_ROOT="/root/redis-5.0.5/" && \
           REDIS_PKG_INSTALLED="/opt/redis_5.0.5/" && \
           REDIS_PKG_URL="http://download.redis.io/releases/redis-5.0.5.tar.gz" && \
           cp "/usr/share/zoneinfo/Asia/Shanghai" "/etc/localtime" && \
           echo "Asia/Shanghai" > "/etc/timezone" && \
           yum -y install "epel-release" && \
           yum -y install ${PKG_BASE_DEPS} && \
           curl -o ${REDIS_PKG_PATH} ${REDIS_PKG_URL} && \
           cd "/root/" && \
           tar -xvz -f ${REDIS_PKG_PATH} && \
           cd ${REDIS_PKG_ROOT} && \
           make V=1 && \
           make PREFIX=${REDIS_PKG_INSTALLED} install && \
           rm -rf ${REDIS_PKG_ROOT} ${REDIS_PKG_PATH} && \
           yum -y autoremove ${PKG_BASE_DEPS} && \
           yum clean all
# ======================================
WORKDIR    /root/
# ======================================
# Using a Docker `entrypoint.sh` and CMD
# ======================================
COPY ./entrypoint.sh /root/
ENTRYPOINT ["sh", "/root/entrypoint.sh"]
CMD ["redis-cli"]
# ======================================
# EOF

    代码清单：Redis镜像Dockerfile
    

    这里，我们使用一枚启动脚本entrypoint.sh作为容器入口点ENTRYPOINT，该脚本接受命令行参数并执行相应的命令。使用CMD指令为启动脚本提供默认参数redis-cli。
    

    #!/bin/bash
# -------------------------------
set -e
# -------------------------------
REDIS_FLAG=false
REDIS_PATH='/opt/redis_5.0.5/bin'
REDIS_COMMANDS="redis-cli \
                redis-server"
# -------------------------------
for redis_cmd in ${REDIS_COMMANDS}
    if [[ ${1} == ${redis_cmd} ]]
        REDIS_FLAG=true
# -------------------------------
if [[ ${REDIS_FLAG} == true ]]
    ${REDIS_PATH}/${@}
    echo '[ERROR]: No such Redis command...'
    exit 1
# -------------------------------
# EOF

    代码清单：Redis镜像entrypoint.sh
    

    使用docker build构建起Redis镜像后，可在docker run后附加容器需执行的Redis命令及其参数。
    

    #!/bin/bash
# ------------------------------
REDIS_COMMAND="redis-server"
REDIS_OPTIONS="--loglevel verbose \
               --bind 0.0.0.0 \
               --port 6379 \
               --requirepass foobar123 \
               --maxclients 10000 \
               --timeout 0 \
               --tcp-keepalive 300 \
               --daemonize no \
               --supervised no \
               --pidfile none \
               --databases 32 \
               --always-show-logo yes \
               --appendonly no \
               --appendfsync no"
# ------------------------------
sudo docker run -d -i -t \
                --env LC_ALL=en_US.UTF-8 \
                --name redis_test \
                -p 0.0.0.0:6379:6379 \
                ziheng/redis:latest \
                ${REDIS_COMMAND} ${REDIS_OPTIONS}
# ------------------------------
# EOF

    代码清单：Redis镜像docker run启动命令
    

    总结
    Docker CMD 与 ENTRYPOINT 指令都可以定义容器启动时执行的命令，但它们有所不同。
    

  • Dockerfile中只应出现一条CMD或ENTRYPOINT指令
    

  • ENTRYPOINT定义容器启动时的运行命令
    

  • CMD为ENTRYPOINT提供默认参数，或提供一枚单次执行的Ad-Hoc命令
    

  • CMD可以很容易地被容器运行时指定的命令行参数重载
    

  • Docker’s Dockerfile Reference: https://docs.docker.com/engine/reference/builder/
    •
    •  
    推荐文章
    性感的鸵鸟  ·  解决Dockerfile构建失败问题
    1 月前
    勤奋的鸭蛋  ·  RUN Instruction Using 'cd' Instead of WORKDIR - KICS
    1 月前
    坚强的山楂  ·  Binary polynomial division (R2022b) - MATLAB Answers - MATLAB Central
    3 月前
    彷徨的铁链  ·  唐河往年各校中考分数线！附：最新中招加分政策标准！唐河县2022年普通高中招生计划_实验_命题_体育
    5 月前
    玩足球的乒乓球  ·  Mac catalina 10.15降级到Mac Sierra 10.12.6的一波多折_安装器有效负载签名检查失败-CSDN博客
    5 月前
    没读研的小蝌蚪  ·  日语点歌系统、日语歌库、音创歌曲云更新、音创A70、A71、H5S安卓盒子、雷石、视易、礼光、天行歌库更新、武汉点歌系统KTV音响批发、家用智能点歌机 - 软件浏览 - 礼光后羿VOD电脑点歌系统V4
    5 月前
    坏坏的香槟  ·  紫金红葫芦是谁的武器 – 快看漫画问答
    5 月前
    Link管理   ·   51好读   ·   Sov5搜索   ·   小百科
    link管理 - 链接快照平台