Dockerfile指令详解

Dockerfile指令详解

FROM

FROM [--platform=<platform>] <image> [AS <name>]

要么

FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]

要么

FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

该

FROM

Dockerfile

FROM

• ARG

  是先于仅指示

  FROM

  在

  Dockerfile

  。请参阅了解ARG和FROM之间的相互作用。

• FROM

  可以一次出现多次

  Dockerfile

  以创建多个映像，也可以将一个构建阶段作为对另一个构建阶段的依赖。只需在每个新

  FROM

  指令之前记录一次提交输出的最后一个图像ID 。每个

  FROM

  指令清除由先前指令创建的任何状态。
• 可选的名称可以通过添加给予一个新的构建阶段

  AS name

  的

  FROM

  指令。该名称可以在后续版本

  FROM

  和

  COPY --from=

  说明中使用，以引用此阶段中构建的映像。
• 该

  tag

  或

  digest

  值是可选的。如果您忽略其中任何一个

  latest

  ，那么缺省情况下构建器将采用标签。如果构建器找不到该

  tag

  值，则返回错误。

--platform

FROM

linux/amd64

linux/arm64

windows/amd64

--platform=$BUILDPLATFORM

了解ARG和FROM之间的交互方式

FROM

ARG

FROM

ARG  CODE_VERSION=latest
FROM base:${CODE_VERSION}
CMD  /code/run-app

FROM extras:${CODE_VERSION}
CMD  /code/run-extras

ARG

FROM

FROM

ARG

FROM

ARG

ARG VERSION=latest
FROM busybox:$VERSION
ARG VERSION
RUN echo $VERSION > image_version

RUN

RUN有2种形式：

• RUN

  （shell形式，命令在shell中运行，默认情况下

  /bin/sh -c

  在Linux或

  cmd /S /C

  Windows 上运行）

• RUN ["executable", "param1", "param2"]

  （执行表格）

该

RUN

Dockerfile

分层

RUN

在EXEC形式使得能够避免壳串改写（munging），并

RUN

可以使用以下 命令更改shell形式的默认shell

SHELL

在shell形式中，可以使用

\

RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'

它们在一起等效于以下这一行：

RUN /bin/bash -c 'source $HOME/.bashrc; echo $HOME'

注意：要使用’/ bin / sh’以外的其他shell，请使用exec形式传入所需的shell。例如，

RUN ["/bin/bash", "-c", "echo hello"]

注意：exec表单被解析为JSON数组，这意味着您必须在单词而非单引号（’）周围使用双引号（“）。

注意：与shell表单不同，exec表单不会调用命令shell。这意味着不会进行常规的外壳处理。例如，

RUN [ "echo", "$HOME" ]

将不会对进行变量替换

$HOME

。如果要进行shell处理，则可以使用shell形式或直接执行shell，例如：

RUN [ "sh", "-c", "echo $HOME" ]

。当使用exec表单并直接执行shell时（例如在shell表单中），是由shell进行环境变量扩展，而不是docker。

注意：在JSON格式中，必须转义反斜杠。这在Windows中特别有用，在Windows中反斜杠是路径分隔符。否则，由于无效的JSON，以下行将被视为shell形式，并且会以意外的方式失败：

RUN ["c:\windows\system32\tasklist.exe"]

此示例的正确语法为：

RUN ["c:\\windows\\system32\\tasklist.exe"]

RUN

RUN apt-get dist-upgrade -y

RUN

--no-cache

docker build --no-cache

有关更多信息，请参见

Dockerfile

RUN

ADD

已知问题

• 问题783是有关使用AUFS文件系统时可能发生的文件权限问题。例如，您在尝试

  rm

  文件过程中可能会注意到它。

  对于具有最新aufs版本的系统（即，

  dirperm1

  可以设置安装选项），docker将尝试通过使用options挂载层来尝试自动修复问题

  dirperm1

  。有关

  dirperm1

  选项的更多详细信息，请参见

  aufs

  手册页

  如果您的系统不支持

  dirperm1

  ，则该问题描述了一种解决方法。

CMD

该

CMD

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

  （exec形式，这是首选形式）

• CMD ["param1","param2"]

  （作为ENTRYPOINT的默认参数）

• CMD command param1 param2

  （外壳形式）

CMD

Dockerfile

CMD

CMD

**a的主要目的

CMD

ENTRYPOINT

注意：如果

CMD

用于提供

ENTRYPOINT

指令的默认参数，则

CMD

和

ENTRYPOINT

