Dockerfile的指令和编写

每个优秀的人，背后都有一段沉默的时光

前言

学习Docker基础知识

什么是Dockerfile？

Dockerfile 是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明

指令说明

Dockerfile 的指令摘要

	FROM- 镜像从那里来

	MAINTAINER- 镜像维护者信息

	RUN- 构建镜像执行的命令，每一次RUN都会构建一层

	CMD- 容器启动的命令，如果有多个则以最后一个为准，也可以为ENTRYPOINT提供参数

	VOLUME- 定义数据卷，如果没有定义则使用默认

	USER- 指定后续执行的用户组和用户

	WORKDIR- 切换当前执行的工作目录

	HEALTHCHECH- 健康检测指令

	ARG- 变量属性值，但不在容器内部起作用

	EXPOSE- 暴露端口

	ENV- 变量属性值，容器内部也会起作用

	ADD- 添加文件，如果是压缩文件也解压

	COPY- 添加文件，以复制的形式

	ENTRYPOINT- 容器进入时执行的命令

FROM

说明：FROM是指定基础镜像，必须为第一个命令

语法：

	FROM <image>:<tag>

示例：

	FROM mysql:5.7

RUN

说明：RUN 用来执行构建镜像时执行的命令，有以下两种命令执行方式

语法：

	`shell` 执行格式：

		RUN <command>

	`exec` 执行格式：

		RUN ["executable", "param1", "param2"]

示例：

	`shell`格式：

		RUN apk update

	`exec`格式：

		RUN ["/dev/file", "p1", "p2"]

COPY

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

语法：

	COPY [--chown=<user>:<group>] <源路径1>...  <目标路径>

	COPY [--chown=<user>:<group>] ["<源路径1>",...  "<目标路径>"]

	**[--chown=<user>:<group>]**：可选参数，用户改变复制到容器内文件的拥有者和属组。

	**<源路径>**：源文件或者源目录，这里可以是通配符表达式。

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

示例：

	COPY hom* /mydir/

	COPY hom?.txt /mydir/

ADD

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

与COPY不同之处：

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

语法：

	ADD <src>... <dest>

	# 用于支持包含空格的路径

	ADD ["<src>",... "<dest>"]

示例：

	ADD home _/path/ # 支持通配符_ 添加所有以"home"开头的文件 到/path/ 下

EXPOSE

说明：EXPOSE 指定与外界交互的端口

作用：

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

语法：

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

示例：

	EXPOSE 8080 443

ENV 指令

说明：ENV 用来设置环境变量

语法：

	ENV <key> <value> # 之后的所有内容均会被视为其的组成部分，因此，一次只能设置一个变量

	ENV <key>=<value> ... #可以设置多个变量，每个变量为一个"="的键值对，如果中包含空格，可以使用\来进行转义，也可以通过""来进行标识；另外，`\` 也可以用于续行

示例：

	ENV version 1.0.0

	ENV version=1.0.0

CMD

说明：CMD 构建容器后执行的命令，也就是在容器启动时才执行的命令。

语法：

	# 执行可执行文件，优先执行

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

	# 设置了 ENTRYPOINT，则直接调用ENTRYPOINT添加参数  参见 CMD 讲解

	CMD ["param1","param2"]

	# 执行shell命令

	CMD command param1 param2

示例：

	CMD ["/usr/bin/bash","--help"]

WORKDIR

说明：WORKDIR 用来指定工作目录，类似于我们通常使用的cd 命令

语法：

	WORKDIR <PATH>

示例：

	WORKDIR /user/local

VOLUME

说明：VOLUME 用于指定持久化目录

语法：

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

	VOLUME <路径>

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

示例：

	VOLUME ["/data"]

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

ENTRYPOINT

说明：ENTRYPOINT 用来配置容器，使其可执行化。配合 CMD可省去 application，只使用参数。

语法：

	# 可执行文件, 优先

	ENTRYPOINT ["executable", "param1", "param2"]

	# shell内部命令

	ENTRYPOINT command param1 param2

示例：

    ENTRYPOINT ["top", "-b"]

LABEL

说明：LABEL：用于为镜像添加元数据,多用于声明构建信息，作者、机构、组织等。

语法：

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

示例：

	LABEL version="1.0" description="felord.cn" by="Felordcn"

Dockerfile编写

示例1

# 使用 aws 的java jdk 8

FROM amazoncorretto:8

# 作者等相关的元信息

LABEL AUTHOR=Felordcn OG=felord.cn

# 挂载卷

VOLUME ["/tmp","/logs"]

# 时区

ENV TZ=Asia/Shanghai

# 启用配置文件 默认为 application.yml

ENV ACTIVE=defualt

# 设置镜像时区

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 修改为打包后的jar文件名称

ADD /target/flyway-spring-boot-1.0.0.jar app.jar

ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-Dspring.profiles.active=${ACTIVE}","-jar","app.jar"]

示例2

# Docker image for springboot file run

# VERSION 0.0.1

# Author: eangulee

# 基础镜像使用java

FROM java:8

# 作者

MAINTAINER eangulee <tom@gmail.com>

# VOLUME 指定了临时文件目录为/tmp。

# 其效果是在主机 /var/lib/docker 目录下创建了一个临时文件，并链接到容器的/tmp

VOLUME /tmp

# 将jar包添加到容器中并更名为app.jar

ADD cloud-test-1.0-SNAPSHOT.jar app.jar

# 运行jar包

RUN bash -c 'touch /app.jar'

ENTRYPOINT ["java","-jar","/app.jar"]

总结

本文记录了dockerfile的指令使用及说明，另外和两个springboot项目dockerfile的示例