Dockerfile 发行说明

目录

此页面包含有关 Dockerfile 参考中新功能、改进、已知问题和错误修复的信息。

有关用法，请参阅 Dockerfile 前端语法 页面。

1.18.0

2025-09-03

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.18.0
  • 增加了对 Git URL 的支持，用于远程构建上下文，并且 `ADD` 命令现在允许使用新语法，其中添加了 `?key=value` 格式的查询参数，以更好地控制 Git 克隆过程。此版本中支持的选项有 `ref`、`tag`、`branch`、`checksum` (别名 `commit`)、`subdir`、`keep-git-dir` 和 `submodules`。moby/buildkit#6172 moby/buildkit#6173
  • 添加了新的检查规则 `ExposeProtoCasing` 和 `ExposeInvalidFormat`，以改进 `EXPOSE` 命令的使用。moby/buildkit#6135
  • 修复了使用命名上下文时，创建时间未从基础镜像正确设置的问题。moby/buildkit#6096

1.17.0

2025-06-17

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.17.0
  • 添加 `ADD --unpack=bool` 以控制是否解压 URL 路径中的归档文件。默认行为是根据源路径检测解压行为，与之前版本相同。moby/buildkit#5991
  • 添加了在解压归档文件时对 `ADD --chown` 的支持，类似于复制普通文件。moby/buildkit#5987

1.16.0

2025-05-22

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.16.0

1.15.1

2025-03-30

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.15.1
  • 修复了使用 `--attest type=sbom` 时出现 `no scan targets for linux/arm64/v8` 的问题。moby/buildkit#5941

1.15.0

2025-04-15

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.15.0
  • 现在，对于无效的目标，构建错误会显示正确可能名称的建议。moby/buildkit#5851
  • 修复了 SBOM 证明为 Windows 目标生成错误的问题。moby/buildkit#5837
  • 修复了处理大纲请求时递归 `ARG` 导致无限循环的问题。moby/buildkit#5823
  • 修复了从 JSON 解析语法指令的问题，如果 JSON 包含字符串以外的数据类型，则会失败。moby/buildkit#5815
  • 修复了镜像配置中的平台采用非规范化形式的问题（1.12 版本中的回归）。moby/buildkit#5776
  • 修复了使用 WCOW 复制到目标目录时，如果目录不存在则失败的问题。moby/buildkit#5249

1.14.1

2025-03-05

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.14.1

1.14.0

2025-02-19

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.14.0
  • COPY --chmod 现在允许非八进制值。此功能之前在实验室通道中，现在已在主发布版中可用。moby/buildkit#5734
  • 修复了基础镜像设置 OSVersion 平台属性时的处理问题。moby/buildkit#5714
  • 修复了即使命名上下文元数据不可被当前构建配置访问，也可能被解析，从而导致构建错误的问题。moby/buildkit#5688

1.14.0 (实验室)

2025-02-19
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker.io/docker/dockerfile-upstream:1.14.0-labs

1.13.0

2025-01-20

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.13.0
  • 新的 `TARGETOSVERSION`、`BUILDOSVERSION` 内置构建参数可用于 Windows 构建，并且 `TARGETPLATFORM` 值现在还包含 `OSVersion` 值。moby/buildkit#5614
  • 允许以字节顺序标记（BOM）开头的文件进行外部前端语法转发。moby/buildkit#5645
  • Windows 容器中的默认 `PATH` 已更新，包含 `powershell.exe` 目录。moby/buildkit#5446
  • 修复 Dockerfile 指令解析，不允许使用无效语法。moby/buildkit#5646
  • 修复了在继承阶段 `ONBUILD` 命令可能运行两次的情况。moby/buildkit#5593
  • 修复了 Dockerfile 中子阶段可能缺少命名上下文替换的问题。moby/buildkit#5596

1.13.0 (实验室)

2025-01-20
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker.io/docker/dockerfile-upstream:1.13.0-labs

1.12.0

2024-11-27

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.12.0
  • 修复了在镜像配置历史记录行中，多个 `ARG` 指令导致描述不正确的问题。moby/buildkit#5508

