Docker(三)：Dockerfile命令大全

Dockerfile 指令详解

1. FROM指定基础镜像

FROM 指令用于指定其后构建新镜像所使用的基础镜像。FROM 指令必是 Dockerfile 文件中的首条命令，启动构建流程后，Docker 将会基于该镜像构建新镜像，FROM 后的命令也会基于这个基础镜像。

FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>

 

2.RUN执行命令

在镜像的构建过程当中执行特定的命令，并生成一个中间镜像。

RUN 指令建立的中间镜像会被缓存，并会在下次构建中使用。若是不想使用这些缓存镜像，能够在构建时指定 --no-cache 参数，如：docker build --no-cache。

#shell格式
RUN <command>
#exec格式
RUN ["executable", "param1", "param2"]

 

3.COPY复制文件

和 RUN 指令同样，也有两种格式，一种相似于命令行，一种相似于函数调用。COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的<目标路径>位置；

<源路径>能够是多个，甚至能够是通配符，其通配符规则要知足 Go 的 filepath.Match 规则；

COPY 指令，源文件的各类元数据都会保留。好比读、写、执行权限、文件变动时间等。

COPY package.json /usr/src/app/

COPY hom* /mydir/
COPY hom?.txt /mydir/

 

4.ADD高级文件复制

ADD 指令和 COPY 的格式和性质基本一致。可是在 COPY 基础上增长了一些功能。好比<源路径>能够是一个 URL，这种状况下，Docker 引擎会试图去下载这个连接的文件放到<目标路径>去。

ADD <源路径>... <目标路径>
ADD ["<源路径>",... "<目标路径>"]

 

5.ENV设置环境变量

ENV VERSION=1.0 DEBUG=on \
    NAME="Happy Feet"

 

6.EXPOSE

为构建的镜像设置监听端口，使容器在运行时监听

EXPOSE <port> [<port>...]

 

7.VOLUME定义匿名卷

VOLUME用于建立挂载点，即向基于所构建镜像创始的容器添加卷：

VOLUME ["/data"]

一个卷能够存在于一个或多个容器的指定目录，该目录能够绕过联合文件系统，并具备如下功能：

• 卷能够容器间共享和重用
• 容器并不必定要和其它容器共享卷
• 修改卷后会当即生效
• 对卷的修改不会对镜像产生影响
• 卷会一直存在，直到没有任何容器在使用它

VOLUME 让咱们能够将源代码、数据或其它内容添加到镜像中，而又不并提交到镜像中，并使咱们能够多个容器间共享这些内容。

8.WORKDIR指定工做目录

WORKDIR用于在容器内设置一个工做目录。

经过WORKDIR设置工做目录后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT、ADD、COPY 等命令都会在该目录下执行。

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

在以上示例中，pwd 最终将会在 /a/b/c 目录中执行。在使用 docker run 运行容器时，能够经过-w参数覆盖构建时所设置的工做目录。

9.USER指定当前用户

USER user
USER user:group
USER uid
USER uid:gid
USER user:gid
USER uid:group

使用USER指定用户后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT 都将使用该用户。镜像构建完成后，经过 docker run 运行容器时，能够经过 -u 参数来覆盖所指定的用户。

10.CMD

CMD用于指定在容器启动时所要执行的命令。CMD 有如下三种格式：

CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1 param2

 

省略可执行文件的 exec 格式，这种写法使 CMD 中的参数当作 ENTRYPOINT 的默认参数，此时 ENTRYPOINT 也应该是 exec 格式

11.ENTRYPOINT

ENTRYPOINT 用于给容器配置一个可执行程序。也就是说，每次使用镜像建立容器时，经过 ENTRYPOINT 指定的程序都会被设置为默认程序。

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

 

ENTRYPOINT 与 CMD 很是相似，不一样的是经过docker run执行的命令不会覆盖 ENTRYPOINT，而docker run命令中指定的任何参数，都会被当作参数再次传递给 ENTRYPOINT。Dockerfile 中只容许有一个 ENTRYPOINT 命令，多指定时会覆盖前面的设置，而只执行最后的 ENTRYPOINT 指令。

FROM ubuntu:16.04
MAINTAINER 何民三 "cn.liuht@gmail.com"
RUN apt-get update
RUN apt-get install -y nginx
RUN echo 'Hello World, 我是个容器' \ 
   > /var/www/html/index.html
ENTRYPOINT ["/usr/sbin/nginx"]
EXPOSE 80



docker build -t="itbilu/test" .
docker run -i -t itbilu/test -g "daemon off;"

 

