docker-Dockerfile文件使用配置、自定义构建镜像、docker build

末蓝、 2023-10-09 19:26 86阅读 0赞

Dockerfile使用

  • docker build构建新的镜像
    • 参数解释
  • Dockerfile格式
    • 基础格式
    • FROM
    • COPY
    • ADD
    • RUN
    • CMD
    • ENTRYPOINT
    • ENV
    • ARG
    • VOLUME
    • EXPOSE
    • WORKDIR
    • USER
    • HEALTHCHECK
    • ONBUILD
    • LABEL
  • 命令摘要

docker build构建新的镜像

命令：docker build -t some-content-nginx .

参数解释

  • docker build：构建Docker镜像的命令
  • some-content-nginx：镜像的名称
  • -t：指定镜像的名称和标签，格式为<name>:<tag>
  • .：上下文路径，Dockerfile所在的路径。在这个例子中，Dockerfile文件在当前目录下，因此使用”.”来表示当前目录。上下文路径，是指 docker 在构建镜像，有时候想要使用到本机的文件（比如复制），docker build 命令得知这个路径后，会将路径下的所有内容打包。

执行这个命令后，Docker将会根据Dockerfile文件中的指令来构建一个新的镜像，并将其命名为some-content-nginx。

注意：上下文路径下不要放无用的文件，因为会一起打包发送给 docker 引擎，如果文件过多会造成过程缓慢。

Dockerfile格式

基础格式

  1. FROM nginx
  2. COPY /static-html-directory /usr/share/nginx/html

FROM

使用nginx作为基础镜像
如果本地没有nginx镜像，将会尝试去Docker Hub上拉取NGINX镜像

COPY

复制指令，从上下文目录中复制文件或者目录到容器里指定路径。
格式

  1. COPY [--chown=<user>:<group>] <源路径1>...  <目标路径>
  • [--chown=<user>:<group>]
    可选参数，改变复制到容器内文件的拥有者和属组。

  • 源路径
    源文件或者源目录，这里可以是通配符表达式，其通配符规则要满足 Go 的 filepath.Match 规则。例如：

    COPY hom* /mydir/
    COPY hom?.txt /mydir/

  • 目标路径
    容器内的指定路径，该路径不用事先建好，路径不存在的话，会自动创建

ADD

ADD 指令和 COPY 的使用格类似（同样需求下，官方推荐使用 COPY）

RUN

用于执行后面跟着的命令行命令
俩种格式

  • shell 格式

    RUN <命令行命令>

    <命令行命令> 等同于，在终端操作的 shell 命令

  • exec 格式

    RUN [“可执行文件”, “参数1”, “参数2”]

    例如：

    RUN [“./test.php”, “dev”, “offline”] 等价于 RUN ./test.php dev offline

注意：Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大。例如：

  1. FROM centos
  2. RUN yum -y install wget
  3. RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
  4. RUN tar -xvf redis.tar.gz

以上执行会创建 3 层镜像。可简化为以下格式：

  1. FROM centos
  2. RUN yum -y install wget \
  3.     && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" \
  4.     && tar -xvf redis.tar.gz

如上，以 && 符号连接命令，这样执行后，只会创建 1 层镜像。

示例

  1. FROM nginx
  2. RUN echo '这是一个本地构建的nginx镜像' > /usr/share/nginx/html/index.html

这个Dockerfile中，FROM指令指定了使用官方的nginx镜像作为基础镜像。然后，RUN指令运行了一个命令，将一段文本写入到Nginx的默认HTML文件中。具体来说，这个命令将“这是一个本地构建的nginx镜像”这段文本写入到了Nginx的默认HTML文件/usr/share/nginx/html/index.html中。

CMD

为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。
CMD 指令指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖。

注意：如果 Dockerfile 中如果存在多个 CMD 指令，仅最后一个生效。

格式

  1. CMD <shell 命令> 
  2. CMD ["<可执行文件或命令>","<param1>","<param2>",...] 
  3. CMD ["<param1>","<param2>",...]  # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数

推荐使用第二种格式，执行过程比较明确。第一种格式实际上在运行的过程中也会自动转换成第二种格式运行，并且默认可执行文件是 sh。

示例：
nginx官方文档说明构建nginx镜像的CMD命令需要包含-g daemon off：

  1. If you add a custom CMD in the Dockerfile, be sure to include -g daemon off; in the CMD in order for nginx to stay in the foreground, so that Docker can track the process properly (otherwise your container will stop immediately after starting)!

翻译过来：

  1. 如果您在Dockerfile中添加了一个自定义CMD，请确保包含-g daemon off；在CMD中，以便nginx停留在前台，以便Docker能够正确跟踪进程（否则您的容器在启动后会立即停止）！

看一下不适应CMD构建的镜像命令：
在这里插入图片描述

进入nginx容器看一下nginx执行命令：
在这里插入图片描述

ENTRYPOINT

类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。

