Docker - 构建镜像:编写和运行Dockerfile
Dockerfile 简介
Docker Hub拥有大量高质的官方镜像:可直接使用的服务类镜像、语言应用镜像、基础操作系统镜像等,满足绝大部分需求。
此外,可以通过定制镜像的方式来满足实际使用中的特定需求。
定制镜像实际上就是以一个镜像为基础,定制每一层的配置和文件。
可以选择现有镜像为基础镜像,也可以选择scratch镜像(虚拟的概念,并不实际存在,表示一个空白的镜像)。
Dockerfile是包含了新镜像创建过程中的每一层修改、安装、构建、操作指令的文本格式脚本。
每一条指令(Instruction)构建一层,描述该层应当如何构建。
为了简洁快速构建和满足低于Union FS的最大层数限制,可以在一个RUN指令里使用&&
串联多个命令,从而将多层简化为一层。
Dockerfile支持\
的换行方式和行首#
的注释格式。
镜像是多层存储,每一层的内容并不会在下一层被删除,会一直伴随镜像。
因此镜像构建时,确保每一层只添加真正需要的内容,清理任何无关的文件和配置。
良好的指令格式会让维护和排障更简便。
Dockerfile的常用指令
Dockerfile中的指令是通过docker build
命令来执行的。
更多信息可参考:
- https://docs.docker.com/reference/dockerfile/
- https://docs.docker.com/build/concepts/dockerfile/
- https://docs.docker.com/engine/reference/builder/
编写
- ADD Add local or remote files and directories. 添加文件或目录,将本地资源添加到镜像的目的位置
- ARG Use build-time variables. 构建镜像时可通过-build-arg指定参数
- COPY Copy files and directories. 复制文件或目录
- FROM Create a new build stage from a base image. 指定基础镜像(从一个已有镜像创建)
- LABEL Add metadata to an image.
- MAINTAINER Specify the author of an image. 维护者信息(名字和邮件地址)
- ONBUILD Specify instructions for when the image is used in a build.
- RUN Execute build commands. 运行shell命令
- SHELL Set the default shell of an image.
- USER Set user and group ID. 设置用户身份
- WORKDIR Change working directory. 指定工作目录
运行
- CMD Specify default commands. 指定容器启动时默认执行的命令,可以被覆盖,只有最后的CMD才会生效
- ENTRYPOINT Specify default executable. 指定容器启动时的执行内容,容器的进入点,不可被覆盖
- ENV Set environment variables. 设置环境变量
- EXPOSE Describe which ports your application is listening on. 指定应用的监听端口(暴露端口给主机)
- HEALTHCHECK Check a container's health on startup.
- VOLUME Create volume mounts. 定义存储卷(将指定路径挂载为存储卷)
- STOPSIGNAL Specify the system call signal for exiting a container.
docker build
Build an image from a Dockerfile
Usage: docker build [OPTIONS] PATH | URL | -
构建镜像的步骤
- 确定镜像模板
- 新建Dockerfile文件
- 使用Dockerfile的指令完善Dockerfile的内容
- 在Dockerfile文件的所在路径执行
docker build -t imageName:tag .
- 执行
docker run
命令并指定imageName:tag
和相关参数即可
注意事项
- 必须使用
PATH
参数指定上下文目录。
Docker是C/S结构,执行docker build
命令其实是在服务端(Docker引擎)中构建的,而不是在本地构建。
镜像构建时,通过指定上下文目录的方式,可以让服务端获得本地文件,从而能够构建包含本地文件的镜像。简而言之,需要加入镜像的本地文件必须存在于上下文目录中。
docker build
命令会将用户指定的上下文目录的内容打包并上传给Docker引擎。Docker引擎接收并展开就可以获得构建镜像所需的本地文件。 - 在上下文目录中,可以通过.dockerignore(语法类似.gitignore)排除不需要加入镜像的内容。
- COPY、ADD等指令中的源文件路径,使用的都是上下文(PATH)目录的相对路径。
- 如不指定dockerfile,Docker默认文件名为Dockerfile并放置于上下文目录中。
其它用法
- 从URL构建
- 用给定的tar压缩包构建:Docker引擎下载压缩包并自动解压缩,以其作为上下文开始构建。
- 从标准输入中读取Dockerfile进行构建(缺少上下文,无法执行COPY等指令):
docker build - < Dockerfile
或cat Dockerfile | docker build -
- 从标准输入中读取上下文压缩包进行构建:
docker build - < context.tar.gz
FROM scratch
表示选择空白镜像为基础镜像,所写的指令将作为镜像第一层开始存在,适合Linux下静态编译的程序,会让镜像体积更加小巧。
Dockerfile编写及运行示例
编写dockfile
[root@CentOS7 docker]# pwd
/tmp/docker
[root@CentOS7 docker]# ls -l
总用量 0
drwxr-xr-x 2 root root 24 5月 8 23:52 data
drwxr-xr-x 3 root root 60 5月 9 00:13 test
[root@CentOS7 docker]# tree
.
├── data
│ └── sample.txt
└── test
├── aliyun-sources.txt
├── buildfile
└── dir
└── messages.txt
3 directories, 4 files
[root@CentOS7 docker]#
[root@CentOS7 docker]# cat /tmp/docker/data/sample.txt
1234567890
[root@CentOS7 docker]#
[root@CentOS7 docker]# cat /tmp/docker/test/aliyun-sources.txt
deb http://mirrors.aliyun.com/ubuntu/ xenial main restricted
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted
deb http://mirrors.aliyun.com/ubuntu/ xenial universe
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates universe
deb http://mirrors.aliyun.com/ubuntu/ xenial multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted
deb http://mirrors.aliyun.com/ubuntu/ xenial-security universe
deb http://mirrors.aliyun.com/ubuntu/ xenial-security multiverse
[root@CentOS7 docker]#
[root@CentOS7 docker]# cat /tmp/docker/test/buildfile
# this is an example of Docker build.
FROM ubuntu
MAINTAINER anliven "anliven@yeah.net"
RUN echo 'Run docker build - create file!' > /tmp/file-create.log
COPY aliyun-sources.txt /etc/apt/sources.list
COPY dir/messages.txt /tmp/file-copy.log
VOLUME /tmp/docker/data
# ENV http_proxy="http://10.144.1.10:8080"
RUN apt-get update \
&& apt-get install -y inetutils-ping iproute net-tools \
&& apt-get install -y vim \
&& apt-get purge -y --auto-remove
[root@CentOS7 docker]#
[root@CentOS7 docker]# cat /tmp/docker/test/dir/messages.txt
Run docker build - copy file!
[root@CentOS7 docker]#
定制镜像
[root@CentOS7 ~]# docker build --file /tmp/docker/test/buildfile --tag ubuntu:test /tmp/docker/test/
Sending build context to Docker daemon 5.12 kB
Step 1 : FROM ubuntu
---> f7b3f317ec73
Step 2 : MAINTAINER anliven <anliven@yeah.net>
---> Running in 7c1140a0cc72
---> 9a0fb45df847
Removing intermediate container 7c1140a0cc72
Step 3 : RUN echo 'Run docker build - create file!' > /tmp/file-create.log
---> Running in 33bb7a725234
---> 866235e56f75
Removing intermediate container 33bb7a725234
Step 4 : COPY aliyun-sources.txt /etc/apt/sources.list
---> 6de0504452f5
Removing intermediate container e98687ed3e37
Step 5 : COPY dir/messages.txt /tmp/file-copy.log
---> 8def1507d4f3
Removing intermediate container 66e68d3efc2d
Step 6 : VOLUME /tmp/docker/data
---> Running in 10cca5bef10e
---> 6e887fff9079
Removing intermediate container 10cca5bef10e
Step 7 : RUN apt-get update && apt-get install -y inetutils-ping iproute net-tools && apt-get install -y vim && apt-get purge -y --auto-remove
---> Running in 4c54d21066cd
Get:1 http://mirrors.aliyun.com/ubuntu xenial InRelease [247 kB]
Get:2 http://mirrors.aliyun.com/ubuntu xenial-updates InRelease [102 kB]
Get:3 http://mirrors.aliyun.com/ubuntu xenial-backports InRelease [102 kB]
......
......
......
Processing triggers for libc-bin (2.23-0ubuntu7) ...
Reading package lists...
Building dependency tree...
Reading state information...
0 upgraded, 0 newly installed, 0 to remove and 9 not upgraded.
---> 62b945705a30
Removing intermediate container 4c54d21066cd
Successfully built 62b945705a30
[root@CentOS7 ~]#
验证
[root@CentOS7 ~]# docker images ubuntu
REPOSITORY TAG IMAGE ID CREATED SIZE
ubuntu test 62b945705a30 About a minute ago 202.1 MB
docker.io/ubuntu latest f7b3f317ec73 13 days ago 117.3 MB
[root@CentOS7 ~]#
[root@CentOS7 ~]# docker inspect --format "{{ .Config.Volumes }}" ubuntu:test
map[/tmp/docker/data:{}]
[root@CentOS7 ~]#
[root@CentOS7 ~]# docker history ubuntu:test
IMAGE CREATED CREATED BY SIZE COMMENT
62b945705a30 5 minutes ago /bin/sh -c apt-get update && apt-get inst 84.85 MB
6e887fff9079 6 minutes ago /bin/sh -c #(nop) VOLUME [/tmp/docker/data] 0 B
8def1507d4f3 6 minutes ago /bin/sh -c #(nop) COPY file:45739c777f02cabe8 30 B
6de0504452f5 6 minutes ago /bin/sh -c #(nop) COPY file:3d19f8187c6e93e48 655 B
866235e56f75 6 minutes ago /bin/sh -c echo 'Run docker build - create fi 32 B
9a0fb45df847 6 minutes ago /bin/sh -c #(nop) MAINTAINER anliven <anlive 0 B
f7b3f317ec73 13 days ago /bin/sh -c #(nop) CMD ["/bin/bash"] 0 B
<missing> 13 days ago /bin/sh -c mkdir -p /run/systemd && echo 'doc 7 B
<missing> 13 days ago /bin/sh -c sed -i 's/^#\s*\(deb.*universe\)$/ 2.759 kB
<missing> 13 days ago /bin/sh -c rm -rf /var/lib/apt/lists/* 0 B
<missing> 13 days ago /bin/sh -c set -xe && echo '#!/bin/sh' > /u 745 B
<missing> 13 days ago /bin/sh -c #(nop) ADD file:141408db9037263a47 117.3 MB
[root@CentOS7 ~]#
[root@CentOS7 ~]# docker run -it ubuntu:test
root@702e453e458f:/#
root@702e453e458f:/# ls -l /tmp
total 8
drwxr-xr-x 3 root root 18 May 8 16:33 docker
-rw-r--r-- 1 root root 30 May 8 15:53 file-copy.log
-rw-r--r-- 1 root root 32 May 8 16:33 file-create.log
root@702e453e458f:/#
root@702e453e458f:/# cat /tmp/file-copy.log
Run docker build - copy file!
root@702e453e458f:/# cat /tmp/file-create.log
Run docker build - create file!
root@702e453e458f:/#
root@702e453e458f:/# ls -l /tmp/docker/
total 0
drwxr-xr-x 2 root root 6 May 8 16:40 data
root@702e453e458f:/# ls -l /tmp/docker/data/
total 0
root@702e453e458f:/#
root@702e453e458f:/# dpkg --list inetutils-ping |grep ii
ii inetutils-ping 2:1.9.4-1build1 amd64 ICMP echo tool
root@702e453e458f:/#
root@702e453e458f:/# dpkg --list iproute |grep ii
ii iproute 1:4.3.0-1ubuntu3 all transitional dummy package for iproute2
root@702e453e458f:/#
root@702e453e458f:/# dpkg --list net-tools |grep ii
ii net-tools 1.60-26ubuntu1 amd64 NET-3 networking toolkit
root@702e453e458f:/#
root@702e453e458f:/# exit
[root@CentOS7 ~]#
参考信息
- https://docs.docker.com/reference/dockerfile/
- https://docs.docker.com/build/concepts/dockerfile/
- https://docs.docker.com/engine/reference/builder/
- https://www.runoob.com/docker/docker-dockerfile.html
行动是绝望的解药!
欢迎转载和引用,但请在明显处保留原文链接和原作者信息!
本博客内容多为个人工作与学习的记录,少数内容来自于网络并略有修改,已尽力标明原文链接和转载说明。如有冒犯,即刻删除!
以所舍,求所得,有所获,方所成。