根据 Dockerfile 构建出一个镜像
Dockfile 是一种被 Docker 程序解释的脚本, Dockerfile 由一条一条的指令组成, 每条
指令对应 Linux 下面的一条命令. Docker 程序将这些 Dockerfile 指令翻译真正的 Linux 命
令. Dockerfile 有自己书写格式和支持的命令, Docker 程序解决这些命令间的依赖关系,
类似于 Makefile.Docker 程序将读取 Dockerfile, 根据指令生成定制的 image. 相比
image 这种黑盒子, Dockerfile 这种显而易见的脚本更容易被使用者接受, 它明确的表明
image 是怎么产生的. 有了 Dockerfile, 当我们需要定制自己额外的需求时, 只需在
Dockerfile 上添加或者修改指令, 重新生成 image 即可, 省去了敲命令的麻烦.
Dockerfile 由一行行命令语句组成, 并且支持以# 开头的注释行.
Dockerfile 的指令是忽略大小写的, 建议使用大写, 每一行只支持一条指令, 每条指令
可以携带多个参数.
Dockerfile 的指令根据作用可以分为两种: 构建指令和设置指令.
构建指令用于构建 image, 其指定的操作不会在运行 image 的容器上执行;
设置指令用于设置 image 的属性, 其指定的操作将在运行 image 的容器中执行.
一般的, Dockerfile 分为四部分: 基础镜像信息, 维护者信息, 镜像操作指令和容器启动时
执行指令.
下面是一个例子:
- #This dockerfile uses the Ubuntu image
- #VERSION 2 - EDITION 1
- #Author: docker_user
- #Command format: Instruction [arguments / command] ..
- #Base image to use, this must be set as the first line
- # 第一行必须指明基于的基础镜像
- FROM Ubuntu
- #Maintainer: docker_user<docker_user at email.com> (@docker_user)
- # 维护该镜像的用户信息
- MAINTAINER docker_user docker_user@email.com
- #Commands to update the image
- # 镜像操作命令
- RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe">>
- /etc/apt/sources.list
- RUN apt-get update && apt-get install -y nginx
- RUN echo "\ndaemon off;">> /etc/nginx/nginx.conf
- # 开启 80 端口
- EXPOSE 80
- #Commands when creating a new container
- # 启动容器时执行的命令
- CMD /usr/sbin/nginx
在编写 dockerfile 时, 有严格的格式要遵循:
其中, 一开始必须使用 FROM 指令指明所基于的镜像名称, 接下来使用 MAINTAINER 指
令说明维护者信息. 后面则是镜像操作指令, 例如 RUN 指令, RUN 指令将对镜像执行跟随
的命令. 每运行一条 RUN 指令, 都会给基础镜像添加新的一层并提交. 最后是 CMD 指令,
来指定运行容器时的操作命令.
dockerfile 指令
指令的一般格式为 INSTRUCTION arguments, 指令包括 FROM ,MAINTAINER ,RUN
等.
(1)FROM(指定基础 image)
构建指令, 必须指定且需要在 Dockerfile 其他指令的前面. 后续的指令都依赖于该指令指定
的 image.FROM 指令指定的基础 image 可以是官方远程仓库中的, 也可以位于本地仓库.
该指令有两种格式:
FROM <image>
指定基础 image 为该 image 的最后修改的版本.
或者:
FROM <image>:<tag>
指定基础 image 为该 image 的一个 tag 版本.
(2)MAINTAINER(用来指定镜像创建者信息)
构建指令, 用于将 image 的制作者相关的信息写入到 image 中. 当我们对该 image 执行
docker inspect 命令时, 输出中有相应的字段记录该信息.
格式:
- MAINTAINER <name>
- (3)RUN(安装软件用)
构建指令, RUN 可以运行任何被基础 image 支持的命令. 如基础 image 选择了 Ubuntu, 那
么软件管理部分只能使用 Ubuntu 的命令.
该指令有两种格式:
- RUN <command> (the command is run in a shell - /bin/sh -c)
- RUN ["executable", "param1", "param2" ... ] (exec form)
前者将在 shell 终端中运行命令, 即 / bin/sh -c ; 后者则使用 exec 执行.
指定使用其它终端可以通过第二种方式实现, 例如 RUN ["/bin/bash", "-c", "echo hello"]
.
每条 RUN 指令将在当前镜像基础上执行指定命令, 并提交为新的镜像. 当命令较长时可以
使用 "\" 来换行.
(4)CMD(设置 container 启动时执行的操作)
该指令有三种格式:
设置指令, 用于 container 启动时指定的操作. 该操作可以是执行自定义脚本, 也可以是执
行系统命令.
CMD ["executable","param1","param2"] 使用 exec 执行, 推荐方式;
CMD command param1 param2 在 / bin/sh 中执行, 提供给需要交互的应用;
当 Dockerfile 指定了 ENTRYPOINT, 那么使用下面的格式:
CMD ["param1","param2"] 提供给 ENTRYPOINT 的默认参数;
ENTRYPOINT 指定的是一个可执行的脚本或者程序的路径, 该指定的脚本或者程序将会
param1 和 param2 作为参数执行. 所以如果 CMD 指令使用上面的形式, 那么 Dockerfile 中
必须要有配套的 ENTRYPOINT.
指定启动容器时执行的命令, 每个 Dockerfile 只能有一条 CMD 命令. 如果指定了多条命
令, 只有最后一条会被执行. 如果用户启动容器时候指定了运行的命令, 则会覆盖掉 CMD
指定的命令.
5)ENTRYPOINT(设置 container 启动时执行的操作)
设置指令, 指定容器启动时执行的命令, 可以多次设置, 但是只有最后一个有效.
两种格式:
- ENTRYPOINT ["executable", "param1", "param2"]
- ENTRYPOINT command param1 param2 (shell 中执行).
配置容器启动后执行的命令, 并且不可被 docker run 提供的参数覆盖.
每个 Dockerfile 中只能有一个 ENTRYPOINT, 当指定多个时, 只有最后一个起效.
该指令的使用分为两种情况, 一种是独自使用, 另一种和 CMD 指令配合使用.
当独自使用时, 如果你还使用了 CMD 命令且 CMD 是一个完整的可执行的命令, 那么 CMD
指令和 ENTRYPOINT 会互相覆盖只有最后一个 CMD 或者 ENTRYPOINT 有效.
例如: CMD 指令将不会被执行, 只有 ENTRYPOINT 指令被执行
- CMD echo "Hello, World!"
- ENTRYPOINT ls -l
另一种用法和 CMD 指令配合使用来指定 ENTRYPOINT 的默认参数, 这时 CMD 指令不是一
个完整的可执行命令, 仅仅是参数部分; ENTRYPOINT 指令只能使用 JSON 方式指定执行命
令, 而不能指定参数.
例如:
- FROM Ubuntu
- CMD ["-l"]
- ENTRYPOINT ["/usr/bin/ls"]
- (6)USER(设置 container 容器的用户, 默认是 root 用户)
格式为:
USER daemon
指定运行容器时的用户名或 UID, 后续的 RUN 也会使用指定用户.
当服务不需要管理员权限时, 可以通过该命令指定运行用户. 并且可以在之前创建所需要的
用户, 例
如: RUN groupadd -r postgres&&useradd -r -g postgres postgres
例如: 指定 Memcached 的运行用户
- ENTRYPOINT ["memcached"]
- USER daemon
或 EN
- TRYPOINT ["memcached", "-u", "daemon"]
- (7)EXPOSE(指定容器需要映射到宿主机器的端口)
格式为:
EXPOSE <port> [<port>...]
设置指令, 该指令会将容器中的端口映射成宿主机器中的某个端口. 当你需要访问容器的时
候, 可以不是用容器的 IP 地址而是使用宿主机器的 IP 地址和映射后的端口.
要完成整个操作需要两个步骤, 首先在 Dockerfile 使用 EXPOSE 设置需要映射的容器端口,
然后在运行容器的时候指定 - p 选项加上 EXPOSE 设置的端口, 这样 EXPOSE 设置的端口号会
被随机映射成宿主机器中的一个端口号. 也可以指定需要映射到宿主机器的哪个端口, 这时
要确保宿主机器上的端口号没有被使用. EXPOSE 指令可以一次设置多个端口号, 相应的运
行容器的时候, 可以配套的多次使用 - p 选项.
例如: 映射一个端口
- EXPOSE port1
- # 相应的运行容器使用的命令
- docker run -p port1 image
例如: 映射多个端口
- EXPOSE port1 port2 port3
- # 相应的运行容器使用的命令
- docker run -p port1 -p port2 -p port3 image
- # 还可以指定需要映射到宿主机器上的某个端口号
- docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image
端口映射是 docker 比较重要的一个功能, 原因在于我们每次运行容器的时候容器的 IP 地址
不能指定而是在桥接网卡的地址范围内随机生成的. 宿主机器的 IP 地址是固定的, 我们可以
将容器的端口的映射到宿主机器上的一个端口, 免去每次访问容器中的某个服务时都要查看
容器的 IP 的地址. 对于一个运行的容器, 可以使用 docker port 加上容器中需要映射的端口
和容器的 ID 来查看该端口号在宿主机器上的映射端口.
(8)ENV(用于设置环境变量)
构建指令, 指定一个环境变量, 会被后续 RUN 指令使用, 并在容器运行时保持.
格式:
ENV <key> <value>
设置了后, 后续的 RUN 命令都可以使用, container 启动后, 可以通过 docker inspect 查看
这个环境变量, 也可以通过在 docker run --env key=value 时设置或修改环境变量.
假如你安装了 JAVA 程序, 需要设置 JAVA_HOME, 那么可以在 Dockerfile 中这样写:
ENV JAVA_HOME /path/to/java/dirent
再例如:
- ENV PG_MAJOR 9.3
- ENV PG_VERSION 9.3.4
- RUN curl http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC
- /usr/src/postgress
- ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
- (9)ADD(将源文件复制到 container 的目标文件)
构建指令, 所有拷贝到 container 中的文件和文件夹权限为 0755,uid 和 gid 为 0;
源文件要与 Dockerfile 位于相同目录中;
1, 如果源路径是个文件, 且目标路径是以 / 结尾, 则 docker 会把目标路径当作一个目
录, 会把源文件拷贝到该目录下. 如果目标路径不存在, 则会自动创建目标路径.
2, 如果源路径是个文件, 且目标路径是不是以 / 结尾, 则 docker 会把目标路径当作一个文
件.
如果目标路径不存在, 会以目标路径为名创建一个文件, 内容同源文件;
如果目标文件是个存在的文件, 会用源文件覆盖它, 当然只是内容覆盖, 文件名还是目标文
件名.
如果目标文件实际是个存在的目录, 则会源文件拷贝到该目录下. 注意, 这种情况下, 最
好显示的以 / 结尾, 以避免混淆.
3, 如果源路径是个目录, 且目标路径不存在, 则 docker 会自动以目标路径创建一个目录,
把源路径目录下的文件拷贝进来. 如果目标路径是个已经存在的目录, 则 docker 会把源路
径目录下的文件拷贝到该目录下.
4, 如果源文件是个归档文件 (压缩文件), 则 docker 会自动帮解压.
格式:
ADD <src> <dest>
该命令将复制指定的 < src > 到容器中的 < dest>.
其中 < src > 可以是 Dockerfile 所在目录的一个相对路径; 也可以是一个 URL; 还可以是一个
tar 文件 (自动解压为目录)
<dest > 是 container 中的绝对路径
例如:
- #test
- FROM Ubuntu
- MAINTAINER hello
- ADD test1.txt test1.txt
- ADD test1.txt test1.txt.bak
- ADD test1.txt /mydir/
- ADD data1 data1
- ADD data2 data2
- ADD zip.tar /myzip
- (10)COPY
格式为 COPY <src><dest>
复制本地主机的 < src>(为 Dockerfile 所在目录的相对路径) 到容器中的 < dest>.
源文件 / 目录要与 Dockerfile 在相同的目录中
COPY 指令和 ADD 指令功能和使用方式类似. 只是 COPY 指令不会做自动解压工作.
(11)VOLUME(指定挂载点)
设置指令, 使容器中的一个目录具有持久化存储数据的功能, 该目录可以被容器本身使用,
也可以共享给其他容器使用. 我们知道容器使用的是 AUFS, 这种文件系统不能持久化数
据, 当容器关闭后, 所有的更改都会丢失. 当容器中的应用有持久化数据的需求时可以在
Dockerfile 中使用该指令.
格式:
VOLUME ["<mountpoint>"]
例如: FROM base
VOLUME ["/tmp/data"]
运行通过该 Dockerfile 生成 image 的容器,/tmp/data 目录中的数据在容器关闭后, 里面的
数据还存在. 例如另一个容器也有持久化数据的需求, 且想使用上面容器共享的 / tmp/data
目录, 那么可以运行下面的命令启动一个容器:
docker run -t -i -rm -volumes-from container1 image2 bash
container1 为第一个容器的 ID,image2 为第二个容器运行 image 的名字.
(12)WORKDIR(切换目录)
设置指令, 可以多次切换 (相当于 cd 命令), 对 RUN,CMD,ENTRYPOINT 生效. 为后续的
RUN,CMD,ENTRYPOINT 指令配置工作目录.
格式:
WORKDIR /path/to/workdir
例如: 在 /p1/p2 下执行 VIM a.txt
- WORKDIR /p1
- WORKDIR p2
- RUN VIM a.txt
可以使用多个 WORKDIR 指令, 后续命令如果参数是相对路径, 则会基于之前命令指定的路
径.
例如
- WORKDIR /a
- WORKDIR b
- WORKDIR c
- RUN pwd
则最终路径为 / a/b/c.
(13)ONBUILD(在子镜像中执行)
ONBUILD <Dockerfile 关键字 >
ONBUILD 指定的命令在构建镜像时并不执行, 而是在它的子镜像中执行.
格式为:
ONBUILD [INSTRUCTION] .
配置当所创建的镜像作为其它新创建镜像的基础镜像时, 所执行的操作指令.
例如, Dockerfile 使用如下的内容创建了镜像 image-A .
- [...]
- ONBUILD ADD . /App/src
- ONBUILD RUN /usr/local/bin/python-build --dir /App/src
- [...]
如果基于 image-A 创建新的镜像时, 新的 Dockerfile 中使用 FROM image-A 指定基础镜
像时, 会自动执行 ONBUILD 指令内容.
等价于在后面添加了两条指令.
- FROM image-A
- #Automatically run the following
- ADD . /App/src
- RUN /usr/local/bin/python-build --dir /App/src
使用 ONBUILD 指令的镜像, 推荐在标签中注明, 例如 Ruby:1.9-onbuild.
编写完成 Dockerfile 之后, 可以通过 docker build 命令来创建镜像.
基本的格式为 docker build [选项] 路径, 该命令将读取指定路径下的 Dockerfile, 并将该
路径下所有内容发送给 Docker 服务端, 由服务端来创建镜像. 因此一般建议放置
Dockerfile 的目录为空目录.
要指定镜像的标签信息, 可以通过 - t 选项, 例如
$ sudo docker build -t myrepo /myapp/tmp/test1/
docker 应用案例: 使用 dockerfile 创建 sshd 镜像模板并提供 http 访问应用
1) 创建一个 sshd_dockerfile 工作目录
编辑 run.sh 脚本
- [root@docker01 sshd_dockerfile]# cat run.sh
- #!/bin/sh
- /usr/sbin/httpd -D DFOREGROUND
- /usr/sbin/sshd -D
在主机上生成 SSH 秘钥对, 并创建 authorized_keys 文件
- [root@docker01 sshd_dockerfile]# cat /root/.SSH/id_rsa.pub>
- /root/sshd_dockerfile/authorized_keys
- [root@docker01 sshd_dockerfile]# ls
- authorized_keys Dockerfile run.sh
2, 编写 Dockerfile 文件, 内容如下:
- [root@docker01 sshd_dockerfile]# cat /root/sshd_dockerfile/Dockerfile
- FROM CentOS:latest
- MAINTAINER from ly@aliyun.com
- RUN yum install -y -q httpd openssh-server sudo.NET-tools
- RUN useradd admin
- RUN echo "admin:admin" | chpasswd
- RUN echo "admin ALL=(ALL) ALL">> /etc/sudoers
- RUN SSH-keygen -t dsa -f /etc/SSH/ssh_host_dsa_key
- RUN SSH-keygen -t rsa -f /etc/SSH/ssh_host_rsa_key
- RUN SSH-keygen -t ed25519 -f /etc/SSH/ssh_host_ed25519_key
- RUN SSH-keygen -t ecdsa -f /etc/SSH/ssh_host_ecdsa_key
- RUN mkdir -p /var/run/sshd
- RUN mkdir -p /home/admin/.SSH
- RUN sed -ri 's/#ServerName www.example.com:80/ServerName www.cloud.com/g'
- /etc/httpd/conf/httpd.conf
- ADD authorized_keys /home/admin/.SSH/authorized_keys
- ADD run.sh /run.sh
- RUN chmod 775 /run.sh
- EXPOSE 22 80
- CMD ["/run.sh"]
以上选项的含义解释:
FROM CentOS:latest 选择一个已有的 os 镜像作为基础
MAINTAINER 镜像的作者
RUN yum install -y -q httpd openssh-server sudo 安装 httpd,openssh-server,
来源: http://blog.51cto.com/13555423/2303763