kinetica/kinetica-k8s-operator

Kinetica DB Kubernetes Operator 文档

1. 镜像概述和主要用途

Kinetica DB Kubernetes Operator（以下简称"Operator"）是专为在Kubernetes集群中管理Kinetica分布式数据库而设计的工具。它基于Kubernetes的自定义资源定义（CRD）和控制器模式，实现了Kinetica数据库的自动化部署、扩缩容、升级、备份恢复等全生命周期管理，旨在降低Kubernetes环境下数据库运维复杂度，提升管理效率和系统可靠性。

2. 核心功能和特性

2.1 自动化生命周期管理

• 一键部署：通过自定义资源（CR）配置，自动完成Kinetica集群的初始化部署，包括数据库节点、配置文件、存储卷等资源的创建
• 版本升级：支持Kinetica数据库版本的平滑升级，自动化处理升级流程，减少业务中断
• 销毁清理：删除CR时自动清理相关Kubernetes资源（Pod、Service、PVC等），避免资源残留

2.2 高可用性保障

• 自动故障转移：监控数据库节点健康状态，当检测到故障节点时自动触发故障转移，确保服务持续可用
• 副本管理：支持配置多副本集群，通过Kubernetes原生调度实现跨节点部署，避免单点故障
• 健康检查：内置数据库健康检查机制，实时监控集群状态，异常时触发告警或自愈操作

2.3 弹性伸缩能力

• 水平扩缩容：根据业务需求通过修改CR配置动态调整数据库节点数量，支持无感知扩容
• 资源动态调整：可配置CPU、内存等资源限制，支持根据负载变化调整资源分配

2.4 运维自动化

• 备份与恢复：支持配置自动备份策略，集成Kubernetes存储系统实现数据备份和恢复
• 配置管理：通过CR参数集中管理数据库配置，支持动态配置更新（无需重启集群）
• 监控集成：暴露Prometheus指标接口，支持与Grafana等监控平台集成，实现集群状态可视化

3. 使用场景和适用范围

3.1 适用场景

• 企业级分布式数据库部署：需要在Kubernetes环境中运行高性能分布式数据库的企业级应用
• 自动化运维需求：希望减少数据库部署、扩缩容、升级等人工操作的场景
• 高可用关键业务：对数据库服务可用性要求高（如***、电商核心业务），需要自动故障转移能力的场景
• 弹性业务负载：业务负载波动大，需要根据实际需求动态调整数据库资源的场景

3.2 适用范围

• Kubernetes集群版本：1.19+
• Kinetica DB版本：支持官方指定的兼容版本（具体版本需参考Operator发布说明）
• 存储需求：支持Kubernetes PersistentVolume（PV），推荐使用支持动态供应的存储类（StorageClass）

4. 使用方法和配置说明

4.1 前提条件

• 已部署Kubernetes集群（1.19+）
• 已安装kubectl命令行工具并配置集群访问权限
• 集群中已配置可用的StorageClass（用于自动创建PV）

4.2 部署Operator

4.2.1 安装CRD

首先创建Kinetica DB的自定义资源定义：

bash
kubectl apply -f https://raw.githubusercontent.com/kinetica/kinetica-operator/main/config/crd/bases/kinetica.com_kineticadbs.yaml

4.2.2 部署Operator控制器

通过kubectl部署Operator控制器（示例使用默认命名空间）：

bash
kubectl apply -f https://raw.githubusercontent.com/kinetica/kinetica-operator/main/config/manager/manager.yaml

4.2.3 验证Operator部署状态

检查Operator Pod是否正常运行：

bash
kubectl get pods -l control-plane=controller-manager

4.3 创建Kinetica DB集群

4.3.1 创建自定义资源（CR）配置文件

创建kinetica-db.yaml文件，示例配置：

yaml
apiVersion: kinetica.com/v1alpha1
kind: KineticaDB
metadata:
  name: kinetica-cluster
spec:
  # 副本数（建议至少3个以保证高可用）
  replicaCount: 3
  # 数据库版本
  version: "7.1.0"
  # 资源配置
  resources:
    requests:
      cpu: "2"
      memory: "8Gi"
    limits:
      cpu: "4"
      memory: "16Gi"
  # 存储配置
  storage:
    storageClass: "standard"  # 指定存储类
    size: "100Gi"             # 每个节点存储大小
  # 网络配置
  service:
    type: ClusterIP  # 服务类型（ClusterIP/NodePort/LoadBalancer）
  # 高可用配置
  highAvailability:
    enabled: true
    # 自动故障转移超时时间（秒）
    failoverTimeout: 300

4.3.2 部署Kinetica DB集群

应用CR配置文件创建数据库集群：

bash
kubectl apply -f kinetica-db.yaml

4.3.3 查看集群状态

检查集群部署进度和状态：

bash
# 查看KineticaDB CR状态
kubectl get kineticadbs kinetica-cluster -o yaml

# 查看数据库节点Pod
kubectl get pods -l app=kinetica-cluster

4.4 集群管理操作

4.4.1 扩缩容集群

修改CR的replicaCount字段并应用，实现节点数量调整：

bash
# 编辑CR
kubectl edit kineticadbs kinetica-cluster
# 修改spec.replicaCount为目标值（如5），保存退出后Operator将自动调整节点数量

4.4.2 版本升级

更新CR的version字段至目标版本，Operator将执行滚动升级：

bash
kubectl patch kineticadbs kinetica-cluster -p '{"spec":{"version":"7.2.0"}}' --type=merge

4.4.3 删除集群

删除CR将触发集群资源清理：

bash
kubectl delete kineticadbs kinetica-cluster

4.5 核心配置参数说明