Dockerfile 常见指令的意义/常见的使用方式/使用示例/

一.什么是 Dockerfile ?
    Dockerfile 就是生成docker镜像的指令集, 通过使用docker工具执行这些指令集可以方便快捷地生成镜像, 并且能不断复用
    Dockerfile 指令名称 必须大写

二.如下是官方文档的 Dockerfile 示例

    # 将官方 Python 镜像 用作基础镜像
    FROM python:2.7-slim

    # 将工作目录设置为 /app
    WORKDIR /app

    # 将当前目录内容复制到容器的 /app目录下
    ADD . /app

    # 安装 requirements.txt 中指定的任何所需软件包
    RUN pip install -r requirements.txt

    # 使端口 80 可供此容器外的环境使用
    EXPOSE 80

    # 定义环境变量
    ENV NAME World

    # 在容器启动时运行 app.py
    CMD ["python", "app.py"]

三. dockerfile 的主要指令

    FROM：FROM <image>, 完整的写法是 FROM username/respority:tag  和进行docker push 的名称一致
        FROM指定构建镜像的基础源镜像，如果本地没有指定的镜像，则会自动从 Docker 的公共库 pull 镜像下来。
        FROM必须是 Dockerfile 中非注释行的第一个指令，即一个 Dockerfile 从FROM语句开始。
        FROM可以在一个 Dockerfile 中出现多次，如果有需求在一个 Dockerfile 中创建多个镜像。
        如果FROM语句没有指定镜像tag(标签)，则默认使用latest标签。

    RUN：RUN execute param1 param2；如：RUN echo far >foo
        每条RUN指令将在当前镜像基础上执行指定命令，并提交为新的镜像，
        后续的RUN都在之前RUN提交后的镜像为基础
        镜像是分层的，可以通过一个镜像的任何一个历史提交点来创建，类似源码的版本控制。

    CMD：CMD command param1 param2；如：CMD ["/usr/sbin/nginx", "-c", "/etc/nginx/nginx.conf"]
        CMD指定在 Dockerfile 中只能使用一次，如果有多个，则只有最后一个会生效。
        CMD的目的是为了在启动容器时提供一个默认的命令执行选项。如果用户启动容器时指定了运行的命令，则会覆盖掉CMD指定的命令。
        CMD和RUN的区别：CMD会在启动容器的时候执行，构建镜像时不执行，而RUN只是在构建镜像的时候执行，后续镜像构建完成之后，启动容器就与RUN无关了

    EXPOSE：EXPOSE <port>；如：EXPOSE 80
        告诉docker服务该容器对外暴露的端口，在docker run时需要使用-p参数才生效。

    ENV：ENV <key> <value> 这种方式只能设置一个变量
        ENV <key>=<values> <key1>=<values1> .....这种方式能够设置多个变量
        指定环境变量

    ADD：ADD <src> <dst>；如：ADD /usr/index.html /usr/www/html
        ADD是将本地的文件，目录或远程文件URL添加到容器的指定路径中。
        dst目的路径必须是绝对路径，如果 不存在，会自动创建对应目录
        src源路径必须是 Dockerfile 所在路径的相对路径
        如果是一个目录，只会复制目录下的内容，而目录本身则不会被复制

    COPY：COPY <src> <dst> 和ADD的用法类似

    ENTRYPOINT: command param1 param2；如：ENTRYPOINT "/usr/sbin/nginx -c /etc/nginx/nginx.conf"
        功能和CMD一样，但是配置容器启动后执行的命令，ENTRYPOINT命令并且不可被 docker run 提供的参数覆盖，而CMD是可以被覆盖的。如果需要覆盖，则可以使用docker run --entrypoint选项。

    VOLUME：VOLUME ["/data"]；如：VOLUME ["/data_1", "/data_2"]
        创建可挂载的目录, 可以创建多个. 注意: 这里指定的是容器内的目录

    USER：USER daemon；如：USER root
        指定容器运行时的的用户名和UID，后续的RUN，CMDENTRYPOINT也会使用指定用户

    WORKDIR：WORKDIR /path/to/workdir
        为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。可以使用多个WORKDIR指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径。
        例如：WORKDIR /a
        WORKDIR b
        WORKDIR c
        RUN pwd最终路径是/a/b/c。

    MAINTAINER
        指定作者
        语法：
        MAINTAINER <name>

