1 Dockerfile介绍
Dockfile是一种被Docker程序解释的脚本,Dockerfile由一条一条的指令组成,每条指令对应Linux下面的一条命令。Docker程序将这些Dockerfile指令翻译真正的Linux命令。Dockerfile有自己书写格式和支持的命令,Docker程序解决这些命令间的依赖关系,类似于Makefile。Docker程序将读取Dockerfile,根据指令生成定制的image。相比image这种黑盒子,Dockerfile这种显而易见的脚本更容易被使用者接受,它明确的表明image是怎么产生的。有了Dockerfile,当我们需要定制自己额外的需求时,只需在Dockerfile上添加或者修改指令,重新生成image即可,省去了敲命令的麻烦。
2 Dockerfile语法介绍
Dockerfile的注释以“#”开始,每一行都是一个指令
一般情况下,Dockerfile由4部分组成:
- 基础镜像信息(Base Image)
- 维护者信息(maintainer)
- 镜像操作指令(Commands to update the base image)
- 容器启动指令(Commands when creating a new container)
必须说明的是,如果使用Dockerfile来构建镜像,需要确定
- Dockerfile的第一条有效信息必须是基础镜像信息
- 维护者信息紧随其后
- 镜像操作指令则在维护者信息之后
- 最后是镜像启动指令
2.1 Dockerfile 指令
Dockerfile的指令一般采用的格式,其中INSTRUCTION是Dockerfile的关键字,包括FROM, MAINTAINER, RUN等,下面进行详细介绍
INSTRUCTION arguments
2.1.1 FROM
Dockerfile的第一条必须是FROM指令,用来指定要制作的镜像继承自哪个镜像,格式如下
FROM
FROM :
例如需要构建一个采用mongodb的数据库镜像,用以下指令
FROM mongo:3.2
2.1.2 MAINTAINER
用来指定维护者信息,格式为
MAINTAINER
例如我自己的维护者信息
MAINTAINER [email protected]
2.1.3 RUN
该指令用于执行shell命令,当解析Dockerfile时,遇到RUN指令,Docker会将该指令翻译为如下,其中xxxxxx为RUN后面的shell命令
/bin/sh -c "XXXXXX"
格式为
RUN
RUN <"executable","param1","param2"...>
例如需要安装相关软件及创建文件夹
RUN mkdir /Code
RUN pip install -r requirements.txt
2.1.4 EXPOSE
该指令将容器中的端口号暴露出来,也可以通过"docker run -p" 命令实现和服务器端口的映射
格式为
EXPOSE [...]
例如容器中部署了web应用,需要将8080端口和80端口暴露出来
EXPOSE 80 8080
2.1.5 EXPOSE
该指令指定启动容器时执行的命令,每个Dockerfile只能有一条CMD指令,如果指定了多条,只有最后一条会被执行。
如果用户启动容器时指定了运行的命令,则会覆盖CMD指定的命令
格式为
CMD ["executable","param1","param2"] #使用exec执行,推荐方式
CMD command param1 param2 #在/bin/sh中执行,提供给需要交互的应用
CMD [“param1”,"param2"] #提供给ENTRYPOINT的默认参数
例如启动容器时要求启动服务器
CMD python app.py
2.1.6 ENTRYPOINT
设置指令,指定容器启动时执行的命令,可以多次设置,但是只有最后一个有效
格式如下所示
ENTRYPOINT ["executable", "param1", "param2"] (like an exec, the preferred form)
ENTRYPOINT command param1 param2 (as a shell)
该指令的使用分为两种情况,一种是独自使用,另一种和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"]
2.1.7 VOLUME
创建一个可以从本地主机或者其他容器挂载的挂载点(目录),一般用来存放数据库或者需要永久保存的数据,该目录可以被容器本身使用,也可以共享给其他容器使用。我们知道容器使用的是AUFS,这种文件系统不能持久化数据,当容器关闭后,所有的更改都会丢失。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。
如果和host共享目录,Dockerfile中必须创建一个挂载点,然后在启动容器的时候,通过以下指令来进行挂载
docker run -v $HOSTPATH:$CONTAINERPATH
格式如下所示
VOLUME [""]
例如
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的名字
2.1.8 ENV
该指令指定一个环境变量,会被后续RUN指令使用,并在容器运行时保持,格式为
ENV
container启动后,可以通过docker inspect查看这个环境变量,也可以通过在docker run --env key=value时设置或修改环境变量。
假如你安装了JAVA程序,需要设置JAVA_HOME,那么可以在Dockerfile中这样写
ENV JAVA_HOME /path/to/java/dirent
2.1.9 ADD指令
该指令将复制指定的到容器中的,其中可以是
- Dockerfile所在目录的一个相对路径
- 一个URL
- 可以是一个tar文件(会自动解压为目录)
指令为
ADD
所有拷贝到container中的文件和文件夹权限为0755,uid和gid为0;
- 如果是一个目录,那么会将该目录下的所有文件添加到container中,不包括目录;
- 如果文件是可识别的压缩格式,则docker会帮忙解压缩(注意压缩格式);
- 如果是文件且中不使用斜杠结束,则会将视为文件,的内容会写入;
- 如果是文件且中使用斜杠结束,则会将文件拷贝到目录下
2.1.10 WORKDIR
设置指令,可以多次切换(相当于cd命令),对RUN,CMD,ENTRYPOINT生效
格式为
WORKDIR /path/to/workdir
例如
WORKDIR /p1 WORKDIR p2 RUN vim a.txt
2.2 docker build
root@ubuntu:~# docker build --help
Usage: docker build [OPTIONS] PATH | URL | -
Build a new image from the source code at PATH
-c, --cpu-shares=0 CPU shares (relative weight)
--cpuset-cpus= CPUs in which to allow execution (0-3, 0,1)
-f, --file= Name of the Dockerfile (Default is 'PATH/Dockerfile')
--force-rm=false Always remove intermediate containers
--help=false Print usage
-m, --memory= Memory limit
--memory-swap= Total memory (memory + swap), '-1' to disable swap
--no-cache=false Do not use cache when building the image
--pull=false Always attempt to pull a newer version of the image
-q, --quiet=false Suppress the verbose output generated by the containers
--rm=true Remove intermediate containers after a successful build
-t, --tag= Repository name (and optionally a tag) for the image
3 示例
我将以前的一个项目的后端用Docker进行发布,采用两个容器,一个用来跑Service,一个专门用来作为数据库(mongodb),两个服务器之间有交互,Service容器会对Database容器进行增删改查操作
3.1 Database容器
直接拉取mongo服务器
docker pull mongo:3.2
等待下载完成后,我们就可以在本地镜像列表里查到REPOSITORY为mongo,标签为3.2的镜像。
然后运行容器
docker run -p 27017:27017 -v $PWD/db:/data/db -d mongo:3.2
命令说明:
-p 27017:27017 :将容器的27017 端口映射到主机的27017 端口
-v $PWD/db:/data/db :将主机中当前目录下的db挂载到容器的/data/db,作为mongo数据存储目录
3.2 Service容器
Service容器需要运行Flask应用,Dockerfile如下所示
FROM python:2.7
MAINTAINER xixy10 "[email protected]"
RUN /bin/echo 'root:123456' |chpasswd
RUN useradd xixy
RUN /bin/echo 'xixy:123456' |chpasswd
RUN mkdir /Code
WORKDIR /Code
ADD . /Code/
RUN pip install -r requirements.txt
WORKDIR ./TOP/util
RUN python question_lib_generator.py
WORKDIR ../
EXPOSE 5000
CMD python test.py
然后build产生镜像
docker build -t xixy/tpo:1.0 .
运行容器
docker run -it -p 5000:5000 xixy/tpo:1.0
然后即可访问,API正常运行,运行过程中Service容器会对Database容器进行增删改查,容器间通信会令写一篇
转载自https://www.tianmaying.com/tutorial/dockerfile