aivenoy/aiven-operator

Aiven Operator for Kubernetes

概述

Aiven Operator for Kubernetes是一个Kubernetes Operator，允许用户直接从Kubernetes集群中配置、部署和管理Aiven服务。通过Kubernetes自定义资源定义（CRD），用户可以采用声明式方式管理Aiven服务的全生命周期，实现与Kubernetes环境的无缝集成。

核心功能和特性

• 声明式管理：通过Kubernetes CRD定义Aiven服务规格，支持声明式配置与自动协调
• 全生命周期支持：管理Aiven服务（如PostgreSQL、Kafka、Redis等）的创建、更新和删除
• 状态自动同步：实时同步Aiven服务状态至Kubernetes资源，提供准确的状态反馈
• Kubernetes生态集成：与Kubernetes RBAC、Secrets等原生功能集成，安全管理Aiven凭证
• 配置一致性：确保Aiven服务配置与Kubernetes资源定义保持一致，支持版本控制与回滚

使用场景和适用范围

• 需在Kubernetes环境中统一管理Aiven服务的开发与运维团队
• 采用基础设施即代码（IaC）策略，需要声明式配置服务的组织
• 需将Aiven服务（数据库、消息队列等）与Kubernetes应用紧密集成的场景
• 希望通过Kubernetes API统一监控和管理所有服务资源的用户

使用方法和配置说明

前提条件

• Kubernetes集群（版本1.21+）
• Aiven账户及API凭证（从Aiven控制台获取）
• kubectl命令行工具
• Helm（可选，用于简化安装）

安装Operator

通过Helm安装（推荐）：

bash
helm repo add aiven https://aiven.github.io/helm-charts
helm repo update
helm install aiven-operator aiven/aiven-operator --namespace aiven-operator --create-namespace

配置Aiven凭证

创建包含Aiven API令牌和项目信息的Secret：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: aiven-token
  namespace: default
type: Opaque
stringData:
  token: "your-aiven-api-token"  # 替换为实际Aiven API令牌
  project: "your-aiven-project"  # 替换为实际Aiven项目名称

创建Aiven服务示例

以下示例创建Aiven PostgreSQL服务：

yaml
apiVersion: aiven.io/v1alpha1
kind: PostgreSQL
metadata:
  name: my-aiven-postgres
spec:
  project: your-aiven-project  # 与Secret中的project一致
  serviceName: my-postgres-service  # Aiven服务名称
  cloudName: google-europe-west1  # 云服务区域
  plan: startup-4  # Aiven服务计划
  maintenanceWindowDow: monday  # 维护窗口（星期）
  maintenanceWindowTime: 03:00:00  # 维护窗口（时间）
  tags:
    environment: production

应用配置：

bash
kubectl apply -f postgresql-service.yaml

查看服务状态

bash
kubectl get postgresql my-aiven-postgres -o yaml

更多信息

详细文档和完整配置选项请参见https://github.com/aiven/aiven-operator%E3%80%82