Docker(三)：Dockerfile 命令详解

用户静冬 發表於 2018-3-18 14:29:00

<p>上一篇文章Docker(二)：Dockerfile 使用介绍介绍了 Dockerfile 的使用，这篇文章我们来继续了解 Dockerfile ,学习 Dockerfile 各种命令的使用。</p>
<h2 id="dockerfile-指令详解">Dockerfile 指令详解</h2>
<h3 id="1-from-指定基础镜像">1 FROM 指定基础镜像</h3>
<p>FROM 指令用于指定其后构建新镜像所使用的基础镜像。FROM 指令必是 Dockerfile 文件中的首条命令，启动构建流程后，Docker 将会基于该镜像构建新镜像，FROM 后的命令也会基于这个基础镜像。</p>
<p>FROM语法格式为：</p>
<pre><code class="language-sh">FROM <image>
</code></pre>
<p>或</p>
<pre><code class="language-sh">FROM <image>:<tag>
</code></pre>
<p>或</p>
<pre><code class="language-sh">FROM <image>:<digest>
</code></pre>
<p>通过 FROM 指定的镜像，可以是任何有效的基础镜像。FROM 有以下限制：</p>
<ul>
<li>FROM 必须是 Dockerfile 中第一条非注释命令</li>
<li>在一个 Dockerfile 文件中创建多个镜像时，FROM 可以多次出现。只需在每个新命令 FROM 之前，记录提交上次的镜像 ID。</li>
<li>tag 或 digest 是可选的，如果不使用这两个值时，会使用 latest 版本的基础镜像</li>
</ul>
<h3 id="2-run-执行命令">2 RUN 执行命令</h3>
<p>在镜像的构建过程中执行特定的命令，并生成一个中间镜像。格式:</p>
<pre><code class="language-sh">#shell格式
RUN <command>
#exec格式
RUN ["executable", "param1", "param2"]
</code></pre>
<ul>
<li>RUN 命令将在当前 image 中执行任意合法命令并提交执行结果。命令执行提交后，就会自动执行 Dockerfile 中的下一个指令。</li>
<li>层级 RUN 指令和生成提交是符合 Docker 核心理念的做法。它允许像版本控制那样，在任意一个点，对 image 镜像进行定制化构建。</li>
<li>RUN 指令创建的中间镜像会被缓存，并会在下次构建中使用。如果不想使用这些缓存镜像，可以在构建时指定 <code>--no-cache</code> 参数，如：<code>docker build --no-cache</code>。</li>
</ul>
<h3 id="3-copy-复制文件">3 COPY 复制文件</h3>
<p>格式：</p>
<pre><code class="language-sh">COPY <源路径>... <目标路径>
COPY ["<源路径1>",... "<目标路径>"]
</code></pre>
<p>和 RUN 指令一样，也有两种格式，一种类似于命令行，一种类似于函数调用。COPY 指令将从构建上下文目录中 <源路径> 的文件/目录复制到新的一层的镜像内的<code><目标路径></code>位置。比如：</p>
<pre><code class="language-sh">COPY package.json /usr/src/app/
</code></pre>
<p><code><源路径></code>可以是多个，甚至可以是通配符，其通配符规则要满足 Go 的 filepath.Match 规则，如：</p>
<pre><code class="language-sh">COPY hom* /mydir/
COPY hom?.txt /mydir/
</code></pre>
<p><code><目标路径></code>可以是容器内的绝对路径，也可以是相对于工作目录的相对路径（工作目录可以用 WORKDIR 指令来指定）。目标路径不需要事先创建，如果目录不存在会在复制文件前先行创建缺失目录。</p>
<p>此外，还需要注意一点，使用 COPY 指令，源文件的各种元数据都会保留。比如读、写、执行权限、文件变更时间等。这个特性对于镜像定制很有用。特别是构建相关文件都在使用 Git 进行管理的时候。</p>
<h3 id="4-add-更高级的复制文件">4 ADD 更高级的复制文件</h3>
<p>ADD 指令和 COPY 的格式和性质基本一致。但是在 COPY 基础上增加了一些功能。比如<code><源路径></code>可以是一个 URL，这种情况下，Docker 引擎会试图去下载这个链接的文件放到<code><目标路径></code>去。</p>
<p>在构建镜像时，复制上下文中的文件到镜像内，格式：</p>
<pre><code class="language-sh">ADD <源路径>... <目标路径>
ADD ["<源路径>",... "<目标路径>"]
</code></pre>
<p><strong>注意</strong><br>
如果 docker 发现文件内容被改变，则接下来的指令都不会再使用缓存。关于复制文件时需要处理的/，基本跟正常的 copy 一致</p>
<h3 id="5-env-设置环境变量">5 ENV 设置环境变量</h3>
<p>格式有两种：</p>
<pre><code class="language-sh">ENV <key> <value>
ENV <key1>=<value1> <key2>=<value2>...
</code></pre>
<p>这个指令很简单，就是设置环境变量而已，无论是后面的其它指令，如 RUN，还是运行时的应用，都可以直接使用这里定义的环境变量。</p>
<pre><code class="language-sh">ENV VERSION=1.0 DEBUG=on \
NAME="Happy Feet"
</code></pre>
<p>这个例子中演示了如何换行，以及对含有空格的值用双引号括起来的办法，这和 Shell 下的行为是一致的。</p>
<h3 id="6-expose">6 EXPOSE</h3>
<p>为构建的镜像设置监听端口，使容器在运行时监听。格式：</p>
<pre><code class="language-sh">EXPOSE <port> [<port>...]
</code></pre>
<p>EXPOSE 指令并不会让容器监听 host 的端口，如果需要，需要在 docker run 时使用 <code>-p</code>、<code>-P</code> 参数来发布容器端口到 host 的某个端口上。</p>
<h3 id="7-volume-定义匿名卷">7 VOLUME 定义匿名卷</h3>
<p>VOLUME用于创建挂载点，即向基于所构建镜像创始的容器添加卷：</p>
<pre><code class="language-sh">VOLUME ["/data"]
</code></pre>
<p>一个卷可以存在于一个或多个容器的指定目录，该目录可以绕过联合文件系统，并具有以下功能：</p>
<ul>
<li>卷可以容器间共享和重用</li>
<li>容器并不一定要和其它容器共享卷</li>
<li>修改卷后会立即生效</li>
<li>对卷的修改不会对镜像产生影响</li>
<li>卷会一直存在，直到没有任何容器在使用它</li>
</ul>
<p>VOLUME 让我们可以将源代码、数据或其它内容添加到镜像中，而又不并提交到镜像中，并使我们可以多个容器间共享这些内容。</p>
<h3 id="8-workdir-指定工作目录">8 WORKDIR 指定工作目录</h3>
<p>WORKDIR用于在容器内设置一个工作目录：</p>
<pre><code class="language-sh">WORKDIR /path/to/workdir
</code></pre>
<p>通过WORKDIR设置工作目录后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT、ADD、COPY 等命令都会在该目录下执行。<br>
如，使用WORKDIR设置工作目录：</p>
<pre><code class="language-sh">WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
</code></pre>
<p>在以上示例中，pwd 最终将会在 <code>/a/b/c</code> 目录中执行。在使用 docker run 运行容器时，可以通过<code>-w</code>参数覆盖构建时所设置的工作目录。</p>
<h3 id="9-user-指定当前用户">9 USER 指定当前用户</h3>
<p>USER 用于指定运行镜像所使用的用户：</p>
<pre><code class="language-sh">USER daemon
</code></pre>
<p>使用USER指定用户时，可以使用用户名、UID 或 GID，或是两者的组合。以下都是合法的指定试：</p>
<pre><code class="language-sh">USER user
USER user:group
USER uid
USER uid:gid
USER user:gid
USER uid:group
</code></pre>
<p>使用USER指定用户后，Dockerfile 中其后的命令 RUN、CMD、ENTRYPOINT 都将使用该用户。镜像构建完成后，通过 docker run 运行容器时，可以通过 <code>-u</code> 参数来覆盖所指定的用户。</p>
<h3 id="10-cmd">10 CMD</h3>
<p>CMD用于指定在容器启动时所要执行的命令。CMD 有以下三种格式：</p>
<pre><code class="language-sh">CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1 param2
</code></pre>
<p>省略可执行文件的 exec 格式，这种写法使 CMD 中的参数当做 ENTRYPOINT 的默认参数，此时 ENTRYPOINT 也应该是 exec 格式，具体与 ENTRYPOINT 的组合使用，参考 ENTRYPOINT。</p>
<p><strong>注意</strong><br>
与 RUN 指令的区别：RUN 在构建的时候执行，并生成一个新的镜像，CMD 在容器运行的时候执行，在构建时不进行任何操作。</p>
<h3 id="11-entrypoint">11 ENTRYPOINT</h3>
<p>ENTRYPOINT 用于给容器配置一个可执行程序。也就是说，每次使用镜像创建容器时，通过 ENTRYPOINT 指定的程序都会被设置为默认程序。ENTRYPOINT 有以下两种形式：</p>
<pre><code class="language-sh">ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
</code></pre>
<p>ENTRYPOINT 与 CMD 非常类似，不同的是通过<code>docker run</code>执行的命令不会覆盖 ENTRYPOINT，而<code>docker run</code>命令中指定的任何参数，都会被当做参数再次传递给 ENTRYPOINT。Dockerfile 中只允许有一个 ENTRYPOINT 命令，多指定时会覆盖前面的设置，而只执行最后的 ENTRYPOINT 指令。</p>
<p><code>docker run</code>运行容器时指定的参数都会被传递给 ENTRYPOINT ，且会覆盖 CMD 命令指定的参数。如，执行<code>docker run <image> -d</code>时，-d 参数将被传递给入口点。</p>
<p>也可以通过<code>docker run --entrypoint</code>重写 ENTRYPOINT 入口点。如：可以像下面这样指定一个容器执行程序：</p>
<pre><code class="language-sh">ENTRYPOINT ["/usr/bin/nginx"]
</code></pre>
<p>完整构建代码：</p>
<pre><code class="language-sh"># Version: 0.0.3
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
</code></pre>
<p>使用docker build构建镜像，并将镜像指定为 itbilu/test：</p>
<pre><code class="language-sh">docker build -t="itbilu/test" .
</code></pre>
<p>构建完成后，使用itbilu/test启动一个容器：</p>
<pre><code class="language-sh">docker run -i -titbilu/test -g "daemon off;"
</code></pre>
<p>在运行容器时，我们使用了 <code>-g "daemon off;"</code>，这个参数将会被传递给 ENTRYPOINT，最终在容器中执行的命令为 <code>/usr/sbin/nginx -g "daemon off;"</code>。</p>
<h3 id="12-label">12 LABEL</h3>
<p>LABEL用于为镜像添加元数据，元数以键值对的形式指定：</p>
<pre><code class="language-sh">LABEL <key>=<value> <key>=<value> <key>=<value> ...
</code></pre>
<p>使用LABEL指定元数据时，一条LABEL指定可以指定一或多条元数据，指定多条元数据时不同元数据之间通过空格分隔。推荐将所有的元数据通过一条LABEL指令指定，以免生成过多的中间镜像。<br>
如，通过LABEL指定一些元数据：</p>
<pre><code class="language-sh">LABEL version="1.0" description="这是一个Web服务器" by="IT笔录"
</code></pre>
<p>指定后可以通过docker inspect查看：</p>
<pre><code class="language-sh">docker inspect itbilu/test
"Labels": {
"version": "1.0",
"description": "这是一个Web服务器",
"by": "IT笔录"
},
</code></pre>
<h3 id="13-arg">13 ARG</h3>
<p>ARG用于指定传递给构建运行时的变量：</p>
<pre><code class="language-sh">ARG <name>[=<default value>]
</code></pre>
<p>如，通过ARG指定两个变量：</p>
<pre><code class="language-sh">ARG site
ARG build_user=IT笔录
</code></pre>
<p>以上我们指定了 site 和 build_user 两个变量，其中 build_user 指定了默认值。在使用 docker build 构建镜像时，可以通过 <code>--build-arg <varname>=<value></code> 参数来指定或重设置这些变量的值。</p>
<pre><code class="language-sh">docker build --build-arg site=itiblu.com -t itbilu/test .
</code></pre>
<p>这样我们构建了 itbilu/test 镜像，其中site会被设置为 itbilu.com，由于没有指定 build_user，其值将是默认值 IT 笔录。</p>
<h3 id="14-onbuild">14 ONBUILD</h3>
<p>ONBUILD用于设置镜像触发器：</p>
<pre><code class="language-sh">ONBUILD
</code></pre>
<p>当所构建的镜像被用做其它镜像的基础镜像，该镜像中的触发器将会被钥触发。<br>
如，当镜像被使用时，可能需要做一些处理：</p>
<pre><code class="language-sh">[...]
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
[...]
</code></pre>
<h3 id="15-stopsignal">15 STOPSIGNAL</h3>
<p>STOPSIGNAL用于设置停止容器所要发送的系统调用信号：</p>
<pre><code class="language-sh">STOPSIGNAL signal
</code></pre>
<p>所使用的信号必须是内核系统调用表中的合法的值，如：SIGKILL。</p>
<h3 id="16-shell">16 SHELL</h3>
<p>SHELL用于设置执行命令（shell式）所使用的的默认 shell 类型：</p>
<pre><code class="language-sh">SHELL ["executable", "parameters"]
</code></pre>
<p>SHELL在Windows环境下比较有用，Windows 下通常会有 cmd 和 powershell 两种 shell，可能还会有 sh。这时就可以通过 SHELL 来指定所使用的 shell 类型：</p>
<pre><code class="language-sh">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
</code></pre>
<h2 id="dockerfile-使用经验">Dockerfile 使用经验</h2>
<h3 id="dockerfile-示例">Dockerfile 示例</h3>
<p><strong>构建Nginx运行环境</strong></p>
<pre><code class="language-sh"># 指定基础镜像
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"]
</code></pre>
<p><strong>构建tomcat 环境</strong></p>
<p>Dockerfile文件</p>
<pre><code class="language-sh"># 指定基于的基础镜像
FROM ubuntu:13.10

# 维护者信息
MAINTAINER zhangjiayang "zhangjiayang@sczq.com.cn"

# 镜像的指令操作
# 获取APT更新的资源列表
RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe"> /etc/apt/sources.list
# 更新软件
RUN apt-get update

# Install curl
RUN apt-get -y install curl

# Install JDK 7
RUN cd /tmp &&curl -L 'http://download.oracle.com/otn-pub/java/jdk/7u65-b17/jdk-7u65-linux-x64.tar.gz' -H 'Cookie: oraclelicense=accept-securebackup-cookie; gpw_e24=Dockerfile' | tar -xz
RUN mkdir -p /usr/lib/jvm
RUN mv /tmp/jdk1.7.0_65/ /usr/lib/jvm/java-7-oracle/

# Set Oracle JDK 7 as default Java
RUN update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-7-oracle/bin/java 300
RUN update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-7-oracle/bin/javac 300

# 设置系统环境
ENV JAVA_HOME /usr/lib/jvm/java-7-oracle/

# Install tomcat7
RUN cd /tmp && curl -L 'http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.8/bin/apache-tomcat-7.0.8.tar.gz' | tar -xz
RUN mv /tmp/apache-tomcat-7.0.8/ /opt/tomcat7/

ENV CATALINA_HOME /opt/tomcat7
ENV PATH $PATH:$CATALINA_HOME/bin

