ob-operator

ob-operator 是满足 Kubernetes Operator 扩展范式的自动化工具，可以极大简化在 Kubernetes 上部署和管理 OceanBase 集群及相关资源的过程。

快速上手​

这部分以一个简单示例说明如何使用 ob-operator 快速部署 OceanBase 集群。

前提条件​

开始之前请准备一套可用的 Kubernetes 集群，并且至少可以分配 2C, 10G 内存以及 100G 存储空间。

ob-operator 依赖 cert-manager, cert-manager 的安装可以参考对应的安装文档，如果您无法访问官方制品托管在 quay.io 镜像站的镜像，可通过下面的指令安装我们转托在 docker.io 中的制品：

kubectl apply -f https://raw.githubusercontent.com/oceanbase/ob-operator/stable/deploy/cert-manager.yaml

本例子中的 OceanBase 集群存储依赖 local-path-provisioner 提供, 需要提前进行安装并确保其存储目的地有足够大的磁盘空间。如果您计划在生产环境部署，推荐使用其他的存储解决方案。我们在存储兼容性一节提供了我们测试过的存储兼容性结果。

部署 ob-operator​

使用 YAML 配置文件·​

通过以下命令即可在 K8s 集群中部署 ob-operator：

• 稳定版本

kubectl apply -f https://raw.githubusercontent.com/oceanbase/ob-operator/stable/deploy/operator.yaml

• 开发版本

kubectl apply -f https://raw.githubusercontent.com/oceanbase/ob-operator/master/deploy/operator.yaml

使用 Helm Chart​

Helm Chart 将 ob-operator 部署的命名空间进行了参数化，可在安装 ob-operator 之前指定命名空间。

helm repo add ob-operator https://oceanbase.github.io/ob-operator/
helm repo update
helm install ob-operator ob-operator/ob-operator --namespace=oceanbase-system --create-namespace

使用 terraform​

部署所需要的文件放在项目的 deploy/terraform 目录

1. 生成配置变量: 在开始部署前，需要通过以下命令来生成 terraform.tfvars 文件，用来记录当前 Kubernetes 集群的一些配置。

cd deploy/terraform
./generate_k8s_cluster_tfvars.sh

2. 初始化 Terraform: 此步骤用来保证 terraform 获取到必要的 plugin 和模块来管理配置的资源，使用如下命令来进行初始化。

terraform init

3. 应用配置: 执行以下命令开始部署 ob-operator。

terraform apply

验证部署结果​

安装完成之后，可以使用以下命令验证 ob-operator 是否部署成功：

kubectl get pod -n oceanbase-system

# 预期的输出
NAME                                            READY   STATUS    RESTARTS   AGE
oceanbase-controller-manager-86cfc8f7bf-4hfnj   2/2     Running   0          1m

部署 OceanBase 集群​

创建 OceanBase 集群之前，需要先创建好若干 secret 来存储 OceanBase 中的特定用户的密码：

kubectl create secret generic root-password --from-literal=password='root_password'

通过以下命令即可在 K8s 集群中部署 OceanBase：

kubectl apply -f https://raw.githubusercontent.com/oceanbase/ob-operator/stable/example/quickstart/obcluster.yaml

一般初始化集群需要 2 分钟左右的时间，执行以下命令，查询集群状态，当集群状态变成 running 之后表示集群创建和初始化成功：

kubectl get obclusters.oceanbase.oceanbase.com test

# desired output
NAME   STATUS    AGE
test   running   6m2s

连接集群​

通过以下命令查找 observer 的 POD IP，POD 名的规则是 ${cluster_name}-${cluster_id}-${zone}-uuid：

kubectl get pods -o wide

通过以下命令连接：

mysql -h{POD_IP} -P2881 -uroot -proot_password oceanbase -A -c

OceanBase Dashboard​

我们很高兴向用户推出创新的 OceanBase Kubernetes Dashboard，这是一款旨在改善用户在 Kubernetes 上管理和监控 OceanBase 集群体验的先进工具。欢迎各位用户使用和反馈，同时我们也在积极开发新功能以增强未来的更新。快速上手文档能帮助您快速了解 OceanBase 的功能和使用方法。

安装 OceanBase Dashboard 非常简单, 只需要执行如下命令。

helm repo add ob-operator https://oceanbase.github.io/ob-operator/
helm repo update ob-operator
helm install oceanbase-dashboard ob-operator/oceanbase-dashboard

OceanBase Dashboard 成功安装之后, 会自动创建一个 admin 用户和随机密码，可以通过如下命令查看密码。

echo $(kubectl get -n default secret oceanbase-dashboard-user-credentials -o jsonpath='{.data.admin}' | base64 -d)

一个 NodePort 类型的 service 会默认创建，可以通过如下命令查看 service 的地址，然后在浏览器中打开。

kubectl get svc oceanbase-dashboard-oceanbase-dashboard

使用 admin 账号和查看到的密码登录。

项目架构​

ob-operator 以 kubebuilder 为基础，通过统一的资源管理器接口、全局的任务管理器实例以及解决长调度的任务流机制完成对 OceanBase 集群及相关应用的控制和管理。ob-operator 的架构大致如下图所示：

有关架构细节可参见架构设计文档。

特性​

ob-operator 支持 OceanBase 集群的管理、租户管理、备份恢复、故障恢复等功能，具体而言支持了以下功能：

• 集群管理：集群自举、调整集群拓扑、支持 K8s 拓扑配置、扩缩容、集群升级、修改参数
• 租户管理：创建租户、调整租户拓扑、管理资源单元、修改用户密码
• 备份恢复：向 OSS 或 NFS 目的地周期性备份数据、从 OSS 或 NFS 中恢复数据
• 物理备库：从备份中恢复出备租户、创建空备租户、备租户升主、主备切换
• 故障恢复：单节点故障恢复，IP 保持情况下的集群故障恢复
• Dashboard(GUI)：基于 ob-operator 的图形化 OceanBase 集群管理工具

存储兼容性​

我们测试了如下的存储方案，兼容性结果如表格所示：

支持的 OceanBase 版本​

ob-operator 支持 OceanBase v4.x 版本。某些特性需要特定的 OceanBase 版本，可参考用户手册获取详细信息。

暂不支持 OceanBase v3.x 版本。

环境依赖​

ob-operator 使用 kubebuilder 项目进行构建，所以开发和运行环境与其相近。

• 构建 ob-operator 需要 Go 1.22 版本及以上；
• 运行 ob-operator 需要 Kubernetes 集群和 kubectl 的版本在 1.18 及以上。我们在 1.23 ~ 1.28 版本的 K8s 集群上检验过 ob-operator 的运行是符合预期的。
• 如果使用 Docker 作为集群的容器运行时，需要 Docker 17.03 及以上版本；我们的构建和运行环境使用的 Docker 版本为 18。

文档​

• ob-operator 架构设计
• 部署 ob-operator
• 开发手册
• 用户手册

获取帮助​

如果您在使用 ob-operator 时遇到任何问题，欢迎通过以下方式寻求帮助：

• GitHub Issue
• 官方论坛
• Slack
• 微信群（请添加小助手微信，微信号: OBCE666）
• 钉钉群（二维码）

参与开发​

• 提出 Issue
• 发起 Discussion
• 发起 Pull request

许可证​

ob-operator 使用 MulanPSL - 2.0 许可证。 您可以免费复制及使用源代码。当您修改或分发源代码时，请遵守木兰协议。