使用Dockerfile构建镜像

Dockerfile

构建镜像

docker 可以从 Dockerfile 文件中读取定义好的镜像并构建出镜像。进入 Dockerfile 所在的目录，并运行：

docker build .

也可以通过 -f 参数指定 Dockerfile 文件进行构建：

docker build -f /path/to/a/Dockerfile .

构建并指定一个或多个tag:

docker build -t shykes/myapp .
docker build -t shykes/myapp:1.0.2 -t shykes/myapp:latest .

Dockerfile文件指令

FROM

定制的镜像是基于 FROM 的镜像。

FROM busybox

RUN

RUN：用于执行后面跟着的命令行命令。有以下两种格式：

RUN <命令行命令>
RUN ["可执行文件", "参数1", "参数2"]

注意：Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大。可以使用 && 符号连接命令，减少创建的镜像层。

ENV

指定环境变量。

ENV FOO=/bar

ARG

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

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

ARG  CODE_VERSION=latest
FROM base:${CODE_VERSION}
CMD  /code/run-app

FROM extras:${CODE_VERSION}
CMD  /code/run-extras

WORKDIR

指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。（WORKDIR 指定的工作目录，必须是提前创建好的）。

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

WORKDIR /app

USER

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

USER <user>[:<group>]
或
USER <UID>[:<GID>]

VOLUME

定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。在启动容器 docker run 的时候，我们可以通过 -v 参数修改挂载点。

VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]

COPY

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

COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

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

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

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

ADD

ADD 指令和 COPY 的使用格式一致（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：

• ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
• ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

ADD hom* /mydir/
ADD hom?.txt /mydir/

EXPOSE

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

EXPOSE 80/tcp
EXPOSE 80/udp

CMD

类似于 RUN 指令，用于运行程序，但二者运行的时间点不同:

• CMD 在docker run 时运行。
• RUN 是在 docker build。

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

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

CMD 有三种格式：

CMD ["executable","param1","param2"] 
CMD ["param1","param2"]
CMD command param1 param2

EXPOSE 5900

ENTRYPOINT

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

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

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

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

格式：

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

dockerignore

如果存在 .dockerignore 文件, docker build 将排除其中匹配的文件和目录，可以避免使用ADD或COPY指令将不必要的文件和目录发送到守护进程。下面是一个示例：

# comment
*/temp*
*/*/temp*
temp?

通配符要满足 Go 的 filepath.Match 规则： https://golang.org/pkg/path/filepath#Match