02-Dockerfile语法

前言
什么是Dockerfile？
指令说明
- FROM
- RUN
- COPY
- ADD
用于支持包含空格的路径
Dockerfile编写
总结

前言

学习Dockerfile语法，编写Dockerfile文件

什么是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 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。 ```dockerfile 语法： ADD …
用于支持包含空格的路径
ADD [““,… ““]

示例： ADD home /path/ # 支持通配符 添加所有以”home”开头的文件到/path/ 下

<a name="EXPOSE"></a>
### EXPOSE
说明：`EXPOSE` 指定与外界交互的端口<br />作用：
- 帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射。
- 在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口。
```dockerfile
语法：
    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的示例

前言