Dockerfile是一堆指令,每一条指令构建一层,因此每一条指令的内容就是描述该层应当如何构建,在docker build的时候,按照该指令进行操作,最终生成我们期望的镜像文件
Dockerfile常用指令
先上一张通俗易懂的全景图
1.FROM 指令
FROM指令是指定基础镜像,必须为第一个命令
格式:
FROM <image>
FROM <image>:<tag>
示例:
FROM:nginx:latest
温馨提示:tag是可选的,如果不使用tag时,默认会使用latest版本的基础镜像
2.MAINTAINER指令
MAINTAINER指令:镜像维护者的信息
格式:
MAINTAINER <name>
示例:
MAINTAINER Maple <XXXXX@qq.com>
3.COPY/ADD指令
ADD指令:将本地文件添加到容器中,tar类型文件会自动解压(网络压缩资源不会被解压),可以访问网络资源,类似wget
格式:
ADD <src>... <dest>
示例:
#添加所有以"map"开头的文件
ADD map* /mydir/
#添加test目录到`WORKDIR`/relativeDIR/
ADD test relativeDir/
COPY指令:类似于ADD指令,但是不会自动解压文件,也不能访问网络资源
4.WORKDIR指令
WORKDIR指令:工作目录
格式:
WORKDIR /path/to/workdir
示例:
WORKDIR /a #工作目录为/a
WORKDIR b #这时工作目录为/a/b
温馨提示:通过WORKDIR设置工作目录后,Dockerfile中基后的命令RUN、CMD、ENTRYPOINT、ADD、COPY等命令都会在该目录下执行。在使用docker run运行容器时,可以通过-w参数覆盖构建时所设置的工作目录
5.RUN指令
RUN指令:构建镜像过程中运行的Shell命令
格式:
RUN <COMMAND>
示例:
RUN yum install nginx #构建镜像时,运行RUN命令先安装nginx
温馨提示:RUN指令创建的中间镜像会被缓存,并会在下次构建中使用。如果不想使用这些缓存镜像,可以在构建时指定--no-cache参数,如:docker build --no-cache
6.CMD指令
CMD指令:构建容器后调用,也就是在容器启动时才进行调用
格式:
CMD ["executable","param1","param2"] #执行可执行文件,优先
CMD ["param1","param2"] #设置了ENTRYPOINT,则直接调用ENTERPOINT添加参数
CMD command param1 param2 #执行shell内部命令
示例:
CMD ["/usr/bin/wc","--help"]
CMD ping www.qq.com
温馨提示:CMD不同于RUN,CMD用于指定在容器启动后所要执行的命令,而RUN用于指定镜像构建时所要执行的命令
7.ENTRYPOINT指令
ENTRYPOINT指令:设置容器初始化命令,使其可执行化
格式:
ENTRYPOINT ["executable","param1","param2"] #可执行文件优先
ENTRYPOINT command param1 param2 #shell内部命令
示例:
ENTRYPOINT ["/usr/bin/wc","--help"]
温馨提示:ENTRYPOINT与CMD非常类似,不同的是通过docker run执行命令不会覆盖ENTRYPOINT,而docker run命令中指定的任何参数,都会被当做参数再次传递给ENTRYPOINT。Dockerfile中只允许有一个ENTRYPOINT命令,多指定时会覆盖前面的设置,而只执行最后的ENTRYPOINT指令
8.ENV指令
ENV指令:设置环境变量
格式:
ENV <key> <value> #<key>之后的所有内容均会被视为其<value>的组成部分,因此,一次只能设置一个变量
ENV <key>=<value> ... #可以设置多个变量,每个变量为一个"<key>=<value>"的键值对,如果<key>中包含空格,可以使用来进行转义,也可以通过""来进行标示,另外,反斜线也可以用于续行
示例:
ENV myName Heroge
ENV myCat=fluffy
9.EXPOSE指令
EXPOSE指令:指定与外界交互的端口
格式:
EXPOSE <port> [<port>...]
示例:
EXPOSE 80 443
EXPOSE 8080
EXPOSE 11222/tcp 11211/udp
温馨提示:EXPOSE并不会让容器的端口访问到主机,要使其可访问,需要在docker run运行容器时通过-p来发布这些端口,或通过-P参数来发布EXPOSE导出的所有端口
10.VOLUME指令
VOLUME指令:用于指定持久化目录
格式:
VOLUME ["/path/to/dir"]
示例:
VOLUME ["/data"]
VOLUME ["/var/www","/var/log/apache2","/etc/apache2"]
温馨提示:一个卷可以存在于一个或多个容器的指定目录,该目录可以绕过联合文件系统,并具有以下功能:
1.卷可以容器间共享和重用
2.容器并不一定要和其它容器共享卷
3.修改卷后会立即生效
4.对卷的修改不会对镜像产生影响
5.卷会一直存在,直到没有任何容器在使用它
11.USER指令
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参数来覆盖所指定的用户
12.ARG指令
ARG指令:用于指定传递给构建运行时的变量
格式:
ARG <name> [-<default value>]
示例:
ARG site
ARG build_user=www
13.ONBUILD指令
ONBUILD指令:用于设置镜像触发器
格式:
ONBUILD [INSTRUCTION]
示例:
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
温馨提示:当所构建的镜像被用做其它镜像的基础镜像,该镜像中的触发器将会被触发
14.LABEL指令
LABEL指令:用于镜像添加元数据
格式:
LABEL <key>=<value> <key>=<value> <key>=<value> ...
示例:
LABEL version="1.0" description="这是一个Web服务器" by="IT记录"
温馨提示:使用LABEL指定元数据时,一条LABEL指令可以指定一条或多条元数据,指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定,以免生成过多的中间镜像
小实例
# This my first nginx Dockerfile
# Version 1.0
# Base images 基础镜像
FROM centos:centos7.5.1804
#MAINTAINER 维护者信息
LABEL maintainer="inspur_lyx@hotmail.com"
#ENV 设置环境变量
ENV PATH /usr/local/nginx/sbin:$PATH
#ADD 文件放在当前目录下,拷过去会自动解压
#ADD nginx-1.8.1.tar.gz /usr/local
#ADD epel-release-latest-7.noarch.rpm /usr/local/
#RUN 执行以下命令
RUN yum -y install epel-release
RUN yum install -y wget lftp gcc gcc-c++ make openssl-devel pcre-devel pcre && yum clean all
RUN useradd -s /sbin/nologin -M www
RUN wget -O nginx-1.8.1.tar.gz "http://nginx.org/download/nginx-1.8.1.tar.gz"
RUN tar xf nginx-1.8.1.tar.gz -C /usr/local/
#WORKDIR 相当于cd
WORKDIR /usr/local/nginx-1.8.1
RUN ./configure --prefix=/usr/local/nginx --user=www --group=www --with-http_ssl_module --with-pcre && make && make install
RUN echo "daemon off;" >> /etc/nginx.conf
#EXPOSE 映射端口
EXPOSE 80
#容器启动时执行命令
CMD ["nginx","-g","daemon off;"]
另一小实例
# This my first django Dockerfile
# Version 1.0
# Base images 基础镜像
FROM centos:centos7.5.1804
#MAINTAINER 维护者信息
LABEL maintainer="inspur_lyx@hotmail.com"
#ENV 设置环境变量
ENV LANG en_US.UTF-8
ENV LC_ALL en_US.UTF-8
#RUN 执行以下命令
RUN curl -so /etc/yum.repos.d/Centos-7.repo http://mirrors.aliyun.com/repo/Centos-7.repo
RUN yum install -y python36 python3-devel gcc pcre-devel zlib-devel make net-tools
#工作目录
WORKDIR /opt/myblog
#拷贝文件至工作目录
COPY . .
#安装nginx
RUN tar -zxf nginx-1.13.7.tar.gz -C /opt && cd /opt/nginx-1.13.7 && ./configure --prefix=/usr/local/nginx
&& make && make install && ln -s /usr/local/nginx/sbin/nginx /usr/bin/nginx
RUN cp myblog.conf /usr/local/nginx/conf/myblog.conf
#安装依赖的插件
RUN pip3 install -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com -r requirements.txt
RUN chmod +x run.sh && rm -rf ~/.cache/pip
#EXPOSE 映射端口
EXPOSE 8002
#容器启动时执行命令
CMD ["./run.sh"]
执行构建:
docker build . -t myblog:v1 -f Dockerfile