使用Dockerfile描述待构建镜像的说明和需要执行的指令。
定制一个nginx镜像
编写Dockerfile
Dockerfile内容:
FROM nginx
RUN echo 'this is a local nginx image' > /usr/share/nginx/html/index.html
FROM指示基础镜像
RUN表示指令,有两种格式
- RUN <命令行命令> 就是直接跟终端操作
- RUN [“可执行文件”, “参数1”, “参数2”] 例如RUN ["./test.php", “dev”, “offline”] 等价于 RUN ./test.php dev offline
Dockerfile的指令每执行一次都会在docker上新建一层,层多了,镜像就变大了。
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层镜像。可简化为以下格式:(只会创建1层镜像)
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
构建镜像
-t是目标镜像名
点号是本次执行的上下文路径。docker的运行模式是C/S,本机是C,docker引擎是S。本机打包上下文路径下的所有文件发给docker引擎,docker引擎才能使用。如果不指明的话,上下文路径就是Dockerfile所在的位置。所以,应该避免在上下文路径里存放无用文件,以防打包时间过长。
pxy@pxy-pc:~/Desktop$ docker build -t nginx:v3 .
Sending build context to Docker daemon 265.1MB
Step 1/2 : FROM nginx
---> 5a3221f0137b
Step 2/2 : RUN echo 'this is a local nginx image' > /usr/share/nginx/html/index.html
---> Running in daa66a298414
Removing intermediate container daa66a298414
---> 870948baf772
Successfully built 870948baf772
Successfully tagged nginx:v3
pxy@pxy-pc:~/Desktop$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx v3 870948baf772 About a minute ago 126MB
pxt/ubuntu 1214 e2878e512eef 2 hours ago 168MB
...
其他指令
COPY
复制指令:从上下文目录中复制文件、文件夹到容器内指定路径
COPY [--chown=<user>:<group>] <源路径1>... <目标路径>
COPY [--chown=<user>:<group>] ["<源路径1>",... "<目标路径>"]
[–chown]是可选的,用于指定owner和group。
源路径支持通配符。
目标路径是容器里的路径,如果不存在,会自动创建。
ADD
与COPY类似。需求相同的话更推荐COPY。
ADD的优点:如果源文件是tar压缩文件,格式为gzip bzip2 xz时,ADD能在目标路径自动解压
ADD的缺点:复制tar就必须解压。构建可能变慢。
CMD
类似RUN,但是CMD在docker run时运行,RUN是在docker build时运行。
- CMD是为启动的容器指定的、默认要运行的程序,程序运行结束,容器也就随之结束了。
- CMD指令指定的程序可以被docker run命令行参数中指定要运行的程序覆盖。
- 如果Dockerfile中存在多个CMD指令,则只有最后一个生效。
CMD <shell 命令> # 实际运行时也会转化为第二种格式。默认可执行文件是sh
CMD ["<可执行文件或命令>","<param1>","<param2>",...] # 推荐
CMD ["<param1>","<param2>",...] # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数
ENTRYPOINT
类似于CMD指令,但是不会被docker run的命令行参数中指定的指令覆盖,且命令行参数会被当成参数送给ENTRYPOINT指令指定运行的程序。如果运行 docker run 时使用了 --entrypoint 选项,此选项的参数可当作要运行的程序覆盖 ENTRYPOINT 指令指定的程序。同样的,如果Dockerfile中有多条ENTRYPOINT指令,也是只有最后一个生效。
优点:在执行docker run时可以指定ENTRYPOINT指令的参数
ENTRYPOINT ["<executeable>","<param1>","<param2>",...]
假设构建nginx:test的Dockerfile是这样:
FROM nginx
ENTRYPOINT ["nginx", "-c"] # 定参
CMD ["/etc/nginx/nginx.conf"] # 变参
1.不传参运行
$ docker run nginx:test
容器内运行的就是 nginx -c /etc/nginx/nginx.conf,那么CMD是给ENTRYPOINT传参的。
2.传参运行
$ docker run nginx:test -c /etc/nginx/new.conf
容器内运行的是nginx -c /etc/nginx/new.conf,CMD和ENTRYPOINT的参数都被忽略,用docker run 带的参数。(前提是new.conf已经在容器里了)
ENV
定义和设置环境变量。在后续指令中可用。
ENV <key> <value>
ENV <key1>=<value1> <key2>=<value2> ...
ARG
与ENV作用一致。但是ARG的设置只对Dockerfile内有效,即只在docker build过程中有效,构建好的镜像中不存在此环境变量。docker build也可以用–build-arg <参数名>=<值>来覆盖。
ARG <参数名>[=<默认值>]
VOLUME
定义匿名数据卷。在启动容器时忘记挂载数据卷,会自动挂载到匿名卷。docker run的-v参数可以覆盖。
作用:1.避免重要的数据因重启容器而丢失;2.避免容器不断变大。
VOLUME ["<路径1>", "<路径2>"...]
VOLUME <路径>
EXPOSE
声明端口。
作用:1.帮助镜像的使用者理解这个镜像服务的守护端口,以便配置映射。2.使用docker run -P随机映射时,会自动映射到EXPOSE的端口。
EXPOSE <端口1> [<端口2>...]
WORKDIR
指定工作目录。docker build过程中,每一个RUN命令都是新建的一层,只有WORKDIR指定的目录会在每一层中存在。这个目录应该是提前创建好的。
WORKDIR <工作路径目录>
USER
指定执行后续命令的用户和用户组。只用来切换用户。且该用户应该已存在了。
USER <用户名>[:<用户组>]
HEALTHCHECK
用于指定某个程序或指令来监控docker容器服务的运行状态。
HEALTHCHECK [选项] CMD <命令>:设置检查容器健康状况的命令
HEALTHCHECK NONE:如果基础镜像有健康检查指令,使用这行可以屏蔽掉其健康检查指令
HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用,可以参考 CMD 的用法。
ONBUILD
用于延迟构建命令的执行。就是本次build不会执行ONBUILD后跟的指令,但是有新的Dockerfile使用这个镜像时,这个指令会被执行。
ONBUILD <其他指令>