但是, 如果运行 docker run 时使用了 —entrypoint 选项，将覆盖 ENTRYPOINT 指令指定的程序。

优点：在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数。

注意：如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。

格式

  1. ENTRYPOINT ["<executeable>","<param1>","<param2>",...]

可以搭配 CMD 命令使用：一般是变参才会使用 CMD ，这里的 CMD 等于是在给 ENTRYPOINT 传参，以下示例会提到。

示例
假设已通过 Dockerfile 构建了 nginx:test 镜像：

  1. FROM nginx
  3. ENTRYPOINT ["nginx", "-c"] # 定参
  4. CMD ["/etc/nginx/nginx.conf"] # 变参

  • 1、不传参运行

    docker run nginx:test

容器内会默认运行以下命令，启动主进程。

  1. nginx -c /etc/nginx/nginx.conf

  • 2、传参运行

    docker run nginx:test -c /etc/nginx/new.conf

容器内会默认运行以下命令，启动主进程(/etc/nginx/new.conf:假设容器内已有此文件)

  1. nginx -c /etc/nginx/new.conf

ENV

设置环境变量，定义了环境变量，那么在后续的指令中，就可以使用这个环境变量。

格式

  1. ENV <key> <value>
  2. ENV <key1>=<value1> <key2>=<value2>...

示例
设置 NODE_VERSION = 7.2.0 ， 在后续的指令中可以通过 $NODE_VERSION 引用：

  1. ENV NODE_VERSION 7.2.0
  3. RUN curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.xz" \
  4.   && curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/SHASUMS256.txt.asc"

ARG

构建参数，与 ENV 作用一致。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。

构建命令 docker build 中可以用 —build-arg <参数名>=<值> 来覆盖。

格式

  1. ARG <参数名>[=<默认值>]

VOLUME

定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。

作用：

  • 避免重要的数据，因容器重启而丢失，这是非常致命的。
  • 避免容器不断变大。

格式

  1. VOLUME ["<路径1>", "<路径2>"...]
  2. VOLUME <路径>

在启动容器 docker run 的时候，我们可以通过 -v 参数修改挂载点。

EXPOSE

仅仅只是声明端口。

作用：

  • 帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射。
  • 在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口。

格式

  1. EXPOSE <端口1> [<端口2>...]

WORKDIR

指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR 会帮你建立目录。

docker build 构建镜像过程中的，每一个 RUN 命令都是新建的一层。只有通过 WORKDIR 创建的目录才会一直存在。

格式

  1. WORKDIR <工作目录路径>

USER

用于指定执行后续命令的用户和用户组，这边只是切换后续命令执行的用户（用户和用户组必须提前已经存在）。

格式

  1. USER <用户名>[:<用户组>]

HEALTHCHECK

用于指定某个程序或者指令来监控 docker 容器服务的运行状态。

格式

  1. HEALTHCHECK [选项] CMD <命令>：设置检查容器健康状况的命令
  2. HEALTHCHECK NONE：如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令
  4. HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用，可以参考 CMD 的用法。

ONBUILD

用于延迟构建命令的执行。简单的说，就是 Dockerfile 里用 ONBUILD 指定的命令，在本次构建镜像的过程中不会执行（假设镜像为 test-build）。当有新的 Dockerfile 使用了之前构建的镜像 FROM test-build ，这时执行新镜像的 Dockerfile 构建时候，会执行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。

格式

  1. ONBUILD <其它指令>

LABEL

LABEL 指令用来给镜像添加一些元数据（metadata），以键值对的形式，语法格式如下：

格式

  1. LABEL <key>=<value> <key>=<value> <key>=<value> ...

比如我们可以添加镜像的作者：

  1. LABEL org.opencontainers.image.authors="xwy"

命令摘要

  • FROM- 镜像从那里来
  • MAINTAINER- 镜像维护者信息
  • RUN- 构建镜像执行的命令，每一次RUN都会构建一层
  • CMD- 容器启动的命令，如果有多个则以最后一个为准，也可以为ENTRYPOINT提供参数
  • VOLUME- 定义数据卷，如果没有定义则使用默认
  • USER- 指定后续执行的用户组和用户
  • WORKDIR- 切换当前执行的工作目录
  • HEALTHCHECH- 健康检测指令
  • ARG- 变量属性值，但不在容器内部起作用
  • EXPOSE- 暴露端口
  • ENV- 变量属性值，容器内部也会起作用
  • ADD- 添加文件，如果是压缩文件也解压
  • COPY- 添加文件，以复制的形式
  • ENTRYPOINT- 容器进入时执行的命令

发表评论

表情：
评论列表 （有 0 条评论，86人围观）

还没有评论，来说两句吧...

相关阅读

    相关 Docker(二) 自定义镜像

    一、前言 记得上半年有一个需求是给服务(mysql)兼容oracle数据库，之前没有怎么接触过oracle数据库，也没有安装过，于是从同事那里要来了安装包（windows

    末蓝、末蓝、/ 0 赞/ 140 阅读