10 DockerFile

1 介绍

Dockerfile是由一系列命令和参数构成的脚本

2 注意事项

Dockerfile中所用的文件要和Dockerfile文件在同一级父目录下(子目录中也可)

3 常用命令

命令	作用
FROM	定义基础镜像
MAINTAINER	镜像的创建者
ENV	设置环境变量
CMD	类似于 RUN 指令，用于运行程序
RUN	对镜像进行处理
ADD	将宿主机文件复制倒容器中,压缩文件会自动解压
COPY	将宿主机文件复制到容器中
WORKDIR	工作目录

4 详解

4.1 COPY

复制指令,从上下文目录中复制文件或者目录到容器里指定路径
  COPY jdk1.8.0_191.tar.gz /usr/local/gp6/java

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

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

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

        <源路径>
            源文件或者源目录,这里可以是通配符表达式,其通配符规则要满足 Go 的 filepath.Match 规则;例如：
                COPY hom* /mydir/
                COPY hom?.txt /mydir/

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

样例
    # 添加压缩包
    COPY jdk1.8.0_191.tar.gz /usr/local/gp6/java

4.2 ADD

ADD 指令和 COPY 的使用格式一致(同样需求下,推荐使用 COPY)

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

样例
    # 添加压缩包
    ADD jdk1.8.0_191.tar.gz /usr/local/gp6/java

4.3 CMD

类似于 RUN 指令,用于运行程序,二者运行的时间点不同
    CMD 在docker run 时运行;
    RUN 是在 docker build;

作用
    为启动的容器指定要运行的程序,程序运行结束,容器结束;CMD 指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖;

注意
    Dockerfile 中如果存在多个 CMD 指令,仅最后一个生效;

格式
    CMD <shell 命令> 
    CMD ["<可执行文件或命令>","<param1>","<param2>",...] 
    CMD ["<param1>","<param2>",...]  # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数

推荐使用第二种格式,执行过程比较明确;第一种格式实际上在运行的过程中也会自动转换成第二种格式运行,并且默认可执行文件是 sh;

样例
    [root@localhost gp6]# docker build -t test-cmd .
    Sending build context to Docker daemon   2.56kB
    Step 1/3 : FROM centos:7
     ---> 5e35e350aded
    Step 2/3 : MAINTAINER "GP6"
     ---> Running in 7520e3e19089
    Removing intermediate container 7520e3e19089
     ---> 4ef65ed7526b
    Step 3/3 : CMD ["/bin/echo", "this is a CMD test"]
     ---> Running in 5e44bbe2c83d
    Removing intermediate container 5e44bbe2c83d
     ---> efff18a16e96
    Successfully built efff18a16e96
    Successfully tagged test-cmd:latest

    [root@localhost gp6]# docker run test-cmd
    this is a CMD test

4.4 ENTRYPOINT

类似于 CMD 指令,不会被 docker run 的命令行参数指定的指令所覆盖,这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序;

如果运行 docker run 时使用 --entrypoint 选项,此选项的参数可当作要运行的程序覆盖 ENTRYPOINT 指令指定的程序

优点
    在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数;

注意
    Dockerfile 中存在多个 ENTRYPOINT 指令,仅最后一个生效;

格式
    ENTRYPOINT ["<executeable>","<param1>","<param2>",...]
    可以搭配 CMD 命令使用
        一般是变参才会使用 CMD ,这里的 CMD 等于是在给 ENTRYPOINT 传参;

    示例：
        假设已通过 Dockerfile 构建了 nginx:test 镜像：
            FROM nginx
            ENTRYPOINT ["nginx", "-c"] # 定参
            CMD ["/etc/nginx/nginx.conf"] # 变参 

不传参运行
    $ docker run nginx:test
    容器内会默认运行以下命令,启动主进程;
        nginx -c /etc/nginx/nginx.conf

传参运行
    $ docker run  nginx:test -c /etc/nginx/new.conf
    容器内会默认运行以下命令,启动主进程(/etc/nginx/new.conf:假设容器内已有此文件)
        nginx -c /etc/nginx/new.conf

4.5 ENV

设置环境变量，定义了环境变量，那么在后续的指令中，就可以使用这个环境变量。

格式：
    ENV <key> <value>
    ENV <key1>=<value1> <key2>=<value2>...

设置JAVA变量    
    # 设置环境变量
    ENV JAVA_HOME /usr/local/gp6/java/jdk1.8.0_191
    ENV JRE_HOME $JAVA_HOME/jre
    ENV PATH $JAVA_HOME/bin:$PATH