四.执行 dockerfile 的指令集,生成镜像

    1.创建一个空目录, 可以是任意名称

    2.进入该目录, 创建文件Dockerfile, 将指令写入该 Dockerfile 文件
    3.生成镜像:
        docker build -t [生成的镜像名称] . 

        如:

            docker build -t nginx . 

        注意, 不要漏掉 ".", 表明是在当前目录下寻找 Dockerfile

以下为本人创建 redis 镜像的一个 Dockerfile, 目前仅使用于开发环境中:

FROM    lowmanisbusy/base_container:v2

# 应该新建一个 普通用户 用以专门启动redis, 而不是使用root用户
USER    root

# 设置环境变量, 否则会卡在时区选择步骤
ENV     DEBIAN_FRONTEND=noninteractive

WORKDIR /

# 需要保证基础镜像中已安装 wget 工具
RUN     wget http://download.redis.io/releases/redis-4.0.11.tar.gz

RUN     tar -zxvf redis-4.0.11.tar.gz

RUN     mv redis-4.0.11 redis/

RUN     rm  redis-4.0.11.tar.gz

# 连续执行 WORKDIR 指令, 如果不是绝对路径, 则为叠加操作
WORKDIR ./redis

RUN     echo 'y' | apt install build-essential tcl

RUN     make

RUN     make test

RUN     make install

# 通过 VOLUME 指令创建的挂载点，无法指定主机上对应的目录, 如果docker run 不指定, 则由docker进行默认指派(dockerfile指明的是容器内的目录)
# 可以挂载多个目录, 可以在 docker run 时候 指定主机目录
VOLUME  ["/redis/data", "/data"]

#       本地相对目录   必须是docker的绝对目录    将提前配置好的redis配置文件添加到需要制作的镜像内
ADD     ./redis.conf /redis/redis.conf

RUN     touch /redis/data/redis.log

# 向外暴露的端口, 在 docker run -p ****:6379 指定主机端口(host)
EXPOSE  6379

# 在启动容器内的应用时, 需要执行多条指令(启动redis的指令及对内核参数做了一些修改), 所以这里制作了一个脚本, 将所有指令封装在脚本内, 赋予执行权限, CMD 指令中指明运行该脚本
ADD     ./up_redis.sh /redis/up_redis.sh

RUN     chmod 777 up_redis.sh

# 因为使用docker运行redis, 需要在配置文件中进行以下几个步骤
# 1.取消绑定ip(使用了host), 或者 bind 0.0.0.0
# 2.protected-mode 修改为no, 否则 requirepass 加上密码
# 3.daemonize no, 注意!!!!!: 必须要指明为非后台运行, 否则 CMD 中无法正常启动应用(不要在 CMD 中使用 &指令)
# 4.以上要求操作, 在当前目录下的 redis.conf 已完成, 认证密码为 123456 , 可根据需要修改
# 如果需要以运行脚本的方式启动应用: 需要指定解释器
# 运行容器的定制参数需要加上 --privileged, 因为脚本中需要修改一些内核参数: docker run -it -d -p 9527:6379 --privileged --name redis redis
# 如果 docker run 时又指明了 shell 指令, 将会覆盖 CMD 的指令, 如: docker run --name redis redis /bin/bash
CMD     ["/bin/bash", "/redis/up_redis.sh"]

运行 Dockerfile , 生成docker镜像, 再使用 docker  run 启动容器. 如果需要在本机根据 镜像 或者 Dockerfile , 快捷的进行容器的编排, 可使用 docker-compose, docker 三剑客之一.