指令均应使用JSON数组格式指定。

注意：exec表单被解析为JSON数组，这意味着您必须在单词而非单引号（’）周围使用双引号（“）。

注意：与shell表单不同，exec表单不会调用命令shell。这意味着不会进行常规的外壳处理。例如，

CMD [ "echo", "$HOME" ]

将不会对进行变量替换

$HOME

。如果要进行shell处理，则可以使用shell形式或直接执行shell，例如：

CMD [ "sh", "-c", "echo $HOME" ]

。当使用exec表单并直接执行shell时（例如在shell表单中），是由shell进行环境变量扩展，而不是docker。

当以shell或exec格式使用时，该

CMD

如果您使用的shell形式

CMD

/bin/sh -c

FROM ubuntu
CMD echo "This is a test." | wc -

如果要在 `` **没有外壳的情况下****运行，**则必须将命令表示为JSON数组，并提供可执行文件的完整路径。 **此数组形式是的首选格式

CMD

FROM ubuntu
CMD ["/usr/bin/wc","--help"]

如果您希望容器每次都运行相同的可执行文件，则应考虑

ENTRYPOINT

CMD

如果用户指定的参数，

docker run

CMD

注意：请勿

RUN

与混淆

CMD

。

RUN

实际上运行命令并提交结果；

CMD

在生成时不执行任何操作，但指定映像的预期命令。

LABEL

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

该

LABEL

LABEL

LABEL

LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."

一幅图像可以有多个标签。您可以在一行上指定多个标签。在Docker 1.10之前的版本中，这减小了最终映像的大小，但是情况不再如此。您仍然可以通过以下两种方式之一选择在一条指令中指定多个标签：

LABEL multi.label1="value1" multi.label2="value2" other="value3"
LABEL multi.label1="value1" \
multi.label2="value2" \
other="value3"

基本或父图像（行中的图像

FROM

要查看图像的标签，请使用

docker inspect

"Labels": {
"com.example.vendor": "ACME Incorporated"
"com.example.label-with-value": "foo",
"version": "1.0",
"description": "This text illustrates that label-values can span multiple lines.",
"multi.label1": "value1",
"multi.label2": "value2",
"other": "value3"
},

EXPOSE

EXPOSE <port> [<port>/<protocol>...]

该

EXPOSE

该

EXPOSE

-p

docker run

-P

默认情况下，

EXPOSE

EXPOSE 80/udp

要同时在TCP和UDP上公开，请包括以下两行：

EXPOSE 80/tcp
EXPOSE 80/udp

在这种情况下，如果

-P

docker run

-P

无论

EXPOSE

-p

docker run -p 80:80/tcp -p 80:80/udp ...

要在主机系统上设置端口重定向，请参阅使用-P标志。该

docker network

ENV

ENV <key> <value>
ENV <key>=<value> ...

该

ENV

设置为value

该

ENV

ENV

第二种形式

ENV = ...

例如：

ENV myName="John Doe" myDog=Rex\ The\ Dog \
myCat=fluffy

和

ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy

将在最终图像中产生相同的净结果。

ENV

docker inspect

docker run --env =

注意：环境持久性可能导致意外的副作用。例如，设置

ENV DEBIAN_FRONTEND noninteractive

可能会使基于Debian的映像上的apt-get用户感到困惑。要为单个命令设置值，请使用

RUN =

。

ADD

ADD有两种形式：

• ADD [--chown=:] ...

• ADD [--chown=:] ["",... ""]

  （此格式对于包含空格的路径是必需的）

注意：此

--chown

功能仅在用于构建Linux容器的Dockerfiles上受支持，而在Windows容器上不起作用。由于用户和组所有权概念不会在Linux和Windows之间转换，因此使用

/etc/passwd

和

/etc/group

将用户名和组名转换为ID的使用限制了此功能仅对基于Linux OS的容器可用。

该

ADD

，并将它们添加到路径中映像的文件系统中

``可以指定多个资源，但是如果它们是文件或目录，则将其路径解释为相对于构建上下文源的路径。

每个都``可能包含通配符，并且匹配将使用Go的 filepath.Match规则完成。例如：

ADD hom* /mydir/        # adds all files starting with "hom"
ADD hom?.txt /mydir/    # ? is replaced with any single character, e.g., "home.txt"

的``是一个绝对路径，或相对于一个路径

WORKDIR

ADD test relativeDir/          # adds "test" to `WORKDIR`/relativeDir/
ADD test /absoluteDir/         # adds "test" to /absoluteDir/

