New Hot

Docker Engine 29.10.0 发布:本地 registry 安全性变更与 Engine API 迁移

Docker容器运行时安全更新Engine API

Docker Engine 29.10.0 发布,显式配置 insecure-registries 后回环地址不再自动视为不安全仓库,本地 HTTP registry 推送可能失败;Engine API 规范迁移到 OpenAPI 3.2。使用自建仓库的团队需要评估。

Docker Engine 29.10.0 收紧本地 registry 默认放行

Docker Engine 29.10.0 的核心变化是本地 registry 安全策略收紧,并把 Engine API 规范迁移到 OpenAPI 3.2。 版本同时补充了三个企业发行版的软件包与多项修复。

回环地址不再自动放行

如果你在 daemon.json 里显式配置了 insecure-registries,或使用了 --insecure-registry,引擎不再自动把回环地址 127.0.0.0/8 与 ::1/128 视为不安全仓库。官方原文称:“Docker Engine no longer automatically treats loopback addresses (127.0.0.0/8 and ::1/128) as insecure registries.”(来源:Docker 官方发布说明)

升级后,指向 HTTP 或不受信任 TLS 证书的本地仓库的拉取与推送可能失败,除非把这些地址显式写进不安全仓库配置,例如 localhost:5000。完全省略该字段时,回环仓库仍按不安全处理;设置 "insecure-registries": [] 会关闭全部默认放行。

Engine API 迁移到 OpenAPI 3.2

Engine API 规范现在以 OpenAPI 3.2 为源格式,文件放在 api/openapi.yaml。为兼容现有工具,仍会发布由它生成的 Swagger 2.0 版本 api/swagger.yaml,并附带一份固定到 API v1.57 的副本。发布说明写明,后续 API 版本不再提供逐版本的 Swagger 2.0 文件。

新平台与实验特性

软件包新增 AlmaLinux、Oracle Linux 与 Rocky Linux。实验性 jobs 能力可通过 --enable-extension org.mobyproject.jobs.v0 启用,支持一次性与 cron 调度负载;容器也能从 /etc/docker/containerd.d/ 读取自定义 containerd 配置。打包侧把 BuildKit 更新到 v0.35.0、Go 运行时更新到 1.27.4,API 版本提升到 1.57。

本地 registry 推送与 Swagger 工具链都需要调整

自建本地镜像仓库的开发与 CI 流程最容易受影响,推送环节要先确认仓库地址是否被显式放行。

本地推送可能中断

在 CI 里往 localhost:5000 这类 HTTP 仓库推送的团队,升级后第一次推送就可能被拒绝。从官方描述看,这不是功能移除,而是安全默认值收紧,把需要的地址补进配置即可恢复。

工具链要跟着规范走

依赖 api/swagger.yaml 或逐版本 Swagger 文件做代码生成与 SDK 构建的流程,需要改用 OpenAPI 3.2 源文件。发布说明明确后续版本不再生成旧格式副本,越晚迁移成本越高。

运行时与网络修复

版本修复了 containerd 镜像存储在主机平台未拉取时 docker image inspect 与 docker image ls 显示空镜像的问题,也修正了 docker manifest annotate 拒绝 linux/loong64 等合法平台的情况。网络侧修复了 nftables 后端的端口发布报错与 overlay 网络重建问题。

自建 HTTP registry 的团队先在测试环境验证

使用自建 HTTP registry 或依赖 Swagger 文件的团队,建议在测试环境验证后再升级;只跑官方镜像的项目风险较低。

谁需要先验证

在 daemon.json 里写过 insecure-registries、用自签名证书搭私有仓库、或靠 Swagger 文件生成客户端的团队,属于需要先验证的一组。把本地仓库地址显式加入配置,再执行一次拉取与推送即可确认。

怎么升级

按你的发行版通过官方软件包渠道升级到 29.10.0;新增的 AlmaLinux、Oracle Linux 与 Rocky Linux 安装说明以官方页面为准。升级后重点回归镜像推送、多平台 manifest 与 overlay 网络。

风险与回退

官方未披露逐版本回退步骤。从官方描述看,最主要的破坏性变更集中在本地 registry 配置,提前改好配置可以避开大部分问题。相关的运行时版本变化也可以参考 Go 1.27.4 安全更新。

常见问题

Docker Engine 29.10.0 对本地仓库做了什么调整?
显式配置 insecure-registries 后,回环地址不再被自动当作不安全仓库,需要把本地仓库地址写进配置。
升级 Docker Engine 后向本地仓库推送失败怎么办?
把需要的地址显式加入 insecure-registries,例如 localhost:5000,或为仓库配置受信任的 TLS 证书。
Docker Engine 的 Engine API 规范有什么变化?
源格式迁移到 OpenAPI 3.2,仍发布 Swagger 2.0 副本,但后续 API 版本不再提供逐版本 Swagger 2.0 文件。
Docker Engine 29.10.0 适合直接上生产吗?
使用自建 HTTP registry 或依赖 Swagger 文件的团队建议先在测试环境验证,再分批升级。

相关术语

Docker Engine
Docker Engine 是 Docker 的容器运行时与守护进程,负责镜像、容器和网络的生命周期管理。
insecure-registries
insecure-registries 是 Docker 守护进程配置项,用于放行使用 HTTP 或不受信任 TLS 证书的镜像仓库。
OpenAPI
OpenAPI 是描述 HTTP API 的规范格式,可用于生成文档、客户端和测试代码。
BuildKit
BuildKit 是 Docker 的镜像构建引擎,负责执行 Dockerfile 并产出镜像层。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

「Docker Engine 29.10.0」 —— Docker

搜索文章

输入关键词,快速查找标题和正文内容。