官方文档 https://docs.docker.com/engine/reference/commandline/run/

最佳实践 https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

指令速查

  • FROM
  • RUN
  • CMD
  • LABEL
  • MAINTAINER
  • ENV
  • ADD
  • COPY
  • ENTRPOINT
  • VOLUME
  • USE
  • WORKDIR

指令详解

  1. FROM

    FROM ubuntu:14.04

    FROM指定构建镜像的基础源镜像，如果本地没有指定就会尝试下载。

  2. RUN

    RUN set -eux; echo '<h1>Hello, Docker!</h1>' > /usr/share/nginx/html/index.html

    具体执行的命令/bin/sh -c echo '<h1>Hello, Docker!</h1>' > /usr/share/nginx/html/index.html

  3. CMD

    CMD ["可执行文件","参数1","参数2"] (exec 格式, 推荐的格式)

    CMD command param1 param2 (shell 格式)

    CMD指令在Dockerfile中只能使用一次，如果有多个，则只有最后一个会生效。

    CMD的目的是为了在启动容器时提供一个默认的命令执行选项。如果用户启动容器时指定了运行的命令，则会覆盖掉CMD指定的命令。

    • shell 格式 会始终调用一个 shell 进程， 成为 /bin/sh -c 的子命令， 可执行程序不能响应 Unix 信号。
    • exec 格式，推荐这种格式。使用这种模式时， 可以不需要 shell 进程。 让 Docker 应用的可执行程序成为容器的 PID 1 进程，可以接收 Unix 信号。比如执行 docker stop 时能够接收到 SIGTERM。

  4. LABEL

    LABEL <key>=<value> <key>=<value> <key>=<value> ...

    用于为镜像添加元数据，元数以键值对的形式指定

  5. MAINTAINER

    MAINTAINER Leslie Qi "qikang451@qq.com"

    指定创建镜像的用户

  6. EXPOSE

    EXPOSE 80

    EXPOSE 8080

    告诉 Docker 服务端容器对外映射的本地端口，需要在 docker run 的时候使用-p或者-P选项生效。

  7. ENV

    只能设置一个变量: ENV <key> <value>

    允许一次设置多个变量: ENV <key1>=<value2> <key2>=<value2> ...

    docker run -e “WEB_RORT=8080” 运行时设置环境变量。

  8. ADD

    adds “test” to WORKDIR/: DD test relativeDir/

    adds “test” to /absoluteDir/: ADD test /absoluteDir/

    ADD在复制源是压缩文件的时，可把解压后的文件复制至目标路径。

    • dest路径是绝对路径，如果不存在，会自动创建对应目录
    • src的相对路径必须是 Dockerfile 所在路径的相对路径
    • src如果是一个目录，只会复制目录下的内容，而目录本身则不会被复制

  9. COPY

    COPY <src>... <dest>

    复制源可以文件或通配符，目标路径可以是容器的绝对路径，也可以是相对工作目录的相对路径。 使用copy指令，源文件的各种元数据都会保留。比如读、写、执行权限、文件变更时间等。ADD和COPY类似，但COPY不能使用远程文件 URLS ，复制文件推荐使用COPY。

    dest路径是绝对路径，如果不存在，会自动创建对应目录

    src的相对路径必须是 Dockerfile 所在路径的相对路径

    src如果是一个目录，只会复制目录下的内容，而目录本身则不会被复制

  10. ENTRYPOINT

    ENTRYPOINT ["executable", "param1", "param2"] (exec 格式, 推荐的格式)

    ENTRYPOINT command param1 param2 (shell 格式)

    CMD 和 ENTRYPOINT 的区别：

    • 在 Dockerfile 中， 应该至少指定一个 CMD 或 ENTRYPOINT；
    • shell 格式 会始终调用一个 shell 进程， 成为 /bin/sh -c 的子命令， 可执行程序不能响应 Unix 信号。
    • exec 格式，推荐这种格式。使用这种模式时， 可以不需要 shell 进程。 让 Docker 应用的可执行程序成为容器的 PID 1 进程，可以接收 Unix 信号。比如执行 docker stop 时能够接收到 SIGTERM。
    • 将 Docker 当作可执行程序时， 应该使用 ENTRYPOINT 进行配置；
    • CMD 可以用作 ENTRYPOINT 默认参数， 或者用作 Docker 的默认命令；
    • CMD 可以被 docker run 传入的参数覆盖；
    • docker run 传入的参数会附加到 ENTRYPOINT 之后， 前提是使用了 exec 格式 。

  11. VOLUME

    VOLUME ["<路径1>","<路径2>"...]

    挂载宿主机目录到容器内

    在 docker run 时可以用 -v /mydata:/data 覆盖 Dockerfile 中的设置。

  12. USER

    USER <用户名：组名>

    USER nginx:nginx

    指定运行容器时的用户名或 UID

  13. WORKDIR

    WORKDIR <工作目录路径>

    WORKDIR /path/to/workdir

    WORKDIR指令用来指定在docker run 时运行的目录，ENTRYPOINT 和 / 或 CMD指定的程序会在这个目录下执行。

    docker run -w 可以覆盖WORKDIR。