添加包含特殊字符（例如

[

]

arr[0].txt

ADD arr[[]0].txt /mydir/    # copy a file named "arr[0].txt" to /mydir/

除非可选

--chown

--chown

/etc/passwd

/etc/group

--chown

ADD --chown=55:mygroup files* /somedir/
ADD --chown=bin files* /somedir/
ADD --chown=1 files* /somedir/
ADD --chown=10:11 files* /somedir/

如果容器根文件系统不包含

/etc/passwd

/etc/group

--chown

ADD

如果``是远程文件URL，则目标将具有600的权限。如果正在检索的远程文件具有HTTP

Last-Modified

mtime

ADD

mtime

注意：如果通过传递

Dockerfile

STDIN（

docker build - < somefile

）进行构建，则没有构建上下文，因此

Dockerfile

只能包含基于URL的

ADD

指令。您还可以通过STDIN：（

docker build - < archive.tar.gz

）传递压缩的归档文件，归档文件

Dockerfile

根目录中的，归档文件的其余部分将用作构建的上下文。

注意：如果您的URL文件受身份验证保护，则您将需要使用

RUN wget

，

RUN curl

或从容器中使用其他工具，因为该

ADD

指令不支持身份验证。

注意：

ADD

如果Dockerfile中的内容``已更改，则第一个遇到的指令将使Dockerfile中所有后续指令的缓存无效。这包括使高速缓存中的

RUN

指令无效。有关更多信息，请参见

Dockerfile

最佳实践指南。

ADD

• 该``路径必须是内部语境的构建; 您不能这样做

  ADD ../something /something

  ，因为a的第一步

  docker build

  是将上下文目录（和子目录）发送到docker守护程序。
• 如果

  是URL，

  并且不以斜杠结尾，则从URL下载文件并将其复制到``。
• 如果

  是URL并

  以斜杠结尾，则从URL推断文件名，然后将文件下载到

  /

  。例如，

  ADD http://example.com/foobar /

  将创建文件

  /foobar

  。该URL必须具有非平凡的路径，以便在这种情况下可以发现适当的文件名（

  http://example.com

  将不起作用）。
• 如果``是目录，则将复制目录的整个内容，包括文件系统元数据。

注意：目录本身不会被复制，只是其内容被复制。

• 如果``是以公认的压缩格式（身份，gzip，bzip2或xz）的本地 tar归档文件，则将其解压缩为目录。来自远程 URL的资源不会被解压缩。复制或解压缩目录时，其行为与相同

  tar -x

  ，结果是以下各项的并集：
  目标路径上存在的任何内容和
  1. 源代码树的内容，已解决冲突，而选择了“ 2”。在逐个文件的基础上。

  注意：文件是否被识别为公认的压缩格式仅根据文件的内容而不是文件的名称来完成。例如，如果一个空文件恰好以

  .tar.gz

  该文件结尾，则不会被识别为压缩文件，并且不会生成任何类型的解压缩错误消息，而是会将文件简单地复制到目标位置。

• 如果

  是任何其他类型的文件，它将与元数据一起单独复制。在这种情况下，如果

  以斜杠结尾

  /

  ，则将其视为目录，并将其内容``写入

  /base()

  。

• 如果

  直接或由于使用通配符而指定了多个资源，则该资源

  必须是目录，并且必须以斜杠结尾

  /

  。

• 如果

  不以斜杠结尾，则将其视为常规文件，并将其内容

  写入``。

• 如果``不存在，它将与路径中所有缺少的目录一起创建。

COPY

COPY有两种形式：

• COPY [--chown=:] ...

• COPY [--chown=:] ["",... ""]

  （此格式对于包含空格的路径是必需的）

注意：此

--chown

功能仅在用于构建Linux容器的Dockerfiles上受支持，而在Windows容器上不起作用。由于用户和组所有权概念不会在Linux和Windows之间转换，因此使用

/etc/passwd

和

/etc/group

将用户名和组名转换为ID的使用限制了此功能仅对基于Linux OS的容器可用。

该

COPY

，并将它们添加到路径中容器的文件系统中

``可以指定多个资源，但是文件和目录的路径将被解释为相对于构建上下文的源。

每个都``可能包含通配符，并且匹配将使用Go的 filepath.Match规则完成。例如：

COPY hom* /mydir/        # adds all files starting with "hom"
COPY hom?.txt /mydir/    # ? is replaced with any single character, e.g., "home.txt"

的``是一个绝对路径，或相对于一个路径

