Dockerfile详解以及Flask项目Dockerfile示例

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 <image>
FROM <image>:<tag>

例如需要构建一个采用mongodb的数据库镜像,用以下指令

FROM mongo:3.2

2.1.2 MAINTAINER

用来指定维护者信息,格式为

MAINTAINER <name>

例如我自己的维护者信息

MAINTAINER xixy10@foxmail.com

2.1.3 RUN

该指令用于执行shell命令,当解析Dockerfile时,遇到RUN指令,Docker会将该指令翻译为如下,其中xxxxxx为RUN后面的shell命令

/bin/sh -c "XXXXXX"

格式为

RUN <command>
RUN <"executable","param1","param2"...>

例如需要安装相关软件及创建文件夹

RUN mkdir /Code
RUN pip install -r requirements.txt

2.1.4 EXPOSE

该指令将容器中的端口号暴露出来,也可以通过"docker run -p" 命令实现和服务器端口的映射

格式为

EXPOSE <PORT>[<PORT>...]

例如容器中部署了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 ["<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的名字

2.1.8 ENV

该指令指定一个环境变量,会被后续RUN指令使用,并在容器运行时保持,格式为

ENV <key> <value>

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 <src> <dest>

所有拷贝到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 "xixy10@foxmail.com"

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容器进行增删改查,容器间通信会令写一篇

1.png

转载自https://www.tianmaying.com/tutorial/dockerfile

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,761评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,953评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,998评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,248评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,130评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,145评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,550评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,236评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,510评论 1 291
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,601评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,376评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,247评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,613评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,911评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,191评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,532评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,739评论 2 335

推荐阅读更多精彩内容