Kubernetes中JupyterHub Pod内两容器共享目录配置异常排查

核心配置错误 #

• mountPath格式错误：extraVolumeMounts中的mountPath: '/mnt/space:shared'是错误写法，:shared是Docker的bind mount参数，Kubernetes中同一Pod下的容器挂载同一个Volume默认就是共享的，无需额外标记，应修改为/mnt/space。
• 卷内容填充逻辑缺失：当前配置里的space卷是emptyDir（Pod内临时存储），默认是空的。需要确保容器B的镜像内包含正确的脚本，能把远程存储空间挂载到/mnt/space路径下，否则容器A挂载后自然看不到内容。

修正后的配置示例 #

singleuser:
  memory:
    limit: 2G
    guarantee: 2G
  cpu:
    limit: 2
    guarantee: 2
  extraContainers:
    - name: B
      image: <myimage>
      # 添加启动脚本确保远程存储挂载并维持容器运行
      command: ["/bin/sh", "-c", "your-remote-mount-command && tail -f /dev/null"]
      volumeMounts:
        - name: space
          mountPath: '/mnt/space/'

  storage:
    extraVolumes:
      - name: space
        emptyDir:
          sizeLimit: 20Gi
    extraVolumeMounts:
      - name: space
        mountPath: '/mnt/space'

    capacity: 20Gi
    dynamic:
      pvcNameTemplate: claim-{username}{servername}
      volumeNameTemplate: vol-{username}{servername}
      storageAccessModes: ["ReadWriteMany"]

额外验证步骤 #

• 确认容器B的镜像包含远程存储挂载工具（如s3fs、sshfs、nfs-utils等），且启动脚本能正常完成挂载。
• 查看容器B的日志排查挂载错误：kubectl logs <目标pod名> -c B
• 进入容器B检查挂载路径内容：kubectl exec <目标pod名> -c B -- ls /mnt/space
• 进入容器A验证共享内容：kubectl exec <目标pod名> -c notebook -- ls /mnt/space

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