WORKDIR

COPY test relativeDir/   # adds "test" to `WORKDIR`/relativeDir/
COPY test /absoluteDir/  # adds "test" to /absoluteDir/

复制包含特殊字符（例如

[

]

arr[0].txt

COPY arr[[]0].txt /mydir/    # copy a file named "arr[0].txt" to /mydir/

除非可选

--chown

--chown

/etc/passwd

/etc/group

--chown

COPY --chown=55:mygroup files* /somedir/
COPY --chown=bin files* /somedir/
COPY --chown=1 files* /somedir/
COPY --chown=10:11 files* /somedir/

如果容器根文件系统不包含

/etc/passwd

/etc/group

--chown

COPY

注意：如果使用STDIN（

docker build - < somefile

）进行构建，则没有构建上下文，因此

COPY

无法使用。

（可选）

COPY

--from=

FROM .. AS

FROM

COPY

• 该``路径必须是内部语境的构建; 您不能这样做

  COPY ../something /something

  ，因为a的第一步

  docker build

  是将上下文目录（和子目录）发送到docker守护程序。
• 如果``是目录，则将复制目录的整个内容，包括文件系统元数据。

注意：目录本身不会被复制，只是其内容被复制。

• 如果

  是任何其他类型的文件，它将与元数据一起单独复制。在这种情况下，如果

  以斜杠结尾

  /

  ，则将其视为目录，并将其内容``写入

  /base()

  。
• 如果

  直接或由于使用通配符而指定了多个资源，则该资源

  必须是目录，并且必须以斜杠结尾

  /

  。
• 如果

  不以斜杠结尾，则将其视为常规文件，并将其内容

  写入``。
• 如果``不存在，它将与路径中所有缺少的目录一起创建。

ENTRYPOINT

ENTRYPOINT有两种形式：

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

  （执行表格，首选）

• ENTRYPOINT command param1 param2

  （外壳形式）

An

ENTRYPOINT

例如，以下将使用其默认内容启动nginx，并监听端口80：

docker run -i -t --rm -p 80:80 nginx

命令行参数to

docker run

ENTRYPOINT

CMD

docker run -d

-d

ENTRYPOINT

docker run --entrypoint

所述壳形式防止任何

CMD

run

ENTRYPOINT

/bin/sh -c

PID 1

SIGTERM

docker stop

只有中的最后一条

ENTRYPOINT

Dockerfile

执行表格ENTRYPOINT示例

您可以使用exec形式的

ENTRYPOINT

CMD

FROM ubuntu
ENTRYPOINT ["top", "-b"]
CMD ["-c"]

运行容器时，可以看到这

top

$ docker run -it --rm --name test  top -H
top - 08:25:00 up  7:27,  0 users,  load average: 0.00, 0.01, 0.05
Threads:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
%Cpu(s):  0.1 us,  0.1 sy,  0.0 ni, 99.7 id,  0.0 wa,  0.0 hi,  0.0 si,  0.0 st
KiB Mem:   2056668 total,  1616832 used,   439836 free,    99352 buffers
KiB Swap:  1441840 total,        0 used,  1441840 free.  1324440 cached Mem

PID USER      PR  NI    VIRT    RES    SHR S %CPU %MEM     TIME+ COMMAND
1 root      20   0   19744   2336   2080 R  0.0  0.1   0:00.04 top

要进一步检查结果，可以使用

docker exec

$ docker exec -it test ps aux
USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root         1  2.6  0.1  19752  2352 ?        Ss+  08:24   0:00 top -b -H
root         7  0.0  0.1  15572  2164 ?        R+   08:25   0:00 ps aux

您也可以使用优雅地请求

top

docker stop test

下面

Dockerfile

ENTRYPOINT

PID 1

FROM debian:stable
RUN apt-get update && apt-get install -y --force-yes apache2
EXPOSE 80 443
VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
ENTRYPOINT ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]

如果需要为单个可执行文件编写启动脚本，则可以使用

exec

gosu

#!/usr/bin/env bash
set -e

if [ "$1" = 'postgres' ]; then
chown -R postgres "$PGDATA"

if [ -z "$(ls -A "$PGDATA")" ]; then
gosu postgres initdb
fi

exec gosu postgres "$@"
fi

exec "$@"

最后，如果您需要在关机时进行一些额外的清理（或与其他容器通信），或者要协调多个可执行文件，则可能需要确保

ENTRYPOINT

#!/bin/sh
# Note: I've written this using sh so it works in the busybox container too

