跳到主要内容

快速上手

本文将以部署 ob-operator 以及部署 OceanBase 集群为例，指导您如何快速使用 ob-operator 进行 OceanBase 的管理。

前提条件​

在开始之前，请确保您已满足以下条件：

  • 您有可用的 Kubernetes 集群且至少有2 个 CPU，10GB 内存和 100GB 存储空间。
  • 您已安装 cert-manager。cert-manager 的安装方法请参考对应的 安装文档。
  • 您已安装 local-path-provisioner 并确认其配置的目标地点有足够的存储空间。local-path-provisioner 的安装方法请参考对应的 安装文档。

部署 ob-operator​

使用以下命令在 Kubernetes 集群中部署 ob-operator：

  • 稳定版本

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

  • 开发版本

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

使用以下命令验证 ob-operator 是否成功部署：

kubectl get pod -n oceanbase-system

预期输出：

NAME                                            READY   STATUS    RESTARTS   AGE
oceanbase-controller-manager-86cfc8f7bf-4hfnj   2/2     Running   0          1m

部署 OceanBase 集群​

按照以下步骤在 Kubernetes 集群上部署 OceanBase 集群：

  1. 创建 Secrets 在创建 OceanBase 集群之前，您必须创建特定用户所需的 secrets。使用以下命令创建 secrets：

    kubectl create secret generic root-password --from-literal=password='root_password'
    kubectl create secret generic proxyro-password --from-literal=password='proxyro_password'
    kubectl create secret generic monitor-password --from-literal=password='monitor_password'
    kubectl create secret generic operator-password --from-literal=password='operator_password'

  2. 部署 OceanBase 集群 使用以下命令在 Kubernetes 集群上部署 OceanBase 集群：

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

    集群创建通常需要约 2 分钟。执行以下命令检查集群状态：

    kubectl get obclusters.oceanbase.oceanbase.com test

    预期输出：

    NAME   STATUS    AGE
    test   running   6m2s

  3. 连接 OceanBase 集群 按照以下步骤连接新创建的 OceanBase 集群：

    # 使用以下命令查找 observer 的 POD IP 和 POD 名称
    # POD 名的规则为 {cluster_name}-{cluster_id}-{zone}-uuid
    kubectl get pods -o wide
    # 使用以下命令连接集群
    mysql -h{POD_IP} -P2881 -uroot -p'root_password' oceanbase -A -c

如果您有任何问题或需要进一步帮助，请随时咨询。

后续操作​

本文介绍了快速部署 ob-operator 和 OceanBase 集群，适用于快速搭建环境。在生产环境中的集群部署和运维，参考 OceanBase 集群管理。

在成功创建集群后，在运行业务之前，您需要创建业务租户。有关租户管理的内容，参考 OceanBase 租户管理。