Dockerfile文件

Dockerfile文件

Dockerfile是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明。

FROM：定制的镜像都是基于FROM的镜像，从哪开始，从一个系统开始

FROM scratch		# 最小系统
FROM centos
FROM ubuntu:14.04

RUN：用于执行后面跟着的命令行命令，每RUN一次，会多出一个系统分层，尽量少一些层，有两种格式

• shell格式

  RUN <命令行命令>
  # <命令行命令>等同于在终端操作的shell命令
  

• exec格式

  RUN ["可执行文件", "参数1", "参数2"]
  # 比如：RUN ["yum", "-y", "install", "lrzsz"]  等价于 RUN yum -y install lrzsz
  

注意：Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大。以 && 符号连接命令，这样执行后，只会创建 1 层镜像。例如：

FROM centos
RUN yum install wget
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
RUN tar -xvf redis.tar.gz
以上执行会创建 3 层镜像。可简化为以下格式：
FROM centos
RUN yum install wget 
    && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" 
    && tar -xvf redis.tar.gz

WORKDIR：进入或创建目录，尽量不要用相对路径。用WORKDIR指定的工作目录，会在构建镜像的每一层中都存在

WORKDIR <工作目录路径>

比如：
	WORKDIR /root     # 进入 /root 目录
  WORKDIR /test     # 会在根下，创建 /test 并进入
  WORKDIR demo    # 创建demo，进入
  RUN pwd          # /test/demo

COPY：复制指令，从上下文目录中复制文件或者目录到容器里指定路径

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

[--chown=<user>:<group>]：可选参数，用户改变复制到容器内文件的拥有者和属组
<源路径>：源文件或源目录，这里可以是通配符表达式，其通配符规则要满足Go的filepath.Match规则
<目标路径>：容器内的指定路径，该路径不用事先建好，路径不存在的话，自动创建

比如：
	COPY hom* /mydir/
	COPY hom?.txt /mydir/

ADD：ADD指令和COPY的使用格式一致(同样需求下，官方推荐使用COPY)。功能也类似，不同之处在于：

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

LABEL：注释

比如：
	LABEL version="1.0"
	LABEL auther="sjc"

CMD 和 ENTRYPOINT：执行命令或运行某个脚本

• Shell格式

  FROM centos
  # CMD
  CMD echo "hello docker"
  # ENTRYPOINT
  ENTRYPOINT echo "hello docker"
  

• Exec格式

  FROM centos
  # CMD
  CMD ["bin/echo", "hello docker"]
  # ENTRYPOINT
  ENTRYPOINT ["bin/echo", "hello docker"]
  

CMD

CMD类似于RUN指令，用于运行程序，但二者运作的时间点不同：

• CMD在docker run 时运行
• RUN是在docker build时运行

作用：为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。CMD指令指定的程序可被docker run命令行参数中指定要运行的程序所覆盖。

注意：如果Dockerfile中如果存在多个CMD指令，仅最后一个生效。

格式：

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

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

ENTRYPOINT

ENTRYPOINT类似于CMD指令，但其不会被docker run命令行参数指定的指令所覆盖，而且这些命令行参数被当作参数送给ENTRYPOINT指令指定的程序。但是，如果运行docker run时使用了 --entrypoint选项，此选项的参数可当作要运行的程序覆盖ENTRYPOINT指令指定的程序。

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

注意：如果Dockerfile中存在多个ENTRYPOINT指令，仅最后一个生效。

格式：

ENTRYPOINT ["<executeable>","<param1>","<param2>",...]

可以搭配CMD命令使用，一般是变参才会使用CMD，实例：

假设已通过Dockerfile构建了nginx:test镜像，这里的CMD等于是给ENTRYPOINT传参
1、Dockerfile文件编写一下内容
FROM nginx
ENTRYPOINT ["nginx", "-c"]  # 定参
CMD ["/etc/nginx/nginx.conf"]		# 变参

2、不传参运行
[root@node01 ~]# docker run nginx:test
容器内会默认运行一下命令，启动主进程
nginx -c /etc/nginx/nginx.conf

3、传参运行
[root@node01 ~]# docker run nginx:test -c /etc/nginx/new.conf
容器内会默认运行一下命令，启动主进程(/etc/nginx/new.conf:假设容器内已有此文件)
nginx -c /etc/nginx/new.conf

EVN设置环境变量

格式：

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