# 复件tomcat7.sh到容器中的目录
ADD tomcat7.sh /etc/init.d/tomcat7
RUN chmod 755 /etc/init.d/tomcat7

# Expose ports.指定暴露的端口
EXPOSE 8080

# Define default command.
ENTRYPOINT service tomcat7 start && tail -f /opt/tomcat7/logs/catalina.out
</code></pre>
<p><code>tomcat7.sh</code>命令文件</p>
<pre><code class="language-sh">export JAVA_HOME=/usr/lib/jvm/java-7-oracle/
export TOMCAT_HOME=/opt/tomcat7

case $1 in
start)
sh $TOMCAT_HOME/bin/startup.sh
;;
stop)
sh $TOMCAT_HOME/bin/shutdown.sh
;;
restart)
sh $TOMCAT_HOME/bin/shutdown.sh
sh $TOMCAT_HOME/bin/startup.sh
;;
esac
exit 0
</code></pre>
<h3 id="原则与建议">原则与建议</h3>
<ul>
<li>容器轻量化。从镜像中产生的容器应该尽量轻量化，能在足够短的时间内停止、销毁、重新生成并替换原来的容器。</li>
<li>使用 <code>.gitignore</code>。在大部分情况下，Dockerfile 会和构建所需的文件放在同一个目录中，为了提高构建的性能，应该使用 <code>.gitignore</code> 来过滤掉不需要的文件和目录。</li>
<li>为了减少镜像的大小，减少依赖，仅安装需要的软件包。</li>
<li>一个容器只做一件事。解耦复杂的应用，分成多个容器，而不是所有东西都放在一个容器内运行。如一个 Python Web 应用，可能需要 Server、DB、Cache、MQ、Log 等几个容器。一个更加极端的说法：One process per container。</li>
<li>减少镜像的图层。不要多个 Label、ENV 等标签。</li>
<li>对续行的参数按照字母表排序，特别是使用<code>apt-get install -y</code>安装包的时候。</li>
<li>使用构建缓存。如果不想使用缓存，可以在构建的时候使用参数<code>--no-cache=true</code>来强制重新生成中间镜像。</li>
</ul>
<h2 id="参考">参考</h2>
<p>Dockerfile reference<br>
使用Dockerfile构建Docker镜像<br>
Docker镜像构建文件Dockerfile及相关命令介绍<br>
深入Dockerfile（一）: 语法指南<br>
Docker — 从入门到实践</p>

