1 Dockerfile介绍

Dockerfile 就是我们用来构建Docker镜像的一些命令的集合，一个Dockerfile里面包含了构建整个镜像（image）的完整命令。Docker通过docker build执行Dockerfile中的一系列命令自动构建image。

简单来说，Dockerfile 就是可以让我们个性化定制Docker镜像，来满足实际工作中各式各样的需求。

2 Dockerfile文件说明

Dockerfile 由一行行命令语句组成，以#开头的注释行 Dockerfile分为四部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。

2.1 定义运行jar包的镜像

Dockerfile 定义一个运行jar包的镜像

# 指定基础镜像
FROM openjdk:8-alpine3.9

# `RUN`  构建镜像时执行的命令，这里创建一个目录
RUN mkdir -p /docker-demo
# WORKDIR 工作目录，类似于cd命令
WORKDIR /docker-demo

#  用于指定传递给构建运行时的变量
ARG JAR_FILE=target/docker-demo.jar

#  把传过来的jar名称，重命名为app.jar
COPY ${JAR_FILE} app.jar

# 向外界暴露8080端口
EXPOSE 8080
# 设置两个环境变量，TZ=Asia/Shangha 修改时区。JAVA_OPTS="..." java运行时JVM参数
ENV TZ=Asia/Shanghai JAVA_OPTS="-Xms128m -Xmx256m -Djava.security.egd=file:/dev/./urandom"

#容器启动命令，在容器启动时才进行调用
CMD java -jar app.jar $JAVA_OPTS

构建镜像

把上面创建的Dockerfile 上传到服务器，使用docker build构建

到Dockerfile 所在目录执行

docker build --rm -t dockerdemo:v1 --build-arg JAR_FILE=dockerdemo.jar .

--build-arg 设置镜像创建时的变量，也就是JAR_FILE

# 查看镜像
docker image ls

关于docker build命名请看下面👇的内容

2.2 Dockerfile常见命令

FROM 指定基础镜像，第一条指令必须是FROM。除了选择现有镜像为基础镜像外，Docker 还存在一个特殊的镜像，名为 scratch。这个镜像是虚拟的概念，并不实际存在，它表示一个空白的镜像。
MAINTAINER 定义作者的一些信息。
RUN 构建镜像时执行的命令，比如执行echo命名。
```
RUN echo '<h1>Hello, world!</h1>' > index.html
```

ENV 设置环境变，命名格式有如下两种：

ENV <key> <value>

ENV <key1>=<value1> <key2>=<value2>...

CMD 容器启动命令，在容器启动时才进行调用。命令格式有如下两种：

# shell 格式
CMD <命令>   # 例如运行jar，CMD sleep 30; java -jar app.jar

# exec 格式
CMD ["可执行文件", "参数1", "参数2"...]

ENTRYPOINT 指定运行容器启动过程执行命令，覆盖CMD参数 ENTRYPOINT与CMD非常类似，不同的是通过docker run执行的命令不会覆盖 ENTRYPOINT，而docker run命令中指定的任何参数，都会被当做参数再次传递给ENTRYPOINT。Dockerfile中只允许有一个ENTRYPOINT命令，多指定时会覆盖前面的设置，而只执行最后的ENTRYPOINT指令。例如运行jar包：
```
ENTRYPOINT ["java","-jar","/app.jar"]
```
详细介绍可以参考：https://yeasy.gitbook.io/docker_practice/image/dockerfile/entrypoint
ADD 将本地文件添加到容器中，tar类型文件会自动解压。
COPY 复制文件，功能类似ADD，但是是不会自动解压文件。
WORKDIR 使用 WORKDIR 指令可以来指定工作目录（或者称为当前目录），以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR 会帮你建立目录。
ARG 用于指定传递给构建运行时的变量。构建参数和 ENV 的效果一样，都是设置环境变量。所不同的是，ARG 所设置的构建环境的环境变量，在将来容器运行时是不会存在这些环境变量的
VOLUMN 定义匿名卷，容器运行时应该尽量保持容器存储层不发生写操作，对于数据库类需要保存动态数据的应用，其数据库文件应该保存于卷(volume)中。其命名格式有如下两种方式：
```
VOLUME ["<路径1>", "<路径2>"...]

VOLUME <路径>
```
EXPOSE 指定于外界交互的端口
USER 指令和 WORKDIR 相似，都是改变环境状态并影响以后的层。WORKDIR 是改变工作目录，USER 则是改变之后层的执行 RUN, CMD 以及 ENTRYPOINT 这类命令的身份。

注意，USER 只是帮助你切换到指定用户而已，这个用户必须是事先建立好的，否则无法切换。

3 docker build 命令

docker build 命令用于使用 Dockerfile 创建镜像。

语法

docker build [OPTIONS] PATH | URL | -

常用OPTIONS说明：

**–build-arg=[] 😗*设置镜像创建时的变量；
**-f 😗*指定要使用的Dockerfile路径，如果在Dockerfile当前目录执行docker build，可以省略-f参数，使用 . (点) 代替；
**–rm 😗*设置镜像过程中删除中间容器；
**-m 😗*设置内存最大值；
**–quiet, -q 😗*安静模式，成功后只输出镜像 ID；
–tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构建中为一个镜像设置多个标签。

上面我们在执行Dockerfile 定义一个运行jar包的镜像，已经使用过一次

docker build --rm -t dockerdemo:v1 --build-arg JAR_FILE=dockerdemo.jar .

4 小栗子🌰

4.1 自定义Mysql镜像

自定义Mysql镜像，修改时区，并自动执行初始化脚本。

FROM mysql:5.7.36

MAINTAINER warybee  warybee@gmail.com

# 修改mysql时区
ENV TZ=Asia/Shanghai

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

# 自动执行初始化sql脚本。
COPY init.sql /docker-entrypoint-initdb.d

4.2 定义运行jar包的镜像

# 指定基础镜像
FROM openjdk:8-alpine3.9

# `RUN`  构建镜像时执行的命令，这里创建一个目录
RUN mkdir -p /docker-demo
# WORKDIR 工作目录，类似于cd命令
WORKDIR /docker-demo

#  用于指定传递给构建运行时的变量
ARG JAR_FILE=target/docker-demo.jar

#  把传过来的jar名称，重命名为app.jar
COPY ${JAR_FILE} app.jar

# 向外界暴露8080端口
EXPOSE 8080
# 设置两个环境变量，TZ=Asia/Shangha 修改时区。JAVA_OPTS="..." java运行时JVM参数
ENV TZ=Asia/Shanghai JAVA_OPTS="-Xms128m -Xmx256m -Djava.security.egd=file:/dev/./urandom"

#容器启动命令，在容器启动时才进行调用
CMD java -jar app.jar $JAVA_OPTS