DockerFile语法【h】
DockerFile在我理解就是可以将所需要构建镜像的功能、组件都天前配置好,然后直接生成一个Image,而不是先生成镜像,再通过修改容器的方法来生成最终需要的镜像。
镜像的定值实际上就是定值每一层所需要添加的配置、文件,将每一层修改、安装、构建、操作的命令都写入一个脚本,最后使用脚本来构建镜像。Dockerfile的每一条指令(instruction)构建一层,描述了该层该如何构建。
Dockerfile的构建
docker build [选项] <上下文路径/URL/->
Dockerfile上下文(context)
一般情况下构建镜像docker build 最后都会有一个.,表示当前目录,有些人会认为这是指定Dockerfile的所在路径,但是其实是在指定上下文路径。在构建镜像的时候,docker build得知上下文路径后,会将该路径下所有东西打包,然后上传给Docker 引擎,Docker引擎就回获得构建镜像所需要的一切文件。
需要访问打包的文件,必须以./开头,并不是指当前路径,而是上下文环境。应该讲Dockerfile置于一个空目录下,或者项目根目录下,如果该上下文环境有不希望传给Docker引擎的,可以使用.gitignore一样的语法写一个.dockerignore来剔除不需要的环境。
其他Docker builc的用法
直接使用Git repo构建
docker build https://github.com/twang2218/gitlab-ce-zh.git#:8.14
用给定的tar包构建
docker build build.tar.gz
DockerFile指定
FROM 指定基础镜像
必选,而且是第一条指令,在制定基础镜像。
FROM nginx
有一个特殊的镜像名为scratch,是虚拟的概念,表示一个空白的镜像,意味着不以任何镜像为基础,接下来所写的指令将作为镜像第一层开始存在,使用Go预研开发的应用很多会使用这种方式来制作镜像。
FROM scratch
RUN 执行命令
用于执行命令,相当于命令行,格式有两种:
shell格式:RUN <命令>,相当于在命令行中写命令。
exec格式:RUN["可执行文件","参数1", "参数2"],相当于函数调用中的格式。
RUN echo 'hello world' > /usr/share/nginx/html/index.html
Dockerfile会将每一个命令视为一层,所以一般使用RUN都是结合&&来将多个RUN视为一层,避免产生臃肿、多层的镜像,增加构建时间而且容易出错。
FROM debian:jessie
RUN buildDeps='gcc libc6-dev make' \
&& apt-get update \
&& apt-get install -y $buildDeps \
&& mkdir -p /usr/src/redis \
&& tar -xzf redis.tar.gz -C /usr/src/redis --strip-components=1 \
&& make -C /usr/src/redis \
&& make -C /usr/src/redis install \
&& rm -rf /var/lib/apt/lists/* \
&& rm redis.tar.gz \
&& rm -r /usr/src/redis \
&& apt-get purge -y --auto-remove $buildDeps
末尾使用了\的方式,以及行首#进行注释的格式,可以让维护、更为容易。另外,可以在这一组命令最后添加清理工作的命令,删除为了编译固件所需要的软件,并且还清理了qpt缓存文件,可以有效避免镜像臃肿
COPY 复制文件
格式:
COPY <源路径>... <目标路径>
COPY ["<源路径1>",... "<目标路径>"]
与RUN命令类似,有shell以及函数式调用,将从上下文目录中的源路径复制到一个新的镜像内的目标路径。源路径可以是多个,可以使用通配符,需要满足Go语言的filepath Match规则。
目标路径可以使容器内的绝对路径,也可以是相对路径,目标路径不需要手动创建,Docker会自动创建确实的目录。
需要注意的是拷贝过去的文件会保留源文件的特性,比如读写权限、文件变更时间等。
ADD 高级的复制文件
ADD可以理解为一个升级版本的COPY,源路径可以是一个URL(下载之后的文件权限为600);如果源路径是一个tar压缩文件、格式为gzip、bzip2以及xz的情况下,ADD指令可以自动解压该文件到目标路径中。所以这个命令一般用于解压文件更多。
Docker官方建议尽可能使用COPY,因为ADD语音不明确,并且ADD会另镜像构建缓存失效,从而可能另镜像构建的比较缓慢。因此仅在需要自动解压的情况下使用ADD。
CMD 容器启动命令
和RUN相似,但是CMD、ENTERPOINT、HEALTHCHECK只能出现一次,写了多个只会使用最后一个。两种格式:
shell 格式: CMD <命令>
exec 格式: CMD ["可执行文件", "参数1", "参数2"...]
参数列表格式: CMD ["参数1", "参数2"...] 。在指定了 ENTRYPOINT 指令后,用 CMD 指定具体的参数。
我们知道Docker不是虚拟机,而容器就是一个进程而已,那么在启动容器的时候就需要指定容器运行的程序以及参数,CMD指令就是用于指定默认的容器主进程的启动命令的。
在ubuntu默认CDM是/bin/bash,直接docker run -it会直接进入bash,也可以通过手动docker run -it imageid cat /etc/os-release的方式替换默认CMD,打印系统版本信息。
一般推荐exec的指令格式,会被解析为JSON数组,一定使用双引号而不是单引号。如果直接使用shell格式的话会被包装为sh -c的参数形式执行
CMD echo $HOME
CMD ["sh","-c","echo $HOME"]
这也就是我们为什么可以使用环境变量的原因,因为这些环境变量会被shell进行解析处理。
另外Docker不是虚拟机,容器中没有后台执行服务的概念,不能使用upstart/systemd去执行后台服务。比如nginx服务
CMD service nginx start
其实会启动之后就立刻推出,甚至systemctl命令根本无法执行。容器中启动进程就是容器应用进程,容器就是为了主进程而存在的,主进程退出容器也就失去了意义。nginx启动应该为:
CMD ["nginx","-g","daemon off;"]
因为service nginx start会被理解为CMD["sh","-c""service nginxstart"],因此主进程是sh,当service nginx start执行完,sh也就结束了,sh作为主进程推出就会导致容器推出。
ENTERPOINT 入口点
作用和CMD类似,都是在容器启动程序及参数,ENTERPOINT在运行时候也可以替代,但是比CMD要繁琐,需要通过docker run的参数 -entrypoint来指定。当指定了ENTERPOINT之后,CMD就不再是直接的运行命令,而是将CMD的内容作为参数传递给ENTERPOINT指令,相当于:
<ENTERPOINT> "<CMD>"
那么有什么用呢?
让镜像变成命令一样使用
有些情况下构建的镜像我们可以当做一个应用直接使用命令行调用,但是使用CMD的构建是写死的。比如获取公网IP:
FROM ubuntu:16:04
RUN apt-get update \
&& apt-get install -y curl \
&& rm -rf /var/lib/apt/lists/*
CMD ["curl","-s","http://ip.cn"]
docker build -t myip .构建镜像之后,只需要执行docker run myip就可以查看当前的公网ip。但是如果我们现在想修改一下使用别的参数,比如希望显示http头信息,需要加上-i参数,那么使用docker run myip -i是一定不可行的。因为跟在镜像名后边的command运行时候会替换CMD默认值,相当于直接执行-i,所以绝对不会成功,这个时候就可以使用ENTERPOINT。
FROM ubuntu:16:04
RUN apt-get update \
&& apt-get install -y curl \
&& rm -rf /var/lib/apt/lists/*
ENTRYPOINT [ "curl", "-s", "http://ip.cn" ]
&& apt-get install -y curl \
&& rm -rf /var/lib/apt/lists/*
然后直接调用docker run myip -i就可以正常执行,相当于curl -s http://ip.cn -i,CMD的内容会作为参数传递给ENTERPOINT,而这里个-i就是新的CMD,和ENTERPOINT组合成新的CMD。
ENV 环境变量
只是设置环境变量,无论是后边其他的任何命令RUN等都可以直接使用这里的环境变量,使用{ENV_NAME}来引用,格式:
ENV <key> <value>
ENV <key1>=<value1> <key2>=<value2>
比如:
ENV NODE_VERSION =7.2.0 DEBUG=on \
NAME="lzy"
RUN curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.xz"
以下的指令支持环境变啦ing的展开:
ADD 、 COPY 、 ENV 、 EXPOSE 、 LABEL 、 USER 、 WORKDIR 、 VOLUME 、 STOPSIGNAL 、 ONBUILD
通过环境变量,我们可以让一份Dockerfile制作更多的镜像,只需要使用不同的环境变量即可。
ARG 构建参数
与ENV想类似,设置环境变量,但是ARG的环境变量在最终声称的容器中不会存在,但是不存在不意味着可以保存密码之类的东西,因为在docker history中也会看到。该值所设置的环境变量可以在docker build时候shiyong --build-arg <参数名>=<值>来覆盖。格式:
ARG <参数名>[=<参数值>]
VOLUME定义匿名卷
如果在容器中进行数据输出,那么最终数据不会被保存,对于需要动态保存数据的应用,应该保存与卷volume中,为了避免用户忘记动态文件所保存目录挂载为卷,可以实现指定默写目录挂载为匿名卷,如果用户不指定挂载,应用也可以正常运行,不会向容器存储层写入大量数据。格式为:
VOLUME ["<路径1>", "<路径2>"...]
VOLUME <路径>
#比如
COLUME /data
上述的/data就会在运行时候自动挂载为匿名卷,运行时也可以覆盖这个挂载设置
docker run -d -v mydata:/data xxxx
上述就是使用了mydata目录来挂载到了/data位置,替代了Dockerfile中匿名卷的挂载配置。
EXPOSE 声明端口
生命运行时候容器提供服务端口,只是一个生命,在运行时候不会因为这个生命就会开启这个端口。主要作用是帮助镜像使用者理解这个镜像服务的守护端口,方便配置映射。另外就是使用随机端口映射时候docker run -P可以自动随机映射expose的端口。格式为:
EXPOSE <端口1> [<端口2>...]
expose和运行时候指定-p 宿主端口:容器端口不同,-p用户映射宿主端口和容器端口,将容器对应端口公开给外界访问。expose仅仅是生命容器打算使用什么端口而已,并不会自动在宿主机进行端口映射。
WORKDIR 指定工作目录
首先,Dockerfile中不同于执行shell命令,每一层都是不同的运行环境如下的命令一定会报/app/world.txt不存在的错误。
RUN cd /app
RUN echo "hello" > world.txt
第一层的cd /app仅仅是当前进程的工作目录变更,一个内存上的变化而已,结果不会造成任何文件变更。第二层时候是一个全新的容器,自然不可能集成前一层的内存变化,所以如果想是想cd /app的效果,必须使用WORKDIR指令来更改工作空间,并且如果目录不存在,WORKDIR会帮我们建立目录。
USER 指定当前用户
USER <用户名>
USER和WORKDIR类似,都会改变环境状态并影响到以后的层。WORKDIR是改变工作目录,USER是改变之后层的执行RUN、CMD、ENTERPONIT等命令的身份,用户必须提前建立好,否则无法切换
RUN groupadd -r redis && useradd -r -g redis redis
USER redis
RUN ["redis-server"]
HEALTHCHECK 健康检查
HEALTHCHECK [选项] CMD <命令> :设置检查容器健康状况的命令
HEALTHCHECK NONE :如果基础镜像有健康检查指令,使用这行可以屏蔽掉其健康检查指令
告知Docker如何判断容器的状态是否正常,于1.12版本引入。当镜像制定了healthcheck指令,指定一行命令之后,勇气启动容器,初始状态为starting,在HEALTHCHECK指令检查陈宫之后变为healthy,如果连续一定次数失败,则会变成unhealthy。HEALTHCHECK支持的选项有:
interval=<间隔> :两次健康检查的间隔,默认为 30 秒;
timeout=<时长> :健康检查命令运行超时时间,如果超过这个时间,本次健康检查就被视为失败,默认 30 秒;
retries=<次数> :当连续失败指定次数后,则将容器状态视为 unhealthy ,默认 3 次。
ARG
语法:
ARG <name>[=<default value>]
设置变量命令,ARG命令定义了一个变量,在docker build创建镜像的时候,使用 --build-arg <varname>=<value>来指定参数
如果用户在build镜像时指定了一个参数没有定义在Dockerfile种,那么将有一个Warning
提示如下:
[Warning] One or more build-args [foo] were not consumed.
我们可以定义一个或多个参数,如下:
FROM busybox
ARG user1
ARG buildno
...
也可以给参数一个默认值:
FROM busybox
ARG user1=someuser
ARG buildno=1
...
如果我们给了ARG定义的参数默认值,那么当build镜像时没有指定参数值,将会使用这个默认值
ONBUILD
语法:
ONBUILD [INSTRUCTION]
这个命令只对当前镜像的子镜像生效。
比如当前镜像为A,在Dockerfile种添加:
ONBUILD RUN ls -al
这个 ls -al 命令不会在A镜像构建或启动的时候执行
此时有一个镜像B是基于A镜像构建的,那么这个ls -al 命令会在B镜像构建的时候被执行。
STOPSIGNAL
语法:
STOPSIGNAL signal
STOPSIGNAL命令是的作用是当容器推出时给系统发送什么样的指令
HEALTHCHECK
容器健康状况检查命令
语法有两种:
1. HEALTHCHECK [OPTIONS] CMD command
2. HEALTHCHECK NONE
第一个的功能是在容器内部运行一个命令来检查容器的健康状况
第二个的功能是在基础镜像中取消健康检查命令
[OPTIONS]的选项支持以下三中选项:
--interval=DURATION 两次检查默认的时间间隔为30秒
--timeout=DURATION 健康检查命令运行超时时长,默认30秒
--retries=N 当连续失败指定次数后,则容器被认为是不健康的,状态为unhealthy,默认次数是3
注意:
HEALTHCHECK命令只能出现一次,如果出现了多次,只有最后一个生效。
CMD后边的命令的返回值决定了本次健康检查是否成功,具体的返回值如下:
0: success - 表示容器是健康的
1: unhealthy - 表示容器已经不能工作了
2: reserved - 保留值
例子:
HEALTHCHECK --interval=5m --timeout=3s \
CMD curl -f http://localhost/ || exit 1
健康检查命令是:curl -f http://localhost/ || exit 1
两次检查的间隔时间是5秒
命令超时时间为3秒
posted on 2019-12-10 15:37 ExplorerMan 阅读(608) 评论(0) 编辑 收藏 举报