Test Code

Dockerfile 介绍

2020-04-09

官方文档 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 格式)

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

    CMD 和 ENTRYPOINT 的区别:

    • 将 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。

Tags: docker
使用支付宝打赏
使用微信打赏

若你觉得我的文章对你有帮助,欢迎点击上方按钮对我打赏

扫描二维码,分享此文章