Dockerfile 备忘清单

这是 Dockerfile 的快速参考备忘单。包含用户可以在命令行上调用以组装镜像的所有命令。

参考

继承

默认 Dockerfile 位于上下文的根目录中。

  1. docker build -f /path/to/a/Dockerfile .

使用 -f 指向文件系统中任何位置的 Dockerfile。

继承

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

示例

  1. FROM ruby:2.2.2
  2. FROM golang:1.19-alpine3.16 AS build-env

变量 ENV

  1. ENV <key>=<value> ...
  1. ENV APP_HOME /myapp
  2. RUN mkdir $APP_HOME
  1. ENV MY_NAME="John Doe" MY_DOG=Rex\ The\ Dog \
  2.     MY_CAT=fluffy

初始化

  1. RUN bundle install

WORKDIR 指令为任何 RUN、CMD、ENTRYPOINT、COPY 和 ADD 指令设置工作目录。

  1. WORKDIR /myapp

VOLUME 指令创建一个具有指定名称的挂载点，并将其标记为保存来自本机主机或其他容器的外部挂载卷。

  1. VOLUME ["/data"]
  2. # 安装点规范
  1. ADD file.xyz /file.xyz
  2. # 复制
  3. COPY --chown=user:group host_file.xyz /path/container_file.xyz

Onbuild

  1. ONBUILD RUN bundle install
  2. # 与另一个文件一起使用时
  4. ONBUILD ADD . /app/src
  5. ONBUILD RUN /usr/local/bin/python-build --dir /app/src

指令将触发指令添加到镜像中，以便稍后执行，此时镜像用作另一个构建的基础。

在严格的 shell 中运行命令

  1. ENV my_var
  2. SHELL ["/bin/bash", "-euo", "pipefail", "-c"]
  3. # 使用严格模式：
  4. RUN false         # ails 像使用 && 一样构建
  5. RUN echo "$myvar" # 由于拼写错误会抛出错误
  6. RUN true | false  # 将脱离管道

使用 shell 将为 shell 命令打开严格模式。

命令 CMD

:- -
CMD ["executable","param1","param2"] (exec 形式，这是首选形式)
CMD ["param1","param2"] (作为 ENTRYPOINT 的默认参数)
CMD command param1 param2 (shell形式) 
  1. EXPOSE 5900
  2. CMD ["bundle", "exec", "rails", "server"]

入口点 ENTRYPOINT

  1. ENTRYPOINT ["executable", "param1", "param2"]
  2. ENTRYPOINT command param1 param2

配置将作为可执行文件运行的容器。

  1. ENTRYPOINT exec top -b

这将使用 shell 处理来替换 shell 变量，并将忽略任何 CMD 或 docker run 命令行参数。

元数据 LABEL

  1. LABEL version="1.0"
  1. LABEL "com.example.vendor"="ACME Incorporated"
  2. LABEL com.example.label-with-value="foo"
  3. LABEL version="1.0"
  1. LABEL description="本文说明\
  2. 标签值可以跨越多行。"
  3. LABEL multi.label1="value1" \
  4.       multi.label2="value2" \
  5.       other="value3"

ARG

  1. ARG <name>[=<default value>]

指令定义了一个变量，在构建时通过 docker build 命令使用 —build-arg <varname>=<value> 标志将其传递给构建器。

  1. FROM busybox
  2. # user1 默认值为 someuser
  3. ARG user1=someuser
  4. ARG buildno=1

.dockerignore 文件

  1. # 注释说明
  2. */temp*
  3. */*/temp*
  4. temp?
:- -
# comment 忽略
*/temp* 在根的任何直接子目录中
排除名称以 temp 开头的文件和目录
*/*/temp* 从根以下两级的任何子目录中
排除以 temp 开头的文件和目录
temp? 排除根目录中名称为
temp 的单字符扩展名的文件和目录

如果此文件存在，排除与其中的模式匹配的文件和目录，有利于避免 ADD 或 COPY 将敏感文件添加到镜像中。匹配是使用 Go 的 filepath.Match 规则完成的。

主要命令

命令 说明
FROM image 构建的基础镜像
MAINTAINER email (已弃用)维护者的名字
COPY [--chown=<user>:<group>] <src>... <dest> 将上下文中的路径复制到位置 dest 的容器中
ADD [--chown=<user>:<group>] <src>... <dest> 与 COPY 相同，但解压缩存档并接受 http url。
RUN <command> 在容器内运行任意命令。
USER <user>[:<group>] 设置默认用户名。
WORKDIR /path/to/workdir 设置默认工作目录。
CMD command param1 param2 设置默认命令
ENV <key>=<value> ... 设置环境变量
EXPOSE <port> [<port>/<protocol>...] 运行时侦听指定的网络端口

服务静态网站的最小 Docker 镜像

  1. FROM lipanski/docker-static-website:latest
  2. # 使用 .dockerignore 文件来控制图像中的内容！
  3. # 复制当前目录内容，到容器中
  4. COPY ./ .

这会产生一个 154KB + 的单层镜像。 如果您需要以不同的方式配置 httpd，您可以覆盖 CMD 行：

  1. FROM lipanski/docker-static-website:latest
  2. COPY . .
  4. CMD ["/busybox", "httpd", "-f", "-v", "-p", "3000", "-c", "httpd.conf"]

缩小镜像过程查看原文，镜像 Dockerfile 源码。

也可以看看