Kubernetes中MongoDB ConfigMap无法挂载至/etc/mongod.conf问题排查

核心问题排查 #

你提到用临时Pod检查到/etc/mongod.conf不存在，但这个临时Pod是未挂载ConfigMap的全新容器，和故障Pod的环境完全不同——故障Pod的挂载结果需要直接查看目标Pod的文件系统，而非新启动的无挂载容器。

1. 为何ConfigMap无法按预期挂载至/etc/mongod.conf？ #

可能的原因及验证步骤：

• 挂载未生效（需直接检查故障Pod）：
  执行以下命令查看故障Pod内的实际文件情况：

  kubectl exec -it mongo-config-0 -- ls -l /etc/mongod.conf
  kubectl exec -it mongo-config-0 -- cat /etc/mongod.conf
  

  如果文件不存在，查看Pod事件获取挂载错误信息：

  kubectl describe pod mongo-config-0
  

  重点关注Events段是否有Failed to mount volume类的错误提示。
• ConfigMap的key名称不匹配：
  确认ConfigMap内的key是否为mongod.conf（你用--from-file=mongod.conf创建的话，key默认是文件名）：

  kubectl get configmap mongo-config -o yaml
  

  检查data字段下是否存在mongod.conf，且内容正确。
• 权限或SELinux限制：
  默认情况下，ConfigMap挂载的文件权限为0644，mongodb用户（容器默认运行用户）拥有读取权限；如果集群启用了SELinux，可能需要调整挂载的securityContext，但这种情况较少见。

2. 是否需要提前确保/etc/mongod.conf存在？ #

不需要。Kubernetes在挂载单个文件时，会自动在容器内创建目标文件并写入ConfigMap中的内容，前提是父目录（这里是/etc）存在且kubelet拥有写入权限（默认满足）。

修复建议 #

1. 修正挂载配置（可选，提升可靠性）
   保持挂载逻辑不变，但可以调整写法更直观（效果与原配置一致）：

   volumeMounts:
     - name: mongo-config-file
       mountPath: /etc/mongod.conf
       subPath: mongod.conf
   

   或改为挂载到目录下指定文件：

   volumeMounts:
     - name: mongo-config-file
       mountPath: /etc/
       subPath: mongod.conf
   

2. 重新部署StatefulSet
   如果确认配置无误，删除旧StatefulSet后重新应用：

   kubectl delete statefulset mongo-config
   kubectl apply -f mongo-config.yaml
   

3. 排查mongod启动失败的深层原因
   如果挂载成功但仍CrashLoopBackOff，查看mongod日志：

   kubectl logs mongo-config-0
   

   检查配置文件是否存在语法错误，或命令行参数（--configsvr/--replSet）与配置文件内容冲突。

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