首批通过分布式安全可靠测评,为关键业务系统打造
通过 OCP 部署 OceanBase 集群
更新时间:2025-12-05 15:42:04
本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 OCP 白屏部署 OceanBase 数据库。
前提条件
您已部署 OCP,详细操作请参考 OceanBase 云平台/部署指南。
当前登录 OCP 的用户拥有 主机管理 和 Create Cluster 的权限。
已上传 oceanbase-ce、 oceanbase-ce-libs 和 oceanbase-ce-utils 软件包至 OCP。
OceanBase 宿主机已安装好 MySQL 客户端。
OceanBase 宿主机已安装 python2.7。
(可选)若您创建的是多副本 OceanBase 集群,则需当前 OCP 中已存在可用的 ODP 集群。如何新增 ODP 集群可参考 OceanBase 云平台/用户指南/管理 OBProxy/创建 OBProxy 集群。
操作步骤
说明
本文以 OCP V4.0.3 社区版本为例提供操作指导。不同 OCP 版本的操作界面可能不同,请以实际界面为准。
步骤一:添加机器到 OCP 资源池
部署 OceanBase 集群前,您需先参考本节内容将机器添加到 OCP 资源池。
使用 admin 账号登录 OCP。
在左侧导航栏中单击 主机,进入 主机 页面。
在 主机 页面右上角单击 添加主机。

在弹出的对话框中填写机器信息。

各字段填写说明如下表所示。
字段 描述 IP 地址 待添加机器的 IP,请输入机器的 IPv4 地址。 SSH 端口 默认为 22。 机型 为配置相同的主机指定的一个标签,便于 OCP 更好地管理主机。如果没有对应的机型,可在下拉菜单中单击 新增机型,添加新的机型。 机房 选择机器所处机房。如果没有对应的机房,可在下拉菜单中单击 新增机房 在 OCP 中新增机房信息。机房信息包括 机房 与 区域。 - 机房是 OceanBase 集群需要记录的一种主机属性,这个属性会作为 OceanBase 负载均衡和 SQL 语句路由策略的参考项,请按照实际情况填写。
- 区域用于表示主机所处的地理区域,是 OceanBase 集群需要记录的主机属性之一,对于 OceanBase 集群的负载均衡和 SQL 语句路由策略会有一定的影响,请按照实际情况填写。
说明
OCP V3.1.1 版本开始支持多 AZone 模式,新增机房时,将在当前 OCP 所在的 AZone 中创建新的机房。
主机类型 有 物理机 和 容器 两种选项。 凭据 选择远程登录物理机使用的凭据,您可以在下拉菜单中单击 新增凭据 来新建凭据。
新增凭据时需注意:- 凭据名:以英文字母开头、英文或数字结尾,可包含英文、数字和下划线,且长度为 2 ~ 32。
- 授权类型:包含用户名/密码和 SSH 私钥两种方式。
- 用户类型:支持拥有 root 权限的 SSH 用户,拥有 root 权限的普通用户须先配置免密执行 sudo 指令。OCP 目前仅支持配置所有指令免密执行 sudo,即在
/etc/sudoers文件中,添加username ALL=(ALL) NOPASSWD:ALL。
主机别名(可选) 主机别名是您为配置相同的主机指定的一个标签,建议您指定有意义的名称,便于更好地管理主机。 说明(可选) 主机的注释,便于更好地管理主机。 填写完成后,单击 确定。
步骤二:创建 OceanBase 集群
您可参考本节介绍通过 OCP 创建 OceanBase 集群。
在 OCP 白屏界面中根据实际业务场景,找到新建集群的入口。
如果您没有可管理的集群,系统会在 集群 页面提示您新建集群,可直接在提示信息中单击 创建集群。
如果您已有可管理的集群,可单击 集群 后在 集群 页面右上角单击 创建集群。
在 创建集群 页面,设置集群的基础信息。