# USE the trap if you need to also do manual cleanup after the service is stopped,
#     or need to start multiple services in the one container
trap "echo TRAPed signal" HUP INT QUIT TERM

# start service in background here
/usr/sbin/apachectl start

echo "[hit enter key to exit] or run 'docker stop <container>'"
read

# stop service and clean up here
echo "stopping apache"
/usr/sbin/apachectl stop

echo "exited $0"

如果使用来运行该映像

docker run -it --rm -p 80:80 --name test apache

docker exec

docker top

$ docker exec -it test ps aux
USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root         1  0.1  0.0   4448   692 ?        Ss+  00:42   0:00 /bin/sh /run.sh 123 cmd cmd2
root        19  0.0  0.2  71304  4440 ?        Ss   00:42   0:00 /usr/sbin/apache2 -k start
www-data    20  0.2  0.2 360468  6004 ?        Sl   00:42   0:00 /usr/sbin/apache2 -k start
www-data    21  0.2  0.2 360468  6000 ?        Sl   00:42   0:00 /usr/sbin/apache2 -k start
root        81  0.0  0.1  15572  2140 ?        R+   00:44   0:00 ps aux
$ docker top test
PID                 USER                COMMAND
10035               root                {run.sh} /bin/sh /run.sh 123 cmd cmd2
10054               root                /usr/sbin/apache2 -k start
10055               33                  /usr/sbin/apache2 -k start
10056               33                  /usr/sbin/apache2 -k start
$ /usr/bin/time docker stop test
test
real	0m 0.27s
user	0m 0.03s
sys	0m 0.03s

**注意：**您可以

ENTRYPOINT

使用来覆盖设置

--entrypoint

，但这只能将二进制文件设置为exec（

sh -c

将不使用）。

注意：exec表单被解析为JSON数组，这意味着您必须在单词而非单引号（’）周围使用双引号（“）。

注意：与shell表单不同，exec表单不会调用命令shell。这意味着不会进行常规的外壳处理。例如，

ENTRYPOINT [ "echo", "$HOME" ]

将不会对进行变量替换

$HOME

。如果要进行shell处理，则可以使用shell形式或直接执行shell，例如：

ENTRYPOINT [ "sh", "-c", "echo $HOME" ]

。当使用exec表单并直接执行shell时（例如在shell表单中），是由shell进行环境变量扩展，而不是docker。

Shell form ENTRYPOINT example

您可以为指定一个纯字符串

ENTRYPOINT

/bin/sh -c

CMD

docker run

docker stop

ENTRYPOINT

exec

FROM ubuntu
ENTRYPOINT exec top -b

运行此图像时，您将看到单个

PID 1

$ docker run -it --rm --name test top
Mem: 1704520K used, 352148K free, 0K shrd, 0K buff, 140368121167873K cached
CPU:   5% usr   0% sys   0% nic  94% idle   0% io   0% irq   0% sirq
Load average: 0.08 0.03 0.05 2/98 6
PID  PPID USER     STAT   VSZ %VSZ %CPU COMMAND
1     0 root     R     3164   0%   0% top -b

它将干净地退出

docker stop

$ /usr/bin/time docker stop test
test
real	0m 0.20s
user	0m 0.02s
sys	0m 0.04s

如果您忘记添加

exec

ENTRYPOINT

FROM ubuntu
ENTRYPOINT top -b
CMD --ignored-param1

然后，您可以运行它（为下一步命名）：

$ docker run -it --name test top --ignored-param2
Mem: 1704184K used, 352484K free, 0K shrd, 0K buff, 140621524238337K cached
CPU:   9% usr   2% sys   0% nic  88% idle   0% io   0% irq   0% sirq
Load average: 0.01 0.02 0.05 2/101 7
PID  PPID USER     STAT   VSZ %VSZ %CPU COMMAND
1     0 root     S     3168   0%   0% /bin/sh -c top -b cmd cmd2
7     1 root     R     3164   0%   0% top -b

您可以从输出中

top

ENTRYPOINT

PID 1

如果随后运行

docker stop test

stop

SIGKILL

$ docker exec -it test ps aux
PID   USER     COMMAND
1 root     /bin/sh -c top -b cmd cmd2
7 root     top -b
8 root     ps aux
$ /usr/bin/time docker stop test
test
real	0m 10.19s
user	0m 0.04s
sys	0m 0.03s

了解CMD和ENTRYPOINT如何相互作用

无论

CMD

ENTRYPOINT