</div>
<div id="MySignature" role="contentinfo">
<div>
   <p style="border-top: #e0e0e0 1px dashed; border-right: #e0e0e0 1px dashed; border-bottom: #e0e0e0 1px dashed; border-left: #e0e0e0 1px dashed; padding-top: 5px; padding-right: 10px; padding-bottom: 10px; padding-left: 150px; background: url("https://images.cnblogs.com/cnblogs_com/ityouknow/914073/o_keep.jpg") #e5f1f4 no-repeat 1% 50%; font-family: 微软雅黑; font-size: 11px" id="PSignature">
         <br>
         作者：<span style="font-weight: bold; font-size: large">纯洁的微笑</span>
         <br>
         出处：www.ityouknow.com
         <br>
         资源：微信搜<strong>【纯洁的微笑】</strong>关注我，回复 <strong>【程序员】【面试】【架构师】</strong>有我准备的一线程序必备计算机书籍、大厂面试资料和免费电子书。 <strong>一共1024G的资料，希望可以帮助大家提升技术和能力。</strong>
         <br>
         <br>
         <span style="font-size: large; color: #F00; display: none">
         本文如对您有帮助，还请多帮【推荐】下此文。
</span><br>
         <span style="font-size: large; color: #F00">点我了解：Cxy521-程序员一站式导航网站
   </span>
      <br>
   </p>
</div><br><br>
来源：https://www.cnblogs.com/ityouknow/p/8595384.html

頁: [1]

琼殿技术论坛's Archiver

Docker(三)：Dockerfile 命令详解