前言
今晚整理整理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 :****价值源于技术，贡献源于分享****