Dockerfile再恋笔记 | 详解篇

作者: AlicFeng | 来源:发表于2017-04-20 21:52 被阅读56次

    前言
    今晚整理整理dockerfile作为再恋笔记。
    那谁没事安心后随笔整理,想想都心痛。


    Dockerfile

    ​ Dockerfile是用于自定义构建Docker镜像的规则文件。编辑好了Dockerfile文件后,使用docker build即可构建一个镜像。构建一个怎样的镜像那就得看Dockerfile文件。我们来看看具体的Docker有哪些内容与规则。


    基本结构

    (1) 文件的编辑类似键值对,一个键配置一个值,规范而言,键为大写、值要小写

    (2) 使用#注释

    (3) 整体分为四个部分:镜像信息、作者信息、镜像构建指令信息、容器启动执行指令信息


    指令说明

    • FROM from

      说明:指定构建的镜像基于哪个镜像,该指令必须位于Dockerfile的第一个指令,倘若不存在该镜像,那就默认从Docker hub拉下来。

      FROM <image>
      # or
      FROM <image><:tag>
      

      示例 :基于debain的jessie版本

      FROM debian:jessie
      
    • **MAINTAINER ** maintainer

      说明:描述构建者的信息等等。

      MAINTAINER <message>
      

      示例:作者AlicFeng 邮箱alic@samego.com

      MAINAINER AlicFeng <alic@samego.com>
      
    • **RUN ** run

      说明:构建镜像要执行的shell指令,默认通过/bin/sh解析器进行解析,也可以指定解析器。

      RUN <command>
      # or 
      RUN ["executable","param1","param2"]
      

      示例 1 :更新源并安装并安装make,注意安装时一定要使用-y,不然有时会出错

      RUN apt-get update \
        apt-get install make
      

      示例2:执行 ls -lshell指令,并指定/bin/bash解析器

      RUN ["/bin/bash","ls","-l"]
      
    • CMD cmd

      说明:构建的容器启动时要执行的指令。注意主注意注意、cmd指令只能包含一条,多的话只执行最后一条。

      CMD ["executable", "param1", "param2"]    #将会调用exec执行,首选方式
      # or
      CMD ["param1", "param2"]                  #当使用ENTRYPOINT指令时,为该指令传递默认参数
      # or
      CMD <command> ["param1","param2"]         #将会调用/bin/sh -c执行
      

      示例 1:容器启动时执行/root/start.sh脚本。

      CMD ["/root/start.sh"]
      

      示例 2:执行nginx -g daemon off

      CMD ["nginx", "-g", "daemon off"]
      
    • ENTRYPOINT entrypoint

      说明:entrypoint与cmd指令类似,entrypoint在dockerfile中只能出现一次,否则只执行最后一条。它是配置容器启动后执行的命令。

      ENTRYPOINT ["executable", "param1", "param2"]       #将会调用exec执行,首选方式
      # or
      ENTRYPOINT <command> ["param1","param2"]              #将会调用/bin/sh -c执行
      

      *示例 *:执行/etc/init.d/nginx restart命令

      ENTRYPOINT ["/etc/init.d/nginx","restart"]
      
    • EXPOSE expose

      说明:指定暴露的端口,供容器之间联系( -link )使用。

      EXPOSE <port> [.....]
      

      示例:暴露3306端口

      EXPOSE 3306
      
    • ENV env

      说明:指定环境变量,容器运行时也可以指定,这里起到定义的作用。

      ENV <key> <value>
      # or
      ENV <key>=<value>
      

      示例 1:设置一个IP环境变量为127.0.0.1。

      ENV IP=127.0.0.1
      

      示例 2:设置一个ngixn_dir环境变量为/app/server/nginx。

      ENV nginx_dir /app/server/nginx
      WORKDIR $nginx_dir
      
    • ADD add

      说明:拷贝文件,将src拷贝到dest目录下。注意:src支持文件或目录或远程URL,同时src为当前目录的相对目录,而dest是容器的绝对路径,默认拷贝后文件或目录的权限为0775,要是src为容器可识别的压缩文件,那么将会自动解压,这点要注意!

      ADD <src> <dest>
      

      示例 1:拷贝一个远程文件,该文件的URL为https://sise.samego.com/Linux/redis.tar.gz,注意,该文件为容器识别的文件,将会自动解压。

      ADD https://sise.samego.com/Linux/redis.tar.gz /app       #执行之后dest为/app/redis/...
      

      示例 2:将/root/bak/conf/redis.conf文件拷贝到/app/redis/目录下。

      ADD /root/bak/conf/redis.conf /app/redis/
      
    • COPY copy

      说明:copy与add类似,但是copy的功能比较简洁,没有add强大,不支持远程URL,但是src源文件为容器本地文件或目录的时候,推荐使用copy。

      COPY <src> <dest>
      

      示例:将/root/bak/conf/redis.conf文件拷贝到/app/redis/目录下。

      ADD /root/bak/conf/redis.conf /app/redis/
      

    • VOLUME volume

      说明:指定容器的挂载点,使容器中的一个目录具有持久化存储数据的功能,该目录可以被容器本身使用,也可以共享给其他容器使用。我们知道容器使用的是AUFS,这种文件系统不能持久化数据,当容器关闭后,所有的更改都会丢失。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。

      VOLUME ["path",...]
      

      示例 :挂载/data/mysql/data目录。

      VOLUME ["/data/mysql/data/"]
      
    • WORKDIR workdir

      说明:指定工作目录。有时执行RUN指令时需要切换目录,那就通过workdir指令进行切换。切换目录后在下一次切换之前都是在此目录下。可以是相对目录也可以是绝对路径。

      WORKDIR <path>
      

      示例:将工作目录切换至/app/nginx目录。

      WORKDIR /app/nginx
      
    • USER user

      说明:指定容器运行执行RUN、CMD指令时的用户,注意:在下一次切换用户之前将一直使用该用户。

      USER <username | uid>
      

      示例:切换用户为same。

      USER alic
      
    • ONBUILD onbuild

      说明:配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令。

      ONBUILD [INSTRUCTION]
      

      示例:比如有这样一个基础镜像same:basic,在构建same:latest时,在basic基础镜像中使用ONBUILD声明的ONBUILD RUN apt-get update指令,构建latest版本也将会自动执行。

      # 这是same:basic
      ONBUILD RUN apt-get update
      
      # 这是same:latest正在构建的镜像
      FROM same:basic
      # 构建时将自动执行基于basic镜像使用ONBUILD的指令 如下
      RUN apt-get update
      

      构建镜像示例

      说明:基于alpine:3.5构建一个Redis镜像。

      FROM alpine:3.5
      
      # 创建一个redis用户组并创建一个redis用户将其增加在redis用户组
      RUN addgroup -S redis && adduser -S -G redis redis
      
      # grab su-exec for easy step-down from root
      RUN apk add --no-cache 'su-exec>=0.2'
      
      # 定义环境变量
      ENV REDIS_VERSION 3.2.8
      ENV REDIS_DOWNLOAD_URL http://download.redis.io/releases/redis-3.2.8.tar.gz
      ENV REDIS_DOWNLOAD_SHA1 6780d1abb66f33a97aad0edbe020403d0a15b67f
      
      # for redis-sentinel see: http://redis.io/topics/sentinel
      RUN set -ex \
        \
        && apk add --no-cache --virtual .build-deps \
            gcc \
            linux-headers \
            make \
            musl-dev \
            tar \
        \
        && wget -O redis.tar.gz "$REDIS_DOWNLOAD_URL" \
        && echo "$REDIS_DOWNLOAD_SHA1 *redis.tar.gz" | sha1sum -c - \
        && mkdir -p /usr/src/redis \
        && tar -xzf redis.tar.gz -C /usr/src/redis --strip-components=1 \
        && rm redis.tar.gz \
        \
      # Disable Redis protected mode [1] as it is unnecessary in context
      # of Docker. Ports are not automatically exposed when running inside
      # Docker, but rather explicitely by specifying -p / -P.
      # [1] https://github.com/antirez/redis/commit/edd4d555df57dc84265fdfb4ef59a4678832f6da
        && grep -q '^#define CONFIG_DEFAULT_PROTECTED_MODE 1$' /usr/src/redis/src/server.h \
        && sed -ri 's!^(#define CONFIG_DEFAULT_PROTECTED_MODE) 1$!\1 0!' /usr/src/redis/src/server.h \
        && grep -q '^#define CONFIG_DEFAULT_PROTECTED_MODE 0$' /usr/src/redis/src/server.h \
      # for future reference, we modify this directly in the source instead of just supplying a default configuration flag because apparently "if you specify any argument to redis-server, [it assumes] you are going to specify everything"
      # see also https://github.com/docker-library/redis/issues/4#issuecomment-50780840
      # (more exactly, this makes sure the default behavior of "save on SIGTERM" stays functional by default)
        \
        && make -C /usr/src/redis \
        && make -C /usr/src/redis install \
        \
        && rm -r /usr/src/redis \
        \
        && apk del .build-deps
      
      # 还是RUN指令
      RUN mkdir /data && chown redis:redis /data
      
      # 指定挂载目录
      VOLUME /data
      
      # 切换当前的目录为/data
      WORKDIR /data
      
      # 拷贝文件
      COPY docker-entrypoint.sh /usr/local/bin/
      
      ENTRYPOINT ["docker-entrypoint.sh"]
      
      # 暴露6379端口
      EXPOSE 6379
      
      # 容器启动时执行redis-server命令
      CMD [ "redis-server" ]
      

      快要闭馆了,快速借助redis托管在github的一个Dockerfile作为简单的示例。

      Alic say :****价值源于技术,贡献源于分享****

    相关文章

      网友评论

        本文标题:Dockerfile再恋笔记 | 详解篇

        本文链接:https://www.haomeiwen.com/subject/bbhrzttx.html