使用 OCP 部署单副本 OceanBase 集群

更新时间：2026-04-10 11:58:00

OceanBase 支持单副本部署，并且单副本 OceanBase 集群还可以扩容（增加节点），所以也称为集群。

本文介绍如何使用 OCP 部署单副本 OceanBase 集群。

本节以 OCP V4.2.1 版本为例提供操作指导。不同 OCP 版本的操作界面可能不同，请以实际界面为准。

前提条件

在 创建集群 页面，设置集群的基础信息。

基本设置 如下表所示。

配置	描述
集群类型	可选择主集群或备集群，此处选择主集群。
集群名	自定义待管理的集群的名称。集群名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 2 ~ 48 字符。
root@sys 密码	支持自定义或随机生成。密码需要满足以下复杂度条件：长度：8 位 ~ 32 位。至少包含 2 个数字、2 个大写字母、2 个小写字母和 2 个特殊字符。支持的特殊字符如下：~!@#%^&_-+=`\|(){}[]:;',.?/ 此外，您可以单击复制密码*，将自定义或随机生成的密码复制到剪贴板。
OceanBase 版本	可以从列表中选择已有的 OceanBase 数据库版本，也可以在列表下方单击添加版本，上传 OceanBase RPM 版本包。
关联 OBProxy 集群	该选项用于关联已有的 OBProxy 集群，本例中不开启该选项。

在 创建集群 页面，设置集群的部署模式信息。

默认添加 3 个 Zone 的信息，单击其中两个 Zone 后面的删除图标，保留一个 Zone。

每个 Zone 需要设置的信息及其说明如下表所示。

配置	描述
Zone 名称	一般会有一个默认名称，您可以根据需要自定义名称。Zone 名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 2 个 ~ 48 个字符。
机房	Zone 所在的机房，每个 Zone 中的主机只能部署在同一个机房。
机型（可选）	如果选择了机型，后面主机列表会根据机型进行过滤。
CPU 架构	可选择自动分配或者手动选择。
主机	机器的 IP。您可以选择多个 IP。
Root Server 位置	您需选择一个 IP 作为 Root Service 所在的机器。多副本的 OceanBase 集群，其每个 Zone 都需指定一个 Root Service。
Zone 优先级排序	集群 sys 租户的主副本分布的优先级。可选项，如不指定，以第一个 Zone 为第一优先级。最高优先级的 Zone 会被视为 Primary Zone，且只能有一个。您也可以开启该选项自定义 Zone 的优先级排序，排序方法如下：勾选左侧列表框中的一个或多个 Zone。左侧列表框中显示了当前集群中所有可选的 Zone。单击中间的 > 按钮。此时勾选的 Zone 就会被移动到优先级排序列表中。同时勾选的多个 Zone 具有相同的优先级。重复 a、b 动作，添加低一优先级的 Zone。如需调整优先级，可在优先级排序列表中拖拽以调整顺序。列表中从上到下，优先级依次递减。

（可选）在 创建集群 页面，并配置集群参数。

您可以使用默认参数配置，也可以打开 参数配置 模块，并配置集群参数。
- 您可以逐个添加启动参数项并为其配置值。
- 您也可以通过单击 选择参数模板，然后选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。在未创建集群参数模板的情况下，您可单击 新建集群模板，为集群创建参数模板。
（可选）在 创建集群 页面，通过自定义设置，对路径及端口进行配置。

您可以使用默认路径和端口配置，也可以打开 自定义设置 模块，自定义 路径设置 和 端口设置。
- 配置路径：
  1. 在 路径配置 模块，根据需要自定义 软件安装路径、数据盘路径 和 日志盘路径。
  2. 配置完成后，单击测试，校验路径是否可用。若不可用，您可根据测试结果进行排查，或将路径修改为其它可用路径。
- 配置端口：
  1. 在 端口配置 模块，自定义 SQL 端口 和 RPC 端口。
  2. 配置完成后，单击测试，校验端口是否已被占用。若被占用，您需重新配置可用端口。
完成配置后，单击右下角提交。

集群创建成功后，可根据业务需要创建用户租户。