CSI 工作负载配置故障排除
本指南提供了诊断和解决在工作负载中挂载 OCI 注册表配置时,Connectors CSI Driver 常见问题的详细步骤。
目录
常见问题概览检查 CSI 卷配置验证卷挂载查看 Pod 事件查找生成的 OCI 配置文件检查 Docker 配置内容docker-configdockerd 配置buildkitd 配置非安全注册表问题高级故障排除CSI 驱动日志代理服务日志使用诊断 Pod 进行测试其他资源常见问题概览
检查 CSI 卷配置
验证工作负载 YAML 中的 CSI 卷配置:
常见配置选项:
常见配置问题:
如何验证:
验证卷挂载
检查卷挂载配置是否正确:
不同配置的常用挂载路径:
查看 Pod 事件
检查 Pod 事件中与挂载相关的问题:
常见错误信息及解决方案:
示例错误及解决方案:
解决方案:创建 Connector 或修正卷属性中的 Connector 名称。
查找生成的 OCI 配置文件
定位配置文件:
如果未找到配置文件,请检查:
- 卷挂载是否成功
- CSI 驱动是否健康
- ServiceAccount 是否有权限
- Connector 是否 Ready
- 挂载路径是否与容器用户预期路径匹配
检查 Docker 配置内容
docker-config
检查生成的 config.json 文件:
预期配置内容:
dockerd 配置
检查生成的 daemon.json 文件:
预期配置内容:
buildkitd 配置
检查生成的 buildkitd.toml 文件:
预期配置内容:
非安全注册表问题
症状:
- 出现
server certificate verification failed错误 - TLS 握手失败
排查步骤:
-
验证非安全注册表设置是否正确配置:
-
检查容器运行时是否使用了挂载的配置:
-
对于 containerd,验证代理地址配置是否正确:
高级故障排除
CSI 驱动日志
查看 CSI 驱动日志以获取详细错误信息:
代理服务日志
查看代理服务日志以排查认证或访问问题:
使用诊断 Pod 进行测试
创建诊断 Pod 测试 OCI 功能: