文章目录
1. Dockerfile
通常使用 Dockerfile 创建镜像，Dockerfile是一个 Docker 镜像的描述文件，其内部包含了一条条的指令，每一条指令构建一层，每一条指令的内容，就是描述该层应当如何构建。每条指令按顺序依次执行
2. 指令详解
2.1 FROM
指定基础镜像，并且必须是 Dockerfile 的第一条指令，如果不以任何镜像为基础，那么写法为：FROM scratch
FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>
# 例如
FROM scratch
FROM centos:6
FROM ubuntu
2.2 MAINTAINER
指定作者信息
MAINTAINER <name>
# 例如
MAINTAINER shenke <[email protected]>
注：新版 docker 建议使用 LABEL 声明
2.3 LABEL
为镜像指定标签
LABEL <key>=<value> <key>=<value> <key>=<value> ···
# 例如
# 内容过长可用 \ 换行
LABEL maintainer="shenke" \
version="1.0" \
desc="This is \
a short description."
2.4 RUN
构建镜像时执行的 Shell 命令
RUN <command>
RUN ["executable", "param1", "param2"]
# 例如
RUN sh run.sh
RUN ["sh", "run.sh"]
RUN ["yum", "install", "nginx"]
2.5 CMD
启动容器时执行的 Shell 命令
CMD command param1 param2
CMD ["param1","param2"]
CMD ["executable","param1","param2"]
# 例如
CMD echo $HOME
CMD ["sh", "run.sh"]
CMD [ "sh", "-c", "echo $HOME"]
RUN与CMD的区别：
RUN指定的是构建镜像时要执行的命令，即docker build过程中要执行的命令CMD指定的是启动容器时要执行的命令，即docker run时要执行的命令。CMD指令的首要目的在于为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。注意：CMD指令指定的程序可被docker run命令行参数中指定要运行的程序所覆盖
2.6 ENTRYPOINT
启动容器时执行的 Shell 命令
ENTRYPOINT command param1 param2
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT与CMD的异同：
- 都是在启动容器时执行
ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指令指定的程序
2.7 EXPOSE
暴露容器端口给外部
EXPOSE <port>/<tcp/udp>
# 例如
EXPOSE 80/tcp 443/tcp
2.8 ADD
将主机文件或目录拷贝到镜像中，URL 会自动下载，压缩包会自动解压
ADD <src> ··· <dest>
ADD ["<src>", ··· "<dest>"]
# 例如
ADD nginx-1.16.1.tar.gz /usr/local # 将 nginx 压缩包解压到 /usr/local 目录下，即 /usr/local/nginx-1.16.1
ADD https://xxx.com/html.tar.gz /var/www/html # 下载压缩包并解压到 /var/www/html 目录下
注意：
- src 为一个目录的时候，会自动把目录下的文件复制过去，目录本身不会复制
- 如果 src 为多个文件，dest 必须是一个目录
2.9 COPY
将主机文件或目录拷贝到镜像中，同 ADD 类似，只是不支持自动下载和解压
ADD <src> ··· <dest>
ADD ["<src>", ··· "<dest>"]
2.10 ENV
设置环境变量
ENV <key> <value>
ENV <key>=<value> ···
# 例如
ENV JAVA_HOME /usr/local/jdk
ENV MYSQL_ROOT_PASSWORD=123456 VERSION=1.0 NAME="Hello docker"
2.11 WORKDIR
为 RUN、CMD、ENTRYPOINT 以及 COPY 和 ADD 设置工作目录
WORKDIR /path/workdir
# 例如
WORKDIR /root
2.12 USER
设置启动容器的用户
USER <user>[:<usergroup>]
USER <UID>[:<UID>]
# 例如
USER root
2.13 VOLUME
实现文件挂载功能，可以将主机目录挂载到容器中，一般的使用场景为需要持久化存储数据时
VOLUME ["/data"]
2.14 ARG
在构建镜像时，传入一些参数
ARG <name>[=<default value>]
# 例如
ARG version=1.0
ARG user
USER $user
在 docker build 构建镜像的时候，使用 --build-arg 来指定参数，若未指定参数则会使用默认值，若未指定默认值就会报错
docker build --build-arg user=root -t myimage:1.0 .
2.15 HEALTHCHECK
健康检查，即指定如何测试容器以检查它是否仍在工作
HEALTHCHECK [OPTIONS] CMD command
HEALTHCHECK NONE # 在基础镜像中取消健康检查命令
# 例如
HEALTHCHECK --interval=5m --timeout=3s --start-period=0s --retries=3 \
CMD curl -f http:/localhost/ || exit 1
OPTIONS：
--interval=DURATION：每隔多长时间探测一次，默认30秒--timeout=DURATION：服务响应超时时长，默认30秒--start-period=DURATION：服务启动多久后开始探测，默认0秒--retries=N：认为检测失败几次为宕机，默认3次
返回值：
0：容器健康，随时可以使用1：容器不健康，无法使用2：保留值
