Skip to main content

Dockerfile配置

Docker可以通过读取Dockerfile中的指令自动构建镜像。Dockerfile是一个文本文档，其中包含了用户创建镜像的所有命令和说明。

变量​

变量用 $variable_name 或者 ${variable_name} 表示

${variable:-word}表示如果variable设置，则结果将是该值。如果variable未设置，word则将是结果。 ${variable:+word}表示如果variable设置则为word结果，否则为空字符串。 变量前加 \ 可以转义成普通字符串：\$foo or \${foo}，表示转换为$foo和${foo}文字。

FROM​

初始化一个新的构建阶段，并设置基础映像：

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

单个dockfile可以多次出现 FROM ，以使用之前的构建阶段作为另一个构建阶段的依赖项 AS name表示为构建阶段命名，在后续FROM和COPY --from=<name>说明中可以使用这个名词，引用此阶段构建的映像 digest其实就是就是根据镜像内容产生的一个ID，只要镜像的内容不变digest也不会变 tag或digest值是可选的。如果您省略其中任何一个，构建器默认使用一个latest标签。如果找不到该tag值，构建器将返回错误。 --platform标志可用于在FROM引用多平台镜像的情况下指定平台。例如，linux/amd64、linux/arm64、 或windows/amd64

RUN​

将在当前镜像之上的新层中执行命令，在docker build时运行

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

RUN有两种形式：

  • RUN <command>shell 形式，命令在 shell 中运行，默认/bin/sh -c在 Linux 或cmd /S /CWindows 上）
  • RUN ["executable", "param1", "param2"]（执行形式）

说明：

可以使用\（反斜杠）将单个RUN指令延续到下一行 RUN在下一次构建期间，指令缓存不会自动失效。可以使用--no-cache标志使指令缓存无效 Dockerfile的指令每执行一次都会在docker上新建一层。所以过多无意义的层，会造成镜像膨胀过大，可以使用&&符号连接命令，这样执行后，只会创建 1 层镜像

CMD​

运行程序，在docker run时运行，但是和RUN命令不同，RUN是在docker build时运行

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

支持三种格式

  • CMD ["executable","param1","param2"] 使用 exec 执行，推荐方式；
  • CMD command param1 param2 在 /bin/sh 中执行，提供给需要交互的应用；
  • CMD ["param1","param2"] 提供给 ENTRYPOINT 的默认参数；
caution

指定启动容器时执行的命令，每个Dockerfile只能有一条CMD命令。如果指定了多条命令，只有最后一条会被执行。

如果用户启动容器时候指定了运行的命令，则会覆盖掉CMD指定的命令。

ENTRYPOINT​

ENTRYPOINT和CMD一样，都是在指定容器启动程序及参数，不过它不会被docker run的命令行参数指定的指令所覆盖。如果要覆盖的话，需要通过docker run --entrypoint来指定。

它有2种格式：

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

当指定了ENTRYPOINT后，CMD的内容作为参数传给ENTRYPOINT指令，实际执行时，将变为：

<ENTRYPOINT> <CMD>

EXPOSE​

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

Docker容器在运行时侦听指定的网络端口。可以指定端口是监听TCP还是UDP，如果不指定协议，默认为TCP。

该EXPOSE指令实际上并未发布端口。要在运行容器时实际发布端口，docker run -P来发布和映射一个或多个端口。

默认情况下，EXPOSE假定TCP。您还可以指定UDP：

EXPOSE 80/udp

VOLUME​

创建一个具有指定名称的挂载数据卷

VOLUME ["/var/log/"]
VOLUME /var/log

它的主要作用是：

  • 避免重要的数据，因容器重启而丢失
  • 避免容器不断变大

WORKDIR​

工作目录，如果WORKDIR不存在，即使它没有在后续Dockerfile指令中使用，它也会被创建。

docker build构建镜像过程中，每一个RUN命令都会新建一层。只有通过WORKDIR创建的目录才会一直存在。

可以设置多个WORKDIR，如果提供了相对路径，它将相对于前一条WORKDIR指令的路径。例如：

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

最终pwd命令的输出是/a/b/c.

该WORKDIR指令可以解析先前使用ENV，例如：

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

最终pwd命令的输出是/path/$DIRNAME

ADD​

复制新文件、目录或远程文件URL <src>，并将它们添加到<dest>中。

<src>可以指定多个资源，但如果它们是文件或目录，则它们的路径被解释为相对于构建上下文的源，也就是WORKDIR。

每个都<src>可能包含通配符，匹配将使用Go的filepath.Match规则。例如：

添加所有以hom开头的文件：

ADD hom* /mydir/

在下面的示例中，?被替换为任何单个字符，例如home.txt。

ADD hom?.txt /mydir/

<dest>是一个绝对路径，或相对WORKDIR的相对路径。

COPY​

语法同ADD一致，复制拷贝文件。

COPY指令和ADD指令的唯一区别在于：是否支持从远程URL获取资源。COPY指令只能从执行docker build所在的主机上读取资源并复制到镜像中。而ADD指令还支持通过URL从远程服务器读取资源并复制到镜像中。

相同需求时，推荐使用COPY指令。ADD指令更擅长读取本地tar文件并解压缩。

USER​

设置用户名（或UID）和可选的用户组（或GID）

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