KubeBlocks — 简化 Kubernetes 上的数据库管理

何时使用本技能

在以下情况下使用本技能：

• 用户需要数据库，且已拥有（或愿意搭建）Kubernetes 环境
• 用户提出“搭建”、“创建”、“部署”、“启动”或“配置”一个运行于 Kubernetes 上的数据库
• 用户在部署或运维上下文中提到了某类数据库引擎（如 MySQL、PostgreSQL、Redis、MongoDB、Kafka、Elasticsearch、Milvus、Qdrant、RabbitMQ 等）
• 用户需要在 K8s 上执行数据库运维操作：扩缩容、备份、恢复、监控、故障转移、参数调优等
• 用户正在排查由 KubeBlocks 托管的数据库问题
• 用户直接提及 KubeBlocks

不建议使用本技能的情形：若用户仅需一个已有托管数据库服务（例如 AWS RDS、Google Cloud SQL）的连接字符串，或希望绕过 Kubernetes、直接通过 Docker Compose 运行数据库，则本技能不适用。

若用户尚未拥有 Kubernetes 集群但有此需求，本技能集包含为开发与测试目的创建本地 K8s 集群的能力。

什么是 KubeBlocks？

KubeBlocks 是一个 Kubernetes Operator，可在任意 K8s 集群上统一管理 30+ 种数据库引擎。它提供一套标准化 API，覆盖关系型、NoSQL、流式、向量及图数据库的全生命周期管理——从初始配置、扩缩容，到备份恢复与可观测性。

• 官方文档：https://kubeblocks.io/docs/preview/user_docs/overview/introduction
• 完整 LLM 文档索引：https://kubeblocks.io/llms-full.txt
• GitHub 仓库：https://github.com/apecloud/kubeblocks

快速状态检查

执行任何操作前，请先验证当前环境状态：

# 检查 KubeBlocks 是否已安装
kubectl -n kb-system get pods

# 列出所有命名空间下的数据库集群
kubectl get cluster -A

# 查看 KubeBlocks 版本
helm list -n kb-system | grep kubeblocks

若 KubeBlocks 尚未安装，请先使用 install-kubeblocks 技能；若完全不存在 Kubernetes 集群，则应首先执行 create-local-k8s-cluster。

技能映射表

请根据用户意图选择对应技能。每个技能均为自包含指南，含 YAML 模板、分步工作流及排障说明。

入门准备

创建数据库

日常运维（Day-2 Operations）

数据保护

安全与网络

可观测性

故障排查

决策树

当用户意图不够明确时，请参考此流程图进行判断：

用户需要一个数据库
├─ KubeBlocks 是否已安装？
│  ├─ 否 → 用户是否有 K8s 集群？
│  │        ├─ 否 → create-local-k8s-cluster → install-kubeblocks
│  │        └─ 是 → install-kubeblocks
│  └─ 是 → 继续向下
│
├─ 创建数据库
│  ├─ 对应引擎插件是否已安装？
│  │  ├─ 否 → manage-addons → 再创建集群
│  │  └─ 是 → 使用哪种引擎？
│  │           ├─ MySQL/PG/Redis/MongoDB/Kafka/ES/Milvus/Qdrant/RabbitMQ → addon-{engine}
│  │           └─ 其他 → create-cluster（通用方式）
│  └─ 尚未确定引擎？→ 根据使用场景推荐：
│     ├─ 关系型 / SQL 应用         → addon-postgresql 或 addon-mysql
│     ├─ 缓存 / 会话存储           → addon-redis
│     ├─ 文档存储                 → addon-mongodb
│     ├─ 事件流处理               → addon-kafka
│     ├─ 全文检索 / 日志分析       → addon-elasticsearch
│     ├─ 向量相似性搜索 / RAG      → addon-milvus 或 addon-qdrant
│     └─ 消息队列                 → addon-rabbitmq 或 addon-kafka
│
├─ 运维已有数据库
│  ├─ 调整 CPU / 内存            → vertical-scaling
│  ├─ 增减副本                   → horizontal-scaling
│  ├─ 扩展磁盘容量               → volume-expansion
│  ├─ 修改数据库配置             → reconfigure-parameters
│  ├─ 主节点切换                 → switchover
│  ├─ 升级数据库版本             → minor-version-upgrade
│  ├─ 重建失败副本               → rebuild-replica
│  ├─ 停止 / 启动 / 重启          → cluster-lifecycle
│  └─ 永久删除集群               → delete-cluster
│
├─ 数据保护
│  ├─ 备份                       → backup
│  └─ 恢复 / 时间点恢复（PITR）   → restore
│
├─ 数据库安全加固
│  ├─ 管理账号密码               → manage-accounts
│  ├─ 启用 TLS/SSL               → configure-tls
│  └─ 对外暴露服务               → expose-service
│
├─ 监控配置                    → setup-monitoring
├─ 升级 KubeBlocks 自身         → upgrade-kubeblocks
└─ 出现异常                     → troubleshoot

数据库引擎选型指南

当用户需要数据库但尚未选定具体引擎时，可根据其使用场景推荐如下：

术语消歧指南

“Scale（扩缩容）”含义模糊时

“Delete（删除）” vs “Stop（停止）”

“Upgrade（升级）”含义模糊时

安全实践规范

在执行任何影响集群的操作前，请查阅 safety-patterns 参考指南。关键规则如下：

• 应用前执行 Dry-run（试运行）：所有 kubectl apply 操作前，务必先运行 kubectl apply --dry-run=server。
• 破坏性操作需显式确认：删除、缩容、停止及 terminationPolicy 更改等操作，必须获得用户明确确认；执行前应先列出相关备份与受影响资源。
• 凭证处理规范：如 kubectl get secret ... -o jsonpath 类命令会暴露数据库密码。仅在用户明确请求凭证时才执行，并须提前警示输出含敏感信息。
• 谨慎使用 kubectl exec：进入数据库 Pod（kubectl exec -it）将获得对生产数据的 Shell 访问权限，执行前必须获得用户确认。
• 生产环境防护：对设置 terminationPolicy: DoNotTerminate 的集群应格外审慎。在执行高风险操作（如升级、主从切换、参数重配）前，强烈建议先完成备份。

常用调试命令

kubectl describe cluster  -n 
kubectl get opsrequest -n 
kubectl get component -n 
kubectl logs -n   -c 
kubectl -n kb-system logs -l app.kubernetes.io/name=kubeblocks --tail=100

文档链接