基础信息相关说明如下表所示。
配置 描述 集群类型 选择 主集群。 集群名称 自定义待管理的集群的名称。集群名称必须以英文字母开头,可支持大小写字母、数字和下划线,长度为 2 ~ 48 个字符。 root@sys 密码 支持自定义或随机生成。密码需要满足以下复杂度条件:
- 长度:8 ~ 32 字符
- 支持字母、数字和特殊字符,且至少包含大、小写字母、数字和特殊字符各 2 个
- 支持的特殊字符如下:
~!@#%^&*_-+=|(){}[]:;,.?/
输入密码后,您可以单击 复制密码,将自定义或随机生成的密码复制到剪贴板。OB 版本 可以从列表中选择已有的 OceanBase 数据库版本,也可以在下拉菜单中单击 添加版本,上传 OceanBase RPM 包。 关联 OBProxy 集群 该选项用于关联已有的 ODP 集群,如您创建的是多副本的 OceanBase 集群,建议您打开 关联 OBProxy 集群 开关,为该 OceanBase 集群关联 ODP 集群。 关联后您的业务涉及的 SQL 请求将会被精准转发到相应的副本,使您对 OceanBase 数据库的访问效果能够媲美访问单机数据库。 - 默认使用 proxyro 用户关联,您无需填写用户名和密码。
- 在下拉框中选择要关联的 ODP 集群。如下拉框中没有可关联的 ODP 集群,请参考本文 前提条件 中的描述添加 ODP 集群。
注意
当 OB 版本 中选择的集群为 V4.0 及以上版本时,仅支持关联 V4.0.0 及以上版本的 OBProxy 集群。设置集群的部署模式信息。
默认添加 3 个 Zone 的信息,如果您希望部署的集群 Zone 的个数大于 3 个,您可以在下方单击 + 新增 按钮,增加 Zone 信息。如果部署的集群 Zone 的个数小于 3 个,您可以单击 Zone 后面的删除图标。

每个 Zone 需要设置的信息及其说明如下表所示。
配置 描述 Zone 名称 一般会有一个默认名称,您可以根据需要自定义名称。 Zone 名称必须以英文字母开头,可支持大小写字母、数字和下划线,长度为 2 ~ 48 个字符。部署多 Zone 的 OceanBase 集群必须有一个 Zone 与主 Zone 的 Region 相同。 机房 Zone 所在的机房,一个 Zone 只能存在于一个机房。 机型(可选) 如果选择了机型,后面主机列表会根据机型进行过滤。 CPU 架构 当选择的 OB 版本 中存在多个不同架构的安装包时,需选择匹配此软件包的主机硬件架构。 注意
默认架构类型为第一个安装包的架构类型,支持切换。切换指定架构后,主机 列表中即展示该架构的主机。
为不同的 Zone 设置不同的架构时,混合架构部署模式可能存在稳定性与性能问题,请谨慎操作。
主机 您可以选择多个主机,或进行添加主机的操作。 RootServer 位置 您需选择一个 IP 作为 Root Service 所在的机器。多副本的 OceanBase 集群,其每个 Zone 都需指定一个 Root Server。 Zone 优先级排序 Zone 的优先级排序。最高优先级的 Zone 会被视为 Primary Zone,且只能有一个。 排序方法如下: - 勾选左侧列表框中的一个或多个 Zone。左侧列表框中显示了当前集群中所有可选的 Zone。
- 单击中间的 > 按钮。 此时勾选的 Zone 就会被移动到 优先级排序 列表中。同时勾选的多个 Zone 具有相同的优先级。
- 重复 1、2 动作,添加低一优先级的 Zone。
- 如需调整优先级,可在 优先级排序 列表中拖拽以调整顺序。
打开 参数配置 模块,并配置集群参数。
您可通过如图 ① 处,逐个添加启动参数项并为其配置值。
您也可通过如图 ② 处,单击 选择参数模板 选择一个参数模板,系统会将模板中的参数连同配置自动填充到此处。
说明
在未创建集群参数模板的情况下,您可单击 新建集群模板,为集群创建参数模板,详情可参见 OceanBase 云平台文档 集群参数模板管理。

打开 自定义配置,对路径及端口进行配置。
配置路径:
在 路径配置 模块,根据需要自定义 软件安装路径、数据盘路径 和 日志盘路径 。
配置完成后,单击 测试,校验路径是否可用。若不可用,您可根据测试结果进行排查,或将路径修改为其它可用路径。

配置端口:
在 端口配置 模块,自定义 SQL 端口 和 RPC 端口。
配置完成后,单击 测试,校验端口是否已被占用。若被占用,您需重新配置可用端口。

完成测试后,单击 提交。
在弹出的 确认提交信息 对话框中,确认信息无误后,单击 确定。
说明
您可在 系统管理 > 任务 中查看该任务的执行进度。
相关文档
集群部署完成后,需创建业务租户,详细信息请参见 OceanBase 云平台/用户指南/管理租户/租户基础操作/新建租户。