k8ssandra/medusa-operator

Medusa Operator 镜像文档

概述

Medusa Operator是K8ssandra项目的核心组件之一。K8ssandra是一套用于在Kubernetes上运行Apache Cassandra的云原生解决方案集合，提供Apache Cassandra部署、反熵修复服务、可观测性钩子以及备份/恢复功能。Medusa Operator专门负责通过Kubernetes API对象管理Cassandra集群的备份与恢复操作，为云原生环境下的Cassandra部署提供可靠的数据保护机制。

核心功能与特性

• 备份与恢复管理：提供Cassandra集群备份的创建、存储和恢复全生命周期管理
• Kubernetes API集成：通过自定义资源(CR)和Kubernetes API对象实现声明式备份/恢复配置
• 云原生架构：遵循Kubernetes Operator模式，支持自动运维、自愈能力和动态扩缩容
• 生态系统整合：与K8ssandra其他组件（如Cassandra部署、反熵修复服务）无缝协作
• 可观测性支持：提供备份/恢复操作的监控指标和日志，便于集成到可观测性系统

使用场景与适用范围

• 企业级Cassandra部署：在Kubernetes集群中运行的生产环境Cassandra集群的数据保护
• 云原生数据管理：需要通过Kubernetes API统一管理数据备份与恢复的场景
• 灾备策略实施：为Cassandra集群建立定期备份和灾难恢复机制
• 环境迁移：支持开发、测试和生产环境之间的Cassandra数据迁移
• CI/CD集成：可集成到自动化部署流程中，实现备份/恢复操作的自动化

使用方法与配置说明

部署前提

• Kubernetes集群（版本1.19及以上）
• 已部署K8ssandra（Medusa Operator通常作为K8ssandra的一部分部署）
• 备份存储系统（如S3、GCS、Azure Blob Storage等）

部署方式

Medusa Operator通常通过K8ssandra的Helm Chart进行部署：

1. 添加K8ssandra Helm仓库：

   bash
   helm repo add k8ssandra https://helm.k8ssandra.io/stable
   helm repo update
   

2. 安装K8ssandra（包含Medusa Operator）：

   bash
   helm install k8ssandra k8ssandra/k8ssandra -n k8ssandra --create-namespace
   

配置备份与恢复

通过创建Kubernetes自定义资源来配置备份和恢复操作。

创建备份示例

创建CassandraBackup资源以触发备份：

yaml
apiVersion: medusa.k8ssandra.io/v1alpha1
kind: CassandraBackup
metadata:
  name: cassandra-backup-01
  namespace: k8ssandra
spec:
  cassandraCluster: k8ssandra
  storageLocation: s3://my-cassandra-backups/
  concurrentConnections: 5
  backupType: full

创建恢复示例

创建CassandraRestore资源以恢复数据：

yaml
apiVersion: medusa.k8ssandra.io/v1alpha1
kind: CassandraRestore
metadata:
  name: cassandra-restore-01
  namespace: k8ssandra
spec:
  cassandraCluster: k8ssandra
  backup: cassandra-backup-01
  storageLocation: s3://my-cassandra-backups/
  inPlace: true

主要配置参数

Medusa Operator的配置主要通过K8ssandra Helm values文件进行设置，关键参数包括：

• medusa.enabled：是否启用Medusa Operator（默认值：true）
• medusa.storage：备份存储类型（支持：s3、gcs、azure_blob、local）
• medusa.storageProperties：存储服务配置（如S3的accessKeyId、secretAccessKey、region等）
• medusa.backupSchedule：自动备份调度（如"0 3 * * *"表示每天凌晨3点执行）
• medusa.retentionPolicy：备份保留策略（如"7d"表示保留7天）
• medusa.concurrentConnections：备份/恢复时的并发连接数

注意事项

• 确保备份存储位置具有适当的访问权限，以便Medusa Operator能够读写备份数据
• 备份操作会消耗集群资源，建议在业务低峰期执行
• 定期验证备份数据的完整性和可恢复性
• 对于大型集群，考虑使用增量备份以减少存储占用和备份时间