1. Dockerfile应该指定

   CMD

   或

   ENTRYPOINT

   命令中的至少一个。

2. ENTRYPOINT

   使用容器作为可执行文件时应定义。

3. CMD

   应该用作

   ENTRYPOINT

   在容器中定义命令或执行临时命令的默认参数的方式。

4. CMD

   当使用其他参数运行容器时，将被覆盖。

下表显示了针对不同

ENTRYPOINT

CMD

注意：如果

CMD

是从基础图像定义的，则设置

ENTRYPOINT

将重置

CMD

为空值。在这种情况下，

CMD

必须在当前图像中定义一个值。

VOLUME

VOLUME ["/data"]

该

VOLUME

VOLUME ["/var/log/"]

VOLUME /var/log

VOLUME /var/log /var/db

该

docker run

FROM ubuntu
RUN mkdir /myvol
RUN echo "hello world" > /myvol/greeting
VOLUME /myvol

该Dockerfile生成一个映像，该映像导致

docker run

/myvol

greeting

有关指定卷的注意事项

关于。中的卷，请注意以下几点

Dockerfile

• 基于Windows的容器上的卷：使用基于Windows的容器时，容器内的卷的目的地必须是以下之一： 不存在或空目录
• 除以下以外的驱动器

  C:

"

'

VOLUME

host-dir

USER

USER <user>[:<group>] or
USER <UID>[:<GID>]

该

USER

RUN

CMD

ENTRYPOINT

Dockerfile

警告：当用户没有主要组时，该映像（或以下说明）将与该

root

组一起运行。

在Windows上，如果不是内置帐户，则必须首先创建用户。这可以通过

net user

作为Dockerfile的一部分调用的命令来完成。

FROM microsoft/windowsservercore
# Create Windows user in the container
RUN net user /add patrick
# Set it for subsequent commands
USER patrick

WORKDIR

WORKDIR /path/to/workdir

该

WORKDIR

RUN

CMD

ENTRYPOINT

COPY

ADD

Dockerfile

WORKDIR

Dockerfile

该

WORKDIR

Dockerfile

WORKDIR

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

最终的输出

pwd

Dockerfile

/a/b/c

该

WORKDIR

ENV

Dockerfile

ENV DIRPATH /path
WORKDIR $DIRPATH/$DIRNAME
RUN pwd

最终

pwd

Dockerfile

/path/$DIRNAME

ARG

ARG <name>[=<default value>]

该

ARG

docker build

--build-arg =

[Warning] One or more build-args [foo] were not consumed.

Dockerfile可能包含一个或多个

ARG

FROM busybox
ARG user1
ARG buildno
...

**警告：**不建议使用构建时变量来传递诸如github密钥，用户凭据等机密。构建时变量值对于使用该

docker history

命令的图像的任何用户都是可见的。

默认值

的

ARG

FROM busybox
ARG user1=someuser
ARG buildno=1
...

如果

ARG

范围

一个

ARG

Dockerfile

1 FROM busybox
2 USER ${user:-some_user}
3 ARG user
4 USER $user
...

用户通过调用以下命令来构建此文件：

$ docker build --build-arg user=what_user .

USER

some_user

user

USER

what_user

user

what_user

ARG

的

ARG

ARG

FROM busybox
ARG SETTINGS
RUN ./run/setup $SETTINGS

FROM busybox
ARG SETTINGS
RUN ./run/other $SETTINGS

使用ARG变量

您可以使用

ARG

ENV

RUN

ENV

ARG

ENV

ARG

1 FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER v1.0.0
4 RUN echo $CONT_IMG_VER

然后，假定此映像是使用以下命令构建的：

$ docker build --build-arg CONT_IMG_VER=v2.0.1 .

在这种情况下，该

RUN

v1.0.0

ARG

v2.0.1

使用上面的示例，但使用不同的

ENV

ARG

ENV

1 FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0}
4 RUN echo $CONT_IMG_VER

与

ARG

ENV

--build-arg

$ docker build .

使用此Dockerfile示例，

CONT_IMG_VER

v1.0.0

ENV

在此示例中，变量扩展技术使您可以从命令行传递参数，并利用

ENV

预定义的

Docker具有一组预定义

ARG

ARG

• HTTP_PROXY

• http_proxy

• HTTPS_PROXY

• https_proxy

• FTP_PROXY

• ftp_proxy

• NO_PROXY

• no_proxy

要使用它们，只需使用以下标志在命令行中传递它们：

--build-arg <varname>=<value>

