Cass Operator 技术文档

概述

Cass Operator 是一个基于 Kubernetes 的云原生操作器（Operator），提供 API 服务用于管理 Apache Cassandra 和 DataStax Enterprise（DSE）的数据中心与集群。该操作器仅在单个本地 Kubernetes 集群范围内运行，专注于简化集群的部署、配置与全生命周期管理。

Cass Operator 是 K8ssandra 项目的核心组件。K8ssandra 是一系列云原生项目的集合，旨在实现在 Kubernetes 上高效运行 Apache Cassandra，提供数据库部署、反熵修复、可观测性集成及备份恢复等完整功能栈。

核心功能与特性

• 集群生命周期管理：通过 Kubernetes API 对象实现 Apache Cassandra/DSE 数据中心的创建、扩缩容、版本升级与删除。
• K8ssandra 生态集成：作为 K8ssandra 项目的一部分，支持反熵修复服务（保障节点数据一致性）、可观测性钩子（如监控指标暴露）及备份/恢复功能。
• 声明式配置：基于 Kubernetes CustomResourceDefinition（CRD）定义集群状态，通过 Operator 自动协调实际状态与期望状态。
• 容器化部署优化：针对 Kubernetes 环境优化容器配置，支持资源限制、存储配置等原生特性。

使用场景与适用范围

适用场景

• 在单个 Kubernetes 集群内部署和管理 Apache Cassandra 或 DataStax Enterprise 集群。
• 需要通过 Kubernetes API 简化数据库集群运维（如自动化扩缩容、故障自愈）的场景。
• 集成 K8ssandra 生态工具（如监控、备份）构建完整 Cassandra 云原生部署方案。

限制说明

• 单集群局限：仅支持管理单个本地 Kubernetes 集群内的资源，不支持跨集群或多区域部署。
• 多区域需求：若需部署和管理跨区域集群，建议使用 K8ssandra Operator。

使用方法与配置说明

Cass Operator 依赖 Kubernetes API 服务运行，不支持独立部署。以下为关键操作指南：

安装方式

Helm 安装

通过 Helm Chart 快速部署，详情参见 Helm 安装文档。

Kustomize 安装

使用 Kustomize 管理部署配置，步骤参见 Kustomize 安装文档。

OLM/OpenShift 安装

支持通过 Operator Lifecycle Manager（OLM）安装，或直接部署至 OpenShift 集群，参见 OLM 安装文档。

配置说明

可通过覆盖 Cass Operator 创建的容器属性自定义配置（如资源限制、环境变量），具体参数参见 配置文档。

集群管理

创建 Cassandra 集群

通过定义 CassandraDatacenter CR（自定义资源）创建集群，示例及步骤参见 创建 Cassandra 集群文档。

CassandraDatacenter CRD 参考

CassandraDatacenter 是定义数据中心配置的核心 CRD，包含节点数量、存储配置、镜像版本等关键参数，完整参考见 CRD 文档。

许可证

Cass Operator 采用 Apache 软件许可证 授权。