一、什么是Dockerfile
Dockerfile就是名为Dockerfile的文件(注意没有后缀名),文件中包含一些Linux命令,Docker通过读取文件中的命令来组件镜像
二、Dockerfile文件内容结构
Dockerfile一般分为四部分:基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令,“#”为dockerfile中的注释
三、运行Dockerfile
当前目录下 docker build -t image_name:tag_name .
也可以通过-f参数来指定Dockerfile文件位置 docker build -f /path/Dockerfile .
说明:
-t:tag,指定镜像名字和标签
-f:指定文件路径
四、命令详解
1、FORM:指定基础镜像,必须为第一个命令
格式: FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>
示例: FROM centos:7.0
2、MAINTAINER:维护者信息
格式: MAINTAINER <name>
示例:
MAINTAINER zhangsan
3、RUN:构建镜像时执行的命令
格式: RUN <commond>
RUN ["executable", "param1", "param2"]
示例: RUN yum install nginx
RUN ["/bin/executable", "param1", "param2"]
4、ADD:将本地文件添加到容器中,tar类型文件会自动解压(网络压缩资源不会被解压),可以访问网络资源,类似wget
格式: ADD <src>… <dest>
ADD ["<src>",… "<dest>"] #用于支持包含空格的路径
示例: ADD tes* /mydir/ #添加所有以“tes”开头的文件
ADD tes?.txt /mydir/ # ?替代一个单字符,例如“test.txt”
ADD test relativeDir/ #添加“test”到WORKDIR/relativeDir/
ADD test /absoluteDir/ #添加“test”到/absoluteDir/
注:
第一个参数指宿主机文件路径,第二个参数指容器路径
5、COPY:功能类似ADD,但是不会自动解压文件,也不能访问网络资源
6、CMD:构建容器后调用,也就是在容器启动时才进行调用
格式: CMD ["executable", "param1", "param2"] #执行可执行文件,优先
CMD {"param1", "param2"} #设置了ENTERPOINT,则直接调用ENTERPOINT添加参数
示例: CMD echo "This is a test." | wc -
CMD ["/usr/bin/wc", "--help"]
注:
CMD不同于RUN,CMD用于指定在容器启动时所要执行的命令,而RUN用于指定镜像构建时所要执行的命令
7、ENTRYPOINT:配置容器,使其可执行化。配合CMD可省去“application”只使用参数
格式: ENTRYPOINT ["executable", "param1", "param2"] #可执行文件,优先
ENTRYPOINT command param1 param2 #shell内部命令
示例: FROM ubuntu
ENTRYPOINT ["top", "-b"]
CMD ["-c"]
注:
ENTRYPOINT与CMD非常类似,不同的是通过docker run执行的命令不会覆盖ENTRYPOINT,但是会覆盖CMD。而docker run命令中指定的任何参数,都会被当做参数再次传递给ENTRYPOINT。Dockerfile中只允许有一个ENTRYPOINT命令,多指定是会覆盖前面的设置,而只执行最后面的ENTRYPOINT指令
示例: docker run -itd --name=nginx nginx echo "hello world"
也就是说echo “hello world”命令会覆盖镜像中CMD指定的命令,但不会覆盖ENTRYPOINT指定的命令
8、LABEL:用于为镜像添加元素
格式: LABEL <key1>=<value1> <key2>=<value2> <key3>=<value3> …
示例: LABEL version="1.0" description="这是一个nginx镜像"
注:
使用LABEL指定元素时,一条LABEL可以指定一个或多个元数据,通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定,以免生成过多的中间镜像
9、ENV:设置环境变量
格式: ENV <key> <value> #之后的所有内容均会被视为其的组成部分,因此,一次只能设置一个变量
ENV <key>=<value> … #可以设置多个变量,每个变量为一个"<key>=<value>"的键值对,如果<key>中包含空格,可以使用\来进行转义,也可以通过""来进行标示;另外,反斜线也可以用于续行
示例: ENV myName John Doe
ENV myCat=fluffy myDog=Rex The Dog
10、EXPOSE:指定与外界交互的端口号(容器对外暴露的端口号)
格式: EXPOSE <port> [<port>…]
示例: EXPOSE 80 443
EXPOSE 8080
注:
EXPOSE并不会让容器的端口访问到主机。要使其可访问,需要在docker run运行容器时通过-p来发布这些端口,或通过-P参数来发布EXPOSE导出的所有端口
10、VOLUME:用于持久化目录
格式: VOLUME ["/path/to/dir"]
示例: VOLUME ["/data"]
VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
注:
一个卷可以存在于一个或多个容器的指定目录,该目录可以绕过联合文件系统,并具有以下功能:
1)卷可以容器间共享和重用
2)容器并不一定要和其它容器共享卷
3)修改卷后会立即生效
4)对卷的修改不会对镜像产生影响
5)卷会一直存在,直到没有任何容器在使用它
6)有没有想起来文件挂载的-v,就是VOLUME,每指定一个目录就是一个卷
11、WORKDIR:工作目录,类似于cd命令,目录不存在会自动创建
格式: WORKDIR /path/to/workdir
示例: WORKDIR /usr/local/ #这时工作目录为/usr/local/
WORKDIR nginx #这时工作目录为/usr/local/nginx
WORKDIR sbin #这时工作目录为/usr/local/nginx/sbin
注:
通过WORKDIR设置工作目录后,Dockerfile中其后的命令RUN、CMD、ENTRYPOINT、ADD、COPY等命令都会在该目录下执行。在使用docker run运行容器时,可以通过-w参数覆盖构建时所设置的工作目录
WORKDIR /usr/local/
等价于 RUN cd /usr/local/
12、USER:指定运行容器时的用户名或UID,后续的RUN也会使用指定用户。使用USER指定用户时,可以使用用户名、UID或GID,或是两者的组合。当服务不需要管理员权限时,可以通过该命令指定运行用户。并且需要在之前创建所需要的用户
格式: USER user
USER user:group
USER uid
USER uid:gid
USER user:gid
USER uid:group
示例: USER www
注:
使用USER指定用户后,Dockerfile中其后的命令RUN、CMD、ENTRYPOINT都将使用该用户。镜像构建完成后,通过docker run运行容器时,可以通过-u参数来覆盖所指定的用户
13、ARG:用于指定传递给构建运行时的变量(变量定义)
格式: ARG [<name>=<default value>]
示例: ARG site
ARG build_user=www
14、ONBUILD:用于设置镜像触发器(一般用不上)
格式: ONBUILD [INSTRUCTION]
示例: ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
注:
当所构建的镜像被用做其它镜像的基础镜像,该镜像中的触发器将会被钥触发
15、常用的命令 FORM
MAINTAINER
RUN
ADD
COPY
CMD
ENTRYPOINT
EXPOSE
VOLUME
WORKDIR
五、一个Dockerfile的例子
1、Dockerfile文件
注意每一条指令是一个层,要控制层的数量
# nginx Dockerfile
#基础镜像
FROM centos:centos7
MAINTAINER zhangsan
# Yum
RUN yum -y update &&\
yum install -y wget gcc gcc-c++ make pcre pcre-devel zlib openssl openssl-devel &&\
yum clean all
ARG NGINX_VERSION=1.16.1
# 建立用户
RUN useradd -s /sbin/nologin -M nginx
# Nginx
WORKDIR /tmp
RUN wget http://nginx.org/download/nginx-${NGINX_VERSION}.tar.gz &&\
tar xzf nginx-${NGINX_VERSION}.tar.gz &&\
cd /tmp/nginx-${NGINX_VERSION} &&\
./configure \
--prefix=/usr/local/nginx \
--user=nginx \
--group=nginx \
--with-pcre \
--with-http_ssl_module \
--with-http_sub_module \
--with-http_dav_module \
--with-http_flv_module \
--with-http_gzip_static_module \
--with-http_stub_status_module \
--with-debug &&\
make &&\
make install
# 设置环境变量
ENV PATH /usr/local/nginx/sbin:$PATH
# 开放端口
EXPOSE 80 443
# 执行命令
ENTRYPOINT ["nginx", "-g", "daemon off;"]
2、执行构建镜像 docker build -t zs-nginx:1.16.1 .
3、运行镜像 docker run -itd --name=zs-nginx -p 8888:80 zs-nginx:1.16.1
浏览器访问:
http://IP:8888