GKE自动集群中CouchDB容器启动失败：cpu.weight文件不存在

核心原因：Cgroup版本不兼容 #

GKE Autopilot集群默认采用cgroup v2作为资源管理标准，但CouchDB 3.1.1官方镜像的初始化逻辑是基于cgroup v1设计的，两者的cgroup路径结构、参数体系不匹配，导致容器初始化时无法找到指定的cpu.weight文件路径，触发OCI运行时错误。

具体细节 #

• cgroup v1与v2的路径差异：v1将不同资源控制器（如CPU、内存）拆分到独立的/sys/fs/cgroup/cpu、/sys/fs/cgroup/memory等路径下；而v2将所有资源控制器整合到统一的层级路径中，cpu.weight是v2特有的调度权重参数。CouchDB 3.1.1镜像内的进程或初始化脚本仍在按照v1的逻辑查找或配置cgroup参数，导致路径不存在。
• 旧版本基础镜像的适配问题：CouchDB 3.1.1官方镜像基于较旧的Debian/Ubuntu基础镜像构建，这些基础镜像未针对cgroup v2环境做适配，启动时的资源限制逻辑在v2环境下失效。

验证与修复方向 #

• 验证cgroup版本：在GKE节点执行mount | grep cgroup2，若有输出则确认集群使用cgroup v2。
• 升级镜像版本：使用CouchDB 3.2.0及以上版本的官方镜像，新版本已适配cgroup v2环境，可直接解决该问题。
• 自定义镜像适配（针对必须使用3.1.1的场景）：基于官方镜像修改初始化脚本，调整cgroup参数的读取/配置逻辑以适配v2路径；或临时在Pod的securityContext中开启privileged: true（仅测试用，生产环境不推荐）。

内容的提问来源于stack exchange，提问作者k_o_