Dockerfile
一、Dockerfile概念
1.Dockerfile中所用的所有文件一定要和Dockerfile文件在同一级父目录下，可以为Dockerfile父目录的子目录
2.Dockerfile中相对路径默认都是Dockerfile所在的目录
3.Dockerfile中一定要惜字如金，能写到一行的指令，一定要写到一行，原因是分层构建，联合挂载这个特性。
Dockerfile中每一条指令被视为一层
4.Dockerfile中指明大写（约定俗成）
Dockerfile的完整示例如下所示：
#基于centos镜像
FROM centos
#维护人的信息
MAINTAINER The CentOS Project <123456789@qq.com>
#安装httpd软件包
RUN yum -y update
RUN yum -y install httpd
#开启80端口
EXPOSE 80
#复制网站首页文件至镜像中web站点下
ADD index.html /var/www/html/index.html
#复制该脚本至镜像中，并修改其权限
ADD run.sh /run.sh
RUN chmod 775 /run.sh
#当启动容器时执行的脚本文件
CMD ["/run.sh"]
由上可知，Dockerfile结构大致分为四个部分：
- 基础镜像信息
- 维护者信息
- 镜像操作指令
- 容器启动时执行指令。
二、Dockerfile命令解析
1、FROM
指明构建的新镜像是来自于哪个基础镜像，例如：
FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>
三种写法，其中<tag>和<digest> 是可选项，如果没有选择，那么默认值为latest
FROM centos:6
2、MAINTAINER
指明镜像维护着及其联系方式（一般是邮箱地址），例如：
MAINTAINER VillianTsang <villiantsang@qq.com>
MAINTAINER并不推荐使用，更推荐使用LABEL来指定镜像作者，例如：
LABEL maintainer="villiantsang.cn"
3、RUN
构建镜像时运行的Shell命令，例如：
RUN ["yum", "install", "httpd"]
RUN yum install httpd
4、CMD
启动容器时执行的Shell命令，例如：
CMD ["-C", "/start.sh"]
CMD ["/usr/sbin/sshd", "-D"]
CMD /usr/sbin/sshd -D
RUN&&CMD
不要把RUN和CMD搞混了。
RUN是构件容器时就运行的命令以及提交运行结果
CMD是容器启动时执行的命令，在构件时并不运行，构件时紧紧指定了这个命令到底是个什么样子
5、EXPOSE
声明容器运行的服务端口，例如：
EXPOSE <port>/<tcp/udp>
EXPOSE 80 443
PS：功能为暴漏容器运行时的监听端口给外部，但是EXPOSE并不会使容器访问主机的端口
PS：如果想使得容器与主机的端口有映射关系，必须在容器启动的时候加上 -P参数
6、ENV
设置环境内环境变量，例如：
ENV MYSQL_ROOT_PASSWORD 123456
ENV JAVA_HOME /usr/local/jdk1.8.0_45
7、ADD
拷贝文件或目录到镜像中，例如：
ADD <src>...<dest>
ADD html.tar.gz /var/www/html
ADD https://xxx.com/html.tar.gz /var/www/html
PS：如果是URL或压缩包，会自动下载或自动解压。
PS：路径的填写可以是容器内的绝对路径，也可以是相对于工作目录的相对路径，推荐写成绝对路径
PS：可以是一个本地文件或者是一个本地压缩文件，还可以是一个url
PS：如果把写成一个url，那么ADD就类似于wget命令
8、COPY
拷贝文件或目录到镜像中，用法同ADD，只是不支持自动下载和解压，例如：
COPY <src>... <dest>
COPY ["<src>",... "<dest>"]
COPY ./start.sh /start.sh
PS：与ADD的区别：COPY的只能是本地文件，其他用法一致
9、ENTRYPOINT
启动容器时执行的Shell命令，同CMD类似，只是由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序，例如：
ENTRYPOINT ["/bin/bash", "-C", "/start.sh"]
ENTRYPOINT /bin/bash -C '/start.sh'
PS：Dockerfile文件中也可以存在多个ENTRYPOINT指令，但仅有最后一个会生效。
10、VOLUME
指定容器挂载点到宿主机自动生成的目录或其他容器，例如：
VOLUME ["/var/lib/mysql"]
PS：一般不会在Dockerfile中用到，更常见的还是在docker run的时候指定-v数据卷。
11、USER
为RUN、CMD和ENTRYPOINT执行Shell命令指定运行用户，例如：
USER <user>[:<usergroup>]
USER <UID>[:<UID>]
USER edisonzhou
PS：如果设置了容器以daemon用户去运行，那么RUN, CMD 和 ENTRYPOINT 都会以这个用户去运行,
PS：使用这个命令一定要确认容器中拥有这个用户，并且拥有足够权限
12、WORKDIR
为RUN、CMD、ENTRYPOINT以及COPY和AND设置工作目录，例如：
WORKDIR /data
13、HEALTHCHECK
告诉Docker如何测试容器以检查它是否仍在工作，即健康检查，例如：
HEALTHCHECK --interval=5m --timeout=3s --retries=3 \
CMD curl -f http:/localhost/ || exit 1
选项的说明：
- –interval=DURATION (default: 30s)：每隔多长时间探测一次，默认30秒
- – timeout= DURATION (default: 30s)：服务响应超时时长，默认30秒
- –start-period= DURATION (default: 0s)：服务启动多久后开始探测，默认0秒
- –retries=N (default: 3)：认为检测失败几次为宕机，默认3次
返回值的说明：
- 0：容器成功是健康的，随时可以使用
- 1：不健康的容器无法正常工作
- 2：保留不使用此退出代码
14、ARG
在构建镜像时，指定一些参数，例如：
FROM centos:6
ARG user # ARG user=root
USER $user
这时，我们在docker build时可以带上自定义参数user了，如下所示：
docker build --build-arg user=edisonzhou Dockerfile .
三、综合Dockerfile案例
下面是一个Java Web应用的镜像Dockerfile，综合使用到了上述介绍中最常用的几个命令：
1、编写dockefile
FROM centos:7
MAINTANIER www.edisonchou.com
ADD jdk-8u45-linux-x64.tar.gz /usr/local
ENV JAVA_HOME /usr/local/jdk1.8.0_45
ADD apache-tomcat-8.0.46.tar.gz /usr/local
COPY server.xml /usr/local/apache-tomcat-8.0.46/conf
RUN rm -f /usr/local/*.tar.gz
WORKDIR /usr/local/apache-tomcat-8.0.46
EXPOSE 8080
ENTRYPOINT ["./bin/catalina.sh", "run"]
2、创建镜像：
docker build -t tomcat:v1 .
3、创建容器：
docker run -itd --name=tomcate -p 8080:8080 -v /app/webapps/:/usr/local/apache-tomcat-8.0.46/webapps/ tomcat:v1
Dockerfile完整demo：
# This dockerfile demo for project build to docker images
# VERSION 2
# Author: Shawn_xiao
# Command format: Instruction [arguments / command] …
# 2018/10/10- firstversion: xiao
# 2018/10/11- chanege the tomcat version
# 第一行必须指定基础容器，建议使用aipln类型的小容器
FROM tomcat:8
# 维护者信息(可选)
MAINTAINER xiaojianjun xiaojianjun@tansun.com.cn
# LABEL (可选) 标签信息(自定义信息,多标签放一行)
LABEL app.maintainer=xiaojianjun
LABEL app.version="1.0" app.host='bestxiao.cn' description="这个app产品构建"
# ENV (可选)环境变量(指定一个环境变量，会被后续 RUN 指令使用，并在容器运行时保持
ENV JAVA_HOME /opt/java_jdk/bin
ENV PG_VERSION 9.3.4
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
# USER (可选) 指定运行容器时的用户名或 UID，后续的 RUN 也会使用指定用户,前面的RUN 不受影响
# RUN groupadd -r postgres && useradd -r -g postgres postgres
USER postgres
# WORKDIT 后续的 RUN、CMD、ENTRYPOINT 指令配置容器内的工作目录
WORKDIR /path/to/workdir
# ADD/COPY 将外部文件copy到容器中。区别是ADD可以使用URL，还可以是tar
# COPY只能使用dockerfile所在目录
# ADD <src> <dest>
# COPY <src> <dest>
COPY target/tomcat-release.war /usr/local/tomcat/webapps/
# RUN 镜像的操作指令
# RUN <command> [“executable”, “param1”, “param2”]。
RUN echo “deb http://archive.ubuntu.com/ubuntu/ raring main universe” >> /etc/apt/sources.list
RUN apt-get update && apt-get install -y nginx
RUN mkdir /opt/deploy/
RUN echo “\ndaemon off;” >> /etc/nginx/nginx.conf
# EXPOSE 容器启动后需要暴露的端口
EXPOSE 22 80 8443 8080
# VOLUME 本地或其他容器挂载的挂载点，一般用来存放数据库和需要保持的数据等。
#VOLUME ["/data"]
VOLUME ["/data/postgres", "/other/path/"]
# ENTRYPOINT 容器启动后执行命令，不会被docker run提供的参数覆盖，只能有一个ENTRYPOINT,
# 多个ENTRYPOINT，以最后一个为准
#ENTRYPOINT [“executable”, “param1”, “param2”]
#ENTRYPOINT command param param2
ENTRYPOINT echo "helloDocker"
# 容器启动时执行指令,每个 Dockerfile 只能有一条 CMD 命令
#CMD [“executable”, “param1”, “param2”] 使用 exec 执行，推荐方式。
#CMD command param1 param2 在 /bin/sh 中执行，提供给需要交互的应用。
#CMD [“param1”, “param2”] 提供给 ENTRYPOINT 的默认参数。
CMD /usr/sbin/nginx
# ONBUILD 配置当所创建的镜像作为其他新创建镜像的基础镜像时，所执行的操作指令。例如，Dockerfile 使用如下的内容创建了镜像 image-A。-- 很少使用
# ONBUILD ADD . /app/src
# ONBUILD RUN /usr/local/bin/python-build –dir /app/src
转载至：https://www.cnblogs.com/edisonchou/p/dockerfile_inside_introduction.html
转载至：https://www.jianshu.com/p/a701de415be5
