anxpp的博客

As they sow , so let them reap .

Docker基础教程——Dockerfile

原文出处:http://blog.csdn.net/anxpp/article/details/52495309

    Dockerfile是一个文本格式的配置文件,我们可以使用Dockerfile文件快速创建自定义的镜像。

    Dockerfile支持的众多指令是本文主要要介绍的内容,之后会给出一个基本示例。

    一般而言,Docker分为4部分:基础镜像信息、维护者信息、镜像操作指令和容器启动时的执行命令。

    并且支持以#开头的注释行。

1、指令

    指令的一半格式是INSTRUCTION arguments。

    (1)FROM

    格式为FROM <image>或者FROM <image>:<tag>。

    Dockerfile文件第一行必须为FROM指令,并且,如果在同一个Dockerfile中创建多个镜像时,可以使用多个FROM指令(每个镜像一次)。

    (2)MAINTAINER

    指定维护者信息,格式为:MAINTAINER <name>。

    (3)RUN

    格式为RUN <command>或者RUN [“executable”,"param1","param2"]。

    前者将在shell终端中运行命令,即/bin/sh -c;后者使用exec执行。

    第二种方式可以指定其他终端实现,如:RUN [“/bin/bash”,"-c","echo hello"]。

    每天RUN命令将在当前镜像基础上执行指定命令,并提交为新的镜像。

    当命令较长时,可以使用\来换行。

    (4)CMD

    指定启动容器时执行的命令,每个Dockerfile只能有一条CMD命令。如果指定了多个该命令,只有最后一条会被执行。

    该命令支持三种格式:

  • CMD ["executable","param1","param2"]:使用exec执行
  • CMD command param1 param2:在/bin/sh中执行,提供给需要交互的应用
  • CMD ["param1","param2"]:提供给ENTRYPOINT的默认参数

    如果在其中容器时指定了运行的命令,就会覆盖掉CMD命令。

    (5)EXPOSE

    告诉docker服务端容器要暴露的端口号,供互联系统使用。

    格式:EXPOSE <port> [<port>...]

    在容器启动时,需要通过-P让Docker主机自动分配一个端口转发到指定的端口;使用-p则可以具体指定哪个本地端口会映射过来。

    (6)ENV

    指定环境变量,会被后溪RUN指令使用,并咋容器运行时保持。

    格式为:ENV <key> <value>

    (7)ADD

    该命令向容器中复制文件。

    格式:ADD <src> <dest>

    指定的<src>会被复制到<dest>。

    <src>可是是Dockerfile所在目录的一个相对路径(文件或者目录),也可以是一个URL,还可以是一个tar文件(会自动解压为一个目录)。

    (8)COPY

    格式COPY <src> <dest>

    复制主机的<src>(Dockerfile所在目录的相对路径,文件或目录)为容器的<dest>,目标路径不存在时会自动创建。

    (9)ENTRYPOINT

    配置容器启动后执行的命令,并且不可以被docker run提供过的参数覆盖。

    格式:

  • ENTRYPOINT ["executable","param1","param2"]
  • ENTRYPOINT command param1 param2:shell中执行

    同样的,每个Dockerfile中只能有一个该指令,指定多个时,只有最后一个生效。

    (10)VOLUME

    创建一个可以从本地主机或者其他容器挂载的挂载点,一般用来存放数据库和需要保持的数据等。

    格式:VOLUME ["/data"]。

    (11)USER

    指定运行容器时的用户名或UID,后续的RUN也会使用指定用户。

    格式:USER daemon

    (12)WORKDIR

    为后续的RUN、CMD、ENTRYPOINT指令配置工作路径。

    格式:WORKDIR /path/to/workdir。

    可以使用多个该指令,后续指令如果是相对路径,则会基于之前的命令指定路径

    比如:

WORKDIR /A
WORKDIR B
RUN X
    则最终路径为:/A/B。

    (13)ONBUILD

    配置当前所创建的镜像作为其他新创建镜像的基础镜像时,所执行的操作指令。

    格式:ONBUILD [INSTRUCTION]。

    比如如下Dockerfile:

...
ONBUILD ADD  .   /app/src
ONBUILD RUN /usr/local/... --dir  /app/src
...
    如果基于以上镜像创建新镜像时,新的Dockerfile中使用FROM指定以上为基础镜像,会自动执行ONBUILD指令内容,等价于在后面添加两条指令。

2、创建镜像

    编写好Dockerfile后,可以通过docker build命令创建镜像。
    基本格式:docker build[]选项 路径。

    改命令将读取指定路径下(包括子目录)的Dockerfile,并将该路径下所有内容发送给docker服务端,有服务端创建镜像。

    一般建议放置Dockerfile的目录为空目录。

    可以通过.dockerignore文件(每行一个匹配模式)让docker忽略路径下的目录和文件。

    使用-t指定镜像的标签信息。

    比如:

docker build -t image_name /src/dockerfile_path

3、示例

mysql镜像的Dockerfile如下:

#本文参考了「tutum」的 Dockerfile
FROM sshd
MAINTAINER Waitfish <dwj_zz@163.com>
#安装软件 
ENV DEBIAN_FRONTEND noninteractive
RUN apt-get update && \
  apt-get -yq install mysql-server-5.6 pwgen && \
  rm -rf /var/lib/apt/lists/*

# 删除预安装的数据库文件
RUN rm -rf /var/lib/mysql/*

# 添加文件夹下的 MYSQL 配置文件
ADD my.cnf /etc/mysql/conf.d/my.cnf
ADD mysqld_charset.cnf /etc/mysql/conf.d/mysqld_charset.cnf

# 添加 MYSQL 的脚本
ADD import_sql.sh /import_sql.sh
ADD run.sh /run.sh
RUN chmod 755 /*.sh

# 设置环境变量,用户名以及秘密
ENV MYSQL_USER admin
ENV MYSQL_PASS **Random**

# 设置主从复制模式下的环境变量
ENV REPLICATION_MASTER **False**
ENV REPLICATION_SLAVE **False**
ENV REPLICATION_USER replica
ENV REPLICATION_PASS replica

# 设置可以允许挂载的卷,可以用来备份数据库和配置文件
VOLUME  ["/etc/mysql", "/var/lib/mysql"]

# 设置可以映射的端口,如果是从我们的 sshd 镜像继承的话,默认还会开启 22 端口
EXPOSE 3306
CMD ["/run.sh"]


小结

    Docker Hub和Docker Pool社区提供了大量的Dockerfile范例供我们参考。

    后续文章会给出一些热门镜像的使用。

阅读更多
版权声明:http://blog.csdn.net/anxpp https://blog.csdn.net/anxpp/article/details/52495309
所属专栏: Docker基础教程及实践
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

不良信息举报

Docker基础教程——Dockerfile

最多只允许输入30个字

加入CSDN,享受更精准的内容推荐,与500万程序员共同成长!
关闭
关闭