You need to enable JavaScript to run this app.
文档中心
容器服务

容器服务

复制全文
下载 pdf
运行时发布记录
containerd 2.3.x 介绍
复制全文
下载 pdf
containerd 2.3.x 介绍
VKE 从 Kubernetes v1.36 版本开始支持使用 containerd 2.3.x 版本。本文介绍 containerd 2.3.x 相关主要功能特性变更、废弃功能、废弃 API 等说明。​
功能特性​
containerd 2.3 在存储、镜像处理、运行时管理和可观测性方面提供了以下主要能力:​
  • 新增 Mount Manager,统一管理设备格式化、挂载激活和无效挂载清理等文件系统挂载生命周期。​
  • 支持镜像卷挂载子目录,并支持并行解包镜像,提高镜像准备的灵活性和并发能力。​
  • 增强 Sandbox API,支持更新 Pod Sandbox 资源配置。​
  • 支持并行加载 Shim,缩短 containerd 重启后恢复大量运行中容器的等待时间。​
  • 增强容器运行时接口(Container Runtime Interface,CRI)的指标能力,支持查询 Pod Sandbox 指标,并在后台计算和缓存运行时指标。​
  • 增强节点资源接口(Node Resource Interface,NRI),提供独立的 Pod 和容器生命周期事件、WebAssembly(WASM)插件、指标和链路追踪等能力。​
  • NRI 生命周期事件已从统一的StateChange调整为独立 RPC。旧版外部 ttRPC 插件返回Unimplemented时,运行时可回退至StateChange,但会产生废弃告警;旧版 WASM 插件不支持该回退机制,需要使用新版 NRI SDK 重新构建。​
说明​
更多变更,请参见 containerd 2.3.0 Release Notes。​
配置变更​
  • containerd 2.3 使用 Config v4。VKE 为 containerd 2.3 提供独立的 Config v4 标准配置模板,不依赖 containerd 在加载时自动迁移旧配置。​
  • Config v4 将原顶层的[grpc]、[ttrpc]、[debug]和[metrics] 配置迁移至对应的 Server 或 Metrics Plugin 配置块。使用自定义配置生成器、解析工具或配置修改脚本时,请同步适配新的 Plugin 路径。​
  • containerd 2.3.x 使用的 runc v1.4.x 调整了pids.limit的处理方式:显式设置为0时,不再表示“不限制”,而会作为实际限制值处理,在 systemd 环境下等同于1。升级前请检查相关运行时配置;如需不限制进程数,请设置为-1或不配置该字段。​
  • 从 containerd 1.6.x 或 2.1.x 升级到 2.3.x 时,系统仅迁移 VKE 支持的关键配置,例如 Sandbox 镜像、SystemdCgroup、GPU 运行时和 Nydus 相关配置,不保证完整保留所有自定义配置。升级前请核对节点池的自定义 containerd 配置,详情请参见 配置节点池 containerd 参数。​
废弃功能和 API​
  • 移除了 NRI v0.1 插件支持。使用自定义 NRI 插件时,请先确认插件版本与 containerd 2.3 兼容。使用 NRI v0.1 API 的自定义插件需升级至当前 NRI API;短期无法完成升级时,可评估使用v010-adapter进行兼容。使用适配器前,请在测试环境验证插件功能和稳定性。​
  • NRI 插件名称仅支持字母、数字以及-、_、.、+字符。名称包含其他字符的插件无法注册。​
  • cgroup v1 已标记为废弃。建议使用 cgroup v2。​
  • enable_cdi配置项已废弃。containerd 2.3 仍识别该配置项,但显式关闭容器设备接口(Container Device Interface,CDI)会产生废弃警告。CDI 计划从 containerd 2.4 起始终启用,依赖关闭 CDI 的环境需提前完成兼容性评估。​
  • 通过 CRI CreateContainer从 checkpoint image 恢复容器的实验性能力默认关闭且已废弃,计划在后续版本中移除。如现有业务仍依赖该能力,可临时设置enable_experimental_restore_via_create = true,同时确保enable_criu = true且 CRIU 版本不低于 3.16。该方式仅用于过渡,后续需迁移至 KEP-5823 定义的RestorePod API。​
  • shim.CommandAPI 已废弃,计划在后续版本中移除。自定义 Shim 应迁移到 Shim Bootstrap Protocol。​
​
最近更新时间:2026.09.30 15:54:41
这个页面对您有帮助吗?
有用
有用
无用
无用