chrishirsch/kuberhealthy-storage-check
chrishirsch
使用Kuberhealthy框架的Kubernetes持久卷声明(PVC)健康检查工具，用于监控PVC的可用性与功能状态。
下载次数: 0状态：社区镜像维护者：chrishirsch仓库类型：镜像最近更新：2 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Kuberhealthy Storage Check 镜像文档
镜像概述
Kuberhealthy Storage Check是一个基于Kuberhealthy框架的Kubernetes健康检查工具，专门用于监控持久卷声明(PVC)的健康状态。该工具通过模拟实际应用对PVC的操作，验证PVC的创建、挂载及读写功能是否正常，帮助集群管理员及时发现存储相关问题。
核心功能与特性
- PVC全生命周期检查：验证PVC从创建、绑定到挂载的完整流程
- 读写性能测试：对PVC执行基本读写操作，确认存储功能正常
- Kuberhealthy集成：无缝对接Kuberhealthy健康检查框架，支持结果上报与告警
- 可配置检查参数：支持自定义检查间隔、超时时间及测试数据大小
- 轻量级设计：资源占用低，适合在生产环境长期运行
使用场景
- Kubernetes集群存储健康状态监控
- 存储类(StorageClass)功能验证
- PVC动态配置有效性检测
- 存储故障的早期预警与诊断
- 集群升级或存储配置变更后的功能验证
使用方法与配置说明
前提条件
- 运行中的Kubernetes集群(1.16+)
- 已部署Kuberhealthy框架(参考https://github.com/Comcast/kuberhealthy)
- 具有适当权限的Service Account(需创建PVC、Pod等资源)
部署方式
通过Kubernetes资源清单部署，示例如下：
yamlapiVersion: comcast.github.io/v1 kind: KuberhealthyCheck metadata: name: storage-check namespace: kuberhealthy spec: runInterval: 30m # 检查间隔 timeout: 15m # 检查超时时间 podSpec: containers: - name: storage-check image: chris Hirsch/kuberhealthy-storage-check:latest # 替换为实际镜像地址 resources: requests: cpu: 10m memory: 50Mi limits: cpu: 100m memory: 100Mi env: - name: STORAGE_CLASS value: "standard" # 指定要测试的存储类 - name: TEST_FILE_SIZE value: "10M" # 测试文件大小 - name: MOUNT_PATH value: "/test" # PVC挂载路径
应用配置：
bashkubectl apply -f storage-check.yaml
配置参数说明
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| STORAGE_CLASS | 要测试的存储类名称 | "standard" |
| TEST_FILE_SIZE | 读写测试文件大小 | "10M" |
| MOUNT_PATH | PVC挂载路径 | "/test" |
| CHECK_TIMEOUT | 单次检查超时时间 | "5m" |
| PVC_NAME_PREFIX | 测试PVC名称前缀 | "kh-storage-check-" |
| CLEANUP_ON_SUCCESS | 检查成功后清理测试资源 | "true" |
结果查看
检查结果可通过Kuberhealthy的CRD状态查看：
bashkubectl get khc storage-check -n kuberhealthy -o yaml
正常状态下，Status.State字段将显示为"OK"；若检查失败，Status.Message将包含详细错误信息。
项目地址
更多详细信息与源码，请访问：https://github.com/ChrisHirsch/kuberhealthy-storage-check
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 kuberhealthy-storage-check 镜像标签
docker pull docker.xuanyuan.run/chrishirsch/kuberhealthy-storage-check:<标签>
DockerHub 原生拉取命令
docker pull chrishirsch/kuberhealthy-storage-check:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"