默认情况下，这些预定义变量从的输出中排除

docker history

HTTP_PROXY

例如，考虑使用以下命令构建以下Dockerfile

--build-arg HTTP_PROXY=http://user:pass@proxy.lon.example.com

FROM ubuntu
RUN echo "Hello World"

在这种情况下，

HTTP_PROXY

docker history

http://user:pass@proxy.sfo.example.com

如果您需要覆盖此行为，则可以通过

ARG

FROM ubuntu
ARG HTTP_PROXY
RUN echo "Hello World"

构建此Dockerfile时，将

HTTP_PROXY

docker history

全球范围内的自动平台

仅当使用BuildKit后端时，此功能才可用。

Docker

ARG

--platform

docker build

以下

ARG

• TARGETPLATFORM

  -构建结果的平台。例如

  linux/amd64

  ，

  linux/arm/v7

  ，

  windows/amd64

  。

• TARGETOS

  -TARGETPLATFORM的OS组件

• TARGETARCH

  -TARGETPLATFORM的体系结构组件

• TARGETVARIANT

  -TARGETPLATFORM的变体组件

• BUILDPLATFORM

  -执行构建的节点的平台。

• BUILDOS

  -BUILDPLATFORM的OS组件

• BUILDARCH

  -BUILDPLATFORM的体系结构组件

• BUILDVARIANT

  -BUILDPLATFORM的变体组件

这些参数是在全局范围内定义的，因此在构建阶段或您的

RUN

例如：

FROM alpine
ARG TARGETPLATFORM
RUN echo "I'm building for $TARGETPLATFORM"

对构建缓存的影响

ARG

ENV

ARG

ARG

RUN

ARG

ARG

ARG

ARG

Dockerfile

例如，考虑以下两个Dockerfile：

1 FROM ubuntu
2 ARG CONT_IMG_VER
3 RUN echo $CONT_IMG_VER
1 FROM ubuntu
2 ARG CONT_IMG_VER
3 RUN echo hello

如果

--build-arg CONT_IMG_VER=

ARG CONT_IMG_VER

CONT_IMG_VER=

考虑在同一命令行下的另一个示例：

1 FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER $CONT_IMG_VER
4 RUN echo $CONT_IMG_VER

在此示例中，高速缓存未命中发生在第3行。之所以发生未命中，是因为该变量在

ENV

ARG

ENV

如果一条

ENV

ARG

1 FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER hello
4 RUN echo $CONT_IMG_VER

第3行不会导致缓存未命中，因为的值

CONT_IMG_VER

hello

RUN

ONBUILD

ONBUILD [INSTRUCTION]

该

ONBUILD

FROM

Dockerfile

任何构建指令都可以注册为触发器。

如果要构建的图像将用作构建其他图像的基础，例如应用程序构建环境或可以使用用户特定配置自定义的守护程序，则此功能很有用。

例如，如果您的映像是可重用的Python应用程序构建器，则将需要在特定目录中添加应用程序源代码，并且此后可能需要调用构建脚本 。你不能只是打电话

ADD

RUN

Dockerfile

解决方案是使用

ONBUILD

运作方式如下：

1. 当遇到

   ONBUILD

   指令时，构建器将触发器添加到正在构建的图像的元数据中。该指令不会影响当前版本。
2. 构建结束时，所有触发器的列表都存储在映像清单的key下

   OnBuild

   。可以使用

   docker inspect

   命令检查它们。
3. 稍后，可以使用该

   FROM

   指令将该图像用作新版本的基础 。作为处理

   FROM

   指令的一部分，下游构建器将查找

   ONBUILD

   触发器，并按照注册时的顺序执行它们。如果任何触发器失败，则该

   FROM

   指令将中止，进而导致构建失败。如果所有触发器都成功，则

   FROM

   指令完成，并且构建照常继续。
4. 执行完触发器后，将从最终图像中清除触发器。换句话说，它们不是“孙子代”版本所继承的。

例如，您可以添加以下内容：

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

警告：不允许

ONBUILD

使用链接说明

ONBUILD ONBUILD

。

警告：该

ONBUILD

指令可能不会触发

FROM

或执行

MAINTAINER

。

STOPSIGNAL

STOPSIGNAL signal

该

STOPSIGNAL

HEALTHCHECK

该

HEALTHCHECK

• HEALTHCHECK [OPTIONS] CMD command

  （通过在容器内部运行命令来检查容器的运行状况）

• HEALTHCHECK NONE

  （禁用从基本映像继承的任何运行状况检查）

该

HEALTHCHECK

指定容器的运行状况检查后，除了其正常状态外，它还具有运行状况。此状态最初为

starting

healthy

unhealthy

之前可能出现的选项

CMD

• --interval=DURATION

  （默认值：

  30s

  ）

• --timeout=DURATION

  （默认值：

  30s

  ）

• --start-period=DURATION

  （默认值：

  0s

  ）

• --retries=N

  （默认值：

  3

  ）

运行状况检查将首先在容器启动后的间隔秒数内运行，然后在每次之前的检查完成后的间隔秒数内再次运行。

如果单次检查花费的时间超过超时秒数，则认为检查失败。

对于要考虑的容器，需要重试连续进行的运行状况检查失败

unhealthy

开始时间段为需要时间进行引导的容器提供了初始化时间。在此期间的探针故障将不计入最大重试次数。但是，如果运行状况检查在启动期间成功，则认为该容器已启动，并且所有连续失败将计入最大重试次数。

HEALTHCHECK

HEALTHCHECK

CMD

HEALTHCHECK CMD /bin/check-running

ENTRYPOINT

该命令的退出状态指示容器的健康状态。可能的值为：

• 0：成功-容器健康且可以使用
• 1：不健康-容器无法正常工作
• 2：保留-请勿使用此退出代码

例如，要每五分钟检查一次，以便网络服务器能够在三秒钟内为站点的主页提供服务：

HEALTHCHECK --interval=5m --timeout=3s \
CMD curl -f http://localhost/ || exit 1

为了帮助调试失败的探针，命令在stdout或stderr上写入的任何输出文本（UTF-8编码）将存储在运行状况中，并可以通过查询

docker inspect

当容器的健康状态发生变化时，将

health_status

该

HEALTHCHECK

SHELL

SHELL ["executable", "parameters"]

该

SHELL

["/bin/sh", "-c"]

["cmd", "/S", "/C"]

SHELL

该

SHELL

cmd

powershell

sh

该

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

以下说明可以通过影响

SHELL

RUN

CMD

ENTRYPOINT

以下示例是Windows上常见的模式，可通过使用

SHELL

...
RUN powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"
...

docker调用的命令将是：

cmd /S /C powershell -command Execute-MyCmdlet -param1 "c:\foo.txt"

这效率低下有两个原因。首先，有一个不必要的cmd.exe命令处理器（也称为外壳程序）被调用。其次，shell 形式的每条

RUN

powershell -command

为了使其更有效，可以采用两种机制之一。一种是使用RUN命令的JSON形式，例如：

...
RUN ["powershell", "-command", "Execute-MyCmdlet", "-param1 \"c:\\foo.txt\""]
...

尽管JSON形式是明确的，并且不使用不必要的cmd.exe，但它确实需要通过双引号和转义来实现更多的详细信息。另一种机制是使用

SHELL

escape

# escape=`

FROM microsoft/nanoserver
SHELL ["powershell","-command"]
RUN New-Item -ItemType Directory C:\Example
ADD Execute-MyCmdlet.ps1 c:\example\
RUN c:\example\Execute-MyCmdlet -sample 'hello world'

导致：

PS E:\docker\build\shell> docker build -t shell .
Sending build context to Docker daemon 4.096 kB
Step 1/5 : FROM microsoft/nanoserver
---> 22738ff49c6d
Step 2/5 : SHELL powershell -command
---> Running in 6fcdb6855ae2
---> 6331462d4300
Removing intermediate container 6fcdb6855ae2
Step 3/5 : RUN New-Item -ItemType Directory C:\Example
---> Running in d0eef8386e97

Directory: C:\

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----       10/28/2016  11:26 AM                Example

---> 3f2fbf1395d9
Removing intermediate container d0eef8386e97
Step 4/5 : ADD Execute-MyCmdlet.ps1 c:\example\
---> a955b2621c31
Removing intermediate container b825593d39fc
Step 5/5 : RUN c:\example\Execute-MyCmdlet 'hello world'
---> Running in be6d8e63fe75
hello world
---> 8e559e9bf424
Removing intermediate container be6d8e63fe75
Successfully built 8e559e9bf424
PS E:\docker\build\shell>

该

SHELL

SHELL cmd /S /C /V:ON|OFF

如果

SHELL

zsh

csh``tcsh

该

SHELL

如需进一步了解 配置详情 参考官方文档 https://docs.docker.com/engine/reference/builder/

• 点赞
• 收藏
• 分享
• 文章举报