讲师中心 微信公众号
AI工具推荐 视频效率加速

ContainerRuntime底层接口调用与容器创建流程

大萱君_9105

大萱君_9105

发布时间:2026-03-21 13:41:30

|

602人浏览过

|

来源于php中文网

原创

CreateContainer 卡在 WaitForAttach 是因 CSI 卷挂载误判:Pod 未定义 volumeMounts 或 hostPath.type 为空,导致 runtime 错误等待 attach;需检查 volumes 合法性、hostPath.type 显式设置,并确认 runtime 未全局启用 unsafe IO。

containerruntime底层接口调用与容器创建流程

ContainerRuntime 接口调用时为什么 CreateContainer 总卡在 WaitForAttach?

因为底层 runtime(比如 containerd)默认等待 CSI 插件完成卷挂载,但你的 Pod 没定义 volumeMounts 或用了 hostPath 却没配 hostPath.type,导致 attach 阶段误判为需要等待。

  • 检查 Pod.spec.volumes 是否存在且类型合法;hostPath 必须显式设 type: DirectoryOrCreate 等,空值会触发 attach 流程
  • 若确实无需卷,确认 runtime 配置里没全局开启 enable_unsafe_io 或类似 hook,某些定制版 containerd 会强制注入 attach 步骤
  • ctr -n k8s.io containers list 查看容器状态是否卡在 CREATING;再用 ctr -n k8s.io tasks ls 看对应 task 是否 pending —— pending 就说明还没进 OCI runtime exec 阶段

containerd 中 runtime.v1.RuntimeService.CreateContainer 实际触发哪几个关键步骤?

它不是直通 runc,而是分三段:先由 containerd-shim 创建 sandbox 容器(pause 进程),再调 oci.Create 写 config.json 和 rootfs,最后才调 runc create。中间任一环失败都会让上层报 Failed to create container 而非具体错误。

  • config.json 生成依赖 RuntimeOptions(如 systemd_cgroup = true),错配会导致 runc 启动时报 invalid argument,但 containerd 日志只记 failed to create container
  • sandbox 容器未就绪时,CreateContainer 会阻塞在 WaitSandboxReady —— 不是 bug,是设计行为,可通过 ctr -n k8s.io tasks ps <sid></sid> 确认 pause 进程是否已 running
  • OCI spec 中 linux.resources.memory.limit_bytes 设为 0 表示不限制,但某些老版本 runc 会拒绝该值,需设为 -1 或明确数值

为什么 runc create --bundle 成功,但 containerd 调用 CreateContainer 却报 no such file or directory?

路径问题。containerd 默认把 bundle 解压到 /run/containerd/io.containerd.runtime.v2.task/k8s.io/<id>/rootfs</id>,而你手动测试时用的 bundle 是相对路径或挂载点不在预期位置。

  • 务必确认 rootfs.path 在 OCI config.json 中是绝对路径,且 containerd 进程有读权限(尤其 SELinux 启用时,ls -Z 看上下文是否匹配 container_file_t)
  • 不要复用 docker export 出来的 tar 包——它缺 config.json 或格式不兼容 v1.0.0+ OCI 规范;要用 ctr images export 或 crictl pull + crictl inspect 拿标准 bundle
  • containerd 的 root 配置项(如 /var/lib/containerd)决定了所有 runtime 数据存放位置,改过这个值后,ctr 命令必须加 --address 指向对应 socket,否则找不到 bundle

Kubernetes 调 RuntimeService.CreateContainer 时传的 LinuxContainerConfig 哪些字段会被忽略?

containerd 会直接丢弃 LinuxContainerConfig.security_context 里的大部分字段,包括 seccomp_profile(除非启用 seccomp plugin)、apparmor_profile(需加载 apparmor parser)、proc_mount(v1.6+ 才支持)。

  • security_context.capabilities.add 有效,但 drop 列表若含 ALL,containerd 会静默转成默认 drop-list,不会报错
  • linux_container_config.resources 中的 hugepage_limits 只在 cgroup v2 + kernel ≥5.11 下生效,低版本直接跳过,不提示
  • annotations 字段全量透传给 shim,但只有以 io.kubernetes. 开头的才会被 kubelet 解析;其他自定义注解得靠自己写 shim plugin 拦截

真正难调试的是 shim 层对 OCI spec 的二次解释 —— 比如 systemd cgroup driver 下,cgroups_path 会被重写成 /kubepods.slice/kubepods-burstable.slice/...,但日志里从不打印这个重写结果。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2235

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3562

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1196

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4099

2025.09.10

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3208

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

5189

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3849

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

486

2026.01.19

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

100

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn