k8ssandra/cass-operator

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 集群内的资源，不支持跨集群或多区域部署。
• 多区域需求：若需部署和管理跨区域集群，建议使用 https://hub.docker.com/r/k8ssandra/k8ssandra-operator%E3%80%82

使用方法与配置说明

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

安装方式

Helm 安装

通过 Helm Chart 快速部署，详情参见 https://github.com/k8ssandra/cass-operator#installing-the-operator-with-helm%E3%80%82

Kustomize 安装

使用 Kustomize 管理部署配置，步骤参见 https://github.com/k8ssandra/cass-operator#installing-the-operator-with-kustomize%E3%80%82

OLM/OpenShift 安装

支持通过 Operator Lifecycle Manager（OLM）安装，或直接部署至 OpenShift 集群，参见 https://github.com/k8ssandra/cass-operator#installing-the-operator-with-operator-lifecycle-manager-or-installing-to-openshift%E3%80%82

配置说明

可通过覆盖 Cass Operator 创建的容器属性自定义配置（如资源限制、环境变量），具体参数参见 https://github.com/k8ssandra/cass-operator#overriding-properties-of-cass-operator-created-containers%E3%80%82

集群管理

创建 Cassandra 集群

通过定义 CassandraDatacenter CR（自定义资源）创建集群，示例及步骤参见 https://github.com/k8ssandra/cass-operator#creating-a-cassandra-cluster%E3%80%82

CassandraDatacenter CRD 参考

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

许可证

Cass Operator 采用 https://github.com/k8ssandra/cass-operator/blob/master/LICENSE.txt 授权。