如何使用 Dockerfile自定义镜像？

2019 年 11 月 21 日
笔记

之前在隔壁专题(公众号出门左转 Nginx专题) 推送过一篇文章 Nginx 缓存服务器(番外)定制Docker镜像。

我们将 ngx_cache_purge模块添加到自定义的 Nginx镜像中，避免每次创建容器后再次安装模块这个繁琐的步骤。

今天使用一个 Java项目的示例，介绍下如何使用 Dockerfile 创建一个自定义Java镜像，以及在 Dockerfile 中常用的一些指令。

环境描述

容器镜像: openjdk:8-jre  容器系统: debian 8 (jessie)  Docker主机: Ubuntu Server 16.04  CI工具: Jenkins & Maven  项目程序: 编译好的 bms.jar 包

操作步骤

1. 准备 Dockerfile

cat bms/Dockerfile    # bms  FROM openjdk:8-jre  MAINTAINER dongnan    # apt  COPY conf/sources.list /etc/apt/sources.list  RUN apt-get update && apt-get install -y           wkhtmltopdf xvfb           && apt-get clean && rm -r /var/lib/apt/lists/*    # env  ENV TZ=Asia/Shanghai       LANG=C.UTF-8    # package  COPY src/bms.jar /root/bms.jar    # workdir  WORKDIR /root/    # statement Port  EXPOSE 8080    # cmd  CMD ["java"，"-jar"，"/root/bms.jar"]

2. 构建镜像

守护进程读取 Dockerfile 文件然后按照文件中的指令顺序执行。构建镜像时会一层层构建，前一层是后一层的基础，每一层构建完就不会再发生改变，后一层上的任何改变只发生在自己这一层。

docker build -t bms:0.0.1 .  Sending build context to Docker daemon 2.048 mb  # 省略....  Successfully built cd34135ed904

注意: docker build 命令最后有一个. 表示当前目录，而 Dockerfile 就在当前目录，是在指定上下文路径。

3. 验证镜像

尝试使用这个镜像创建一个容器，如果容器正常运行说明构建成功。

docker run --name test -tid bms:0.0.1

镜像使用的是分层存储容器也是如此，每个容器运行时是以镜像为基础层，在其上创建一个当前容器的存储层。

容器运行后修改了容器内的文件，也就是改动了容器的存储层，通过 docker diff 命令看到具体的改动。

docker container diff test  C /root         # C 改变  A /root/logs    # A 添加  A /root/logs/bms.log  C /tmp  A /tmp/tomcat-docbase.1383167136.9290

4. 命令帮助

docker build --help

Dockerfile 常用指令

Dockerfile 中每一个指令都会建立一层，上面的示例创建了9层镜像。

FROM: 用于指定基础镜像，一个有效的 Dockerfile 必须使用 FROM做第一个指令。  MAINTAINER: 用于设置作者信息。  RUN: 是用来执行命令的，并将结果提交到当前镜像层。  ENV: 设置环境变量，无论是后面的其它指令，还是运行时的容器，都可以直接使用这个环境变量。  COPY: 将从构建上下文目录中 <源> 文件/目录复制到新的一层的镜像内的 <目标> 位置。  ADD: 与 `COPY` 指令功能基本一致。但是在 COPY 基础上增加了一些功能，例如 ADD会做自动解压工作。  WORKDIR: 用来指定工作目录(**当前目录**)，如该目录不存在则会帮你建立目录。  EXPOSE: 是声明运行时容器提供服务端口，这只是一个声明，在运行时并不会因为这个声明就会开启这个端口。  CMD: 用于指定默认容器主进程的启动命令(容器就是进程，在启动容器的时候需要指定所运行的程序及参数)。

Dockerfile 最佳实践

部分摘选

1. 在 Docker 官方的 Dockerfile 最佳实践文档中要求尽可能的使用 COPY，因为COPY 的语义很明确，就是复制文件而已，而 ADD 最适合使用的场景就是需要自动解压缩的场景。

2. 另外需要注意的是ADD 指令会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。

3. CMD 指令用于执行目标镜像中包含的软件可以包含参数，CMD 大多数情况下都应该以 CMD ["executable", "param1", "param2"...] 的形式使用，例如 CMD ["nginx", "-g", "daemon off;"]

4. RUN 与 CMD 的区别，RUN 在构建镜像时执行，CMD则是在镜像构建成功后在容器中执行。