在运行容器时，咱们使用了 -g "daemon off;"，这个参数将会被传递给 ENTRYPOINT，最终在容器中执行的命令为 /usr/sbin/nginx -g "daemon off;"。

12.LABEL

LABEL用于为镜像添加元数据，一条LABEL指定能够指定一或多条元数据，指定多条元数据时不一样元数据之间经过空格分隔。

推荐将全部的元数据经过一条LABEL指令指定，以避免生成过多的中间镜像。

LABEL version="1.0" description="这是一个Web服务器" by="IT笔录"

 

13.ARG

ARG用于指定传递给构建运行时的变量

ARG site
ARG build_user=IT笔录

 

以上咱们指定了 site 和 build_user 两个变量，其中 build_user 指定了默认值。在使用 docker build 构建镜像时，能够经过 --build-arg <varname>=<value> 参数来指定或重设置这些变量的值

docker build --build-arg site=itiblu.com -t itbilu/test .

 

构建了 itbilu/test 镜像，其中site会被设置为 itbilu.com，因为没有指定 build_user，其值将是默认值 IT 笔录。

14.ONBUILD设置镜像触发器

当所构建的镜像被用作其它镜像的基础镜像，该镜像中的触发器将会被钥触发。

ONBUILD [INSTRUCTION]
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src

 

15.STOPSIGNAL

STOPSIGNAL用于设置中止容器所要发送的系统调用信号,

STOPSIGNAL signal

所使用的信号必须是内核系统调用表中的合法的值，如：SIGKILL。

16.SHELL

SHELL用于设置执行命令（shell式）所使用的的默认 shell 类型：

FROM microsoft/windowsservercore

# Executed as cmd /S /C echo default
RUN echo default

# Executed as cmd /S /C powershell -command Write-Host default
RUN powershell -command Write-Host default

# Executed as powershell -command Write-Host hello
SHELL ["powershell", "-command"]
RUN Write-Host hello

# Executed as cmd /S /C echo hello
SHELL ["cmd", "/S"", "/C"]
RUN echo hello

 

示例

# 指定基础镜像
FROM sameersbn/ubuntu:14.04.20161014

# 维护者信息
MAINTAINER sameer@damagehead.com

# 设置环境
ENV RTMP_VERSION=1.1.10 \
    NPS_VERSION=1.11.33.4 \
    LIBAV_VERSION=11.8 \
    NGINX_VERSION=1.10.1 \
    NGINX_USER=www-data \
    NGINX_SITECONF_DIR=/etc/nginx/sites-enabled \
    NGINX_LOG_DIR=/var/log/nginx \
    NGINX_TEMP_DIR=/var/lib/nginx \
    NGINX_SETUP_DIR=/var/cache/nginx

# 设置构建时变量，镜像创建完成后就失效
ARG BUILD_LIBAV=false
ARG WITH_DEBUG=false
ARG WITH_PAGESPEED=true
ARG WITH_RTMP=true

# 复制本地文件到容器目录中
COPY setup/ ${NGINX_SETUP_DIR}/
RUN bash ${NGINX_SETUP_DIR}/install.sh

# 复制本地配置文件到容器目录中
COPY nginx.conf /etc/nginx/nginx.conf
COPY entrypoint.sh /sbin/entrypoint.sh

# 运行指令
RUN chmod 755 /sbin/entrypoint.sh

# 容许指定的端口
EXPOSE 80/tcp 443/tcp 1935/tcp

# 指定网站目录挂载点
VOLUME ["${NGINX_SITECONF_DIR}"]

ENTRYPOINT ["/sbin/entrypoint.sh"]
CMD ["/usr/sbin/nginx"]

 

TIPS

• 容器轻量化。从镜像中产生的容器应该尽可能轻量化，能在足够短的时间内中止、销毁、从新生成并替换原来的容器。
• 使用 .gitignore。在大部分状况下，Dockerfile 会和构建所需的文件放在同一个目录中，为了提升构建的性能，应该使用 .gitignore 来过滤掉不须要的文件和目录。
• 为了减小镜像的大小，减小依赖，仅安装须要的软件包。
• 一个容器只作一件事。解耦复杂的应用，分红多个容器，而不是全部东西都放在一个容器内运行。如一个 Python Web 应用，可能须要 Server、DB、Cache、MQ、Log 等几个容器。一个更加极端的说法：One process per container。
• 减小镜像的图层。不要多个 Label、ENV 等标签。
• 对续行的参数按照字母表排序，特别是使用apt-get install -y安装包的时候。
• 使用构建缓存。若是不想使用缓存，能够在构建的时候使用参数--no-cache=true来强制从新生成中间镜像。