1.11.1

2024-11-08

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.11.1
  • 修复了在同一 Dockerfile 中继承阶段使用 `ONBUILD` 指令时的回归问题。moby/buildkit#5490

1.11.0

2024-10-30

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.11.0

1.11.0 (实验室)

重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

1.10.0

2024-09-10

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.10.0

1.9.0

2024-07-11

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.9.0
  • 添加新验证规则
    • SecretsUsedInArgOrEnv
    • InvalidDefaultArgInFrom
    • RedundantTargetPlatform
    • CopyIgnoredFile（实验性）
    • FromPlatformFlagConstDisallowed
  • 在使用大型 Dockerfile 时，性能得到了多项改进。moby/buildkit#5067, moby/buildkit#5029
  • 修复了构建未定义阶段的 Dockerfile 时可能发生的 panic。moby/buildkit#5150
  • 修复了不正确的 JSON 解析问题，该问题可能导致一些不正确的 JSON 值在不产生错误的情况下通过。moby/buildkit#5107
  • 修复了 `COPY --link` 目标路径为 `.` 时可能失败的回归问题。moby/buildkit#5080
  • 修复了将 `ADD --checksum` 与 Git URL 结合使用时的验证问题。moby/buildkit#5085

1.8.1

2024-06-18

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.8.1

错误修复和增强

1.8.0

2024-06-11

此版本的完整发布说明可在 GitHub 上查阅。

# syntax=docker/dockerfile:1.8.0
  • 新增了许多验证规则，用于验证您的 Dockerfile 是否遵循最佳实践。这些规则在构建期间进行验证，并且可以使用新的 `check` 前端方法仅触发验证，而无需完成整个构建。
  • 新的指令 ` #check ` 和构建参数 ` BUILDKIT_DOCKERFILE_CHECK ` 允许您控制构建检查的行为。moby/buildkit#4962
  • 现在会验证使用与预期平台不匹配的单一平台基础镜像。moby/buildkit#4924
  • 现在可以正确处理全局作用域中 `ARG` 定义扩展的错误。moby/buildkit#4856
  • ARG 默认值的展开现在仅在用户未覆盖它时发生。以前，展开完成后值被忽略，这可能导致意外的展开错误。moby/buildkit#4856
  • 解析包含许多阶段的巨型 Dockerfile 的性能已得到改进。moby/buildkit#4970
  • 修复了一些 Windows 路径处理一致性错误。moby/buildkit#4825

1.7.0

2024-03-06

稳定版

# syntax=docker/dockerfile:1.7

实验室

# syntax=docker/dockerfile:1.7-labs

1.6.0

2023-06-13

新增

以下功能已从实验室通道升级到稳定版

错误修复和增强

1.5.2

2023-02-14

错误修复和增强

  • 修复了从缺少分支名称但包含子目录的 Git 引用构建的问题
  • 386 平台镜像现在包含在发布版中

1.5.1

2023-01-18

错误修复和增强

  • 修复了在多平台构建中出现警告条件时可能发生的 panic

1.5.0 (实验室)

2023-01-10
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

新增

1.5.0

2023-01-10

新增

错误修复和增强

  • 命名上下文现在支持 `oci-layout://` 协议，用于包含来自本地 OCI 布局结构的镜像
  • Dockerfile 现在支持列出所有构建目标或打印特定构建目标接受参数大纲的二次请求
  • Dockerfile 的 `#syntax` 指令，用于重定向到外部前端镜像，现在允许通过 `//` 注释或 JSON 来设置该指令。文件还可以包含 shebang 头部
  • 命名上下文现在可以使用空 scratch 镜像初始化
  • 命名上下文现在可以通过 SSH Git URL 进行初始化
  • 修复了导入 Schema1 镜像时 `ONBUILD` 的处理问题

1.4.3

2022-08-23

错误修复和增强

  • 修复了从 `docker-image://` 命名上下文构建镜像时创建时间未重置的问题
  • 修复了加载 `docker-image://` 命名上下文时，`FROM` 命令的 `--platform` 标志传递问题

1.4.2

2022-05-06

错误修复和增强

  • 修复了从通过构建上下文传递的镜像加载某些环境变量的问题

1.4.1

2022-04-08

错误修复和增强

  • 修复了跨编译情况下，当输入为不同平台构建时，从输入解析命名上下文的问题

1.4.0

2022-03-09

新增

  • COPY --link 和 ADD --link 允许以更高的缓存效率复制文件，并重新基于镜像而无需重新构建。--link 将文件复制到单独的层，然后使用新的 LLB MergeOp 实现将独立的层链接在一起
  • Heredocs 支持已从实验室通道升级到稳定版。此功能允许编写多行内联脚本和文件
  • 可以通过 额外的命名构建上下文 来构建，以添加或覆盖构建中的阶段或镜像。上下文的源可以是本地源、镜像、Git 或 HTTP URL。
  • BUILDKIT_SANDBOX_HOSTNAME 构建参数可用于为 `RUN` 步骤设置默认主机名

错误修复和增强

  • 使用交叉编译阶段时，现在在进度输出中显示步骤的目标平台
  • 修复了 Heredocs 错误地从内容中删除引号的某些情况

1.3.1

2021-10-04

错误修复和增强

  • 修复了解析不带值的“required”挂载键的问题

1.3.0 (实验室)

2021-07-16
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

新增

1.3.0

2021-07-16

新增

  • RUN 命令允许 --network 标志用于请求特定类型的网络条件。--network=host 需要允许 `network.host` 授权。此功能之前仅在实验室通道中可用。

错误修复和增强

1.2.1 (实验室)

2020-12-12
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

错误修复和增强

  • RUN 命令允许 --network 标志用于请求特定类型的网络条件。--network=host 需要允许 `network.host` 授权

1.2.1

2020-12-12

错误修复和增强

  • 恢复“确保 ENTRYPOINT 命令至少有一个参数”
  • 优化多平台交叉编译构建上的 `COPY` 调用处理

1.2.0 (实验室)

2020-12-03
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

错误修复和增强

  • 实验性通道已重命名为 _labs_

1.2.0

2020-12-03

新增

  • RUN --mount 语法，用于创建 secret、ssh、bind 和 cache 挂载，已移至主通道
  • ARG 命令现在支持在同一行定义多个构建参数，类似于 ENV

错误修复和增强

  • 元数据加载错误现在作为致命错误处理，以避免不正确的构建结果
  • 允许小写 Dockerfile 名称
  • ADD 中的 --chown 标志现在允许参数扩展
  • ENTRYPOINT 至少需要一个参数，以避免创建损坏的镜像

1.1.7

2020-04-18

错误修复和增强

  • 将 `FrontendInputs` 转发到网关

1.1.2 (实验室)

2019-07-31
重要提示

实验室通道让您可以使用尚未在稳定通道中提供的实验性 Dockerfile 功能。

错误修复和增强

  • 允许使用 RUN --security=sandbox|insecure 为进程设置安全模式
  • 允许为缓存挂载设置 uid/gid
  • 避免请求内部链接路径被拉取到构建上下文
  • 确保缺失的缓存 ID 默认为目标路径
  • 允许使用 BUILDKIT_CACHE_MOUNT_NS 构建参数设置缓存挂载的命名空间

1.1.2

2019-07-31

错误修复和增强

  • 修复了使用正确用户创建工作目录的问题，并且不重置自定义所有权
  • 修复了同时用作 `ENV` 的空构建参数的处理
  • 检测循环依赖

1.1.0

2019-04-27

新增

  • ADD/COPY 命令现在支持基于 llb.FileOp 的实现，如果内置文件操作支持可用，则无需辅助镜像
  • COPY 命令的 --chown 标志现在支持变量扩展

错误修复和增强

  • 为了查找从构建上下文忽略的文件，Dockerfile 前端将首先查找文件 `<path/to/Dockerfile>.dockerignore`，如果未找到，则会从构建上下文的根目录查找 `.dockerignore` 文件。这允许包含多个 Dockerfile 的项目使用不同的 `.dockerignore` 定义
© . This site is unofficial and not affiliated with Kubernetes or Docker Inc.