--- title: "通过 OCP 部署 OceanBase 集群 - OceanBase 数据库 V4.1.0 | OceanBase 文档中心" description: 通过 OCP 部署 OceanBase 集群 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 OCP 白屏部署 OceanBase 数据库。 前提条件 您已部署 OCP，详细操作请参考 OceanBase 云平台/部署指南 。 当前登录 OCP 的用户拥有 主机管理 和 Creat… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0 # 通过 OCP 部署 OceanBase 集群 更新时间：2025-12-05 15:42:04 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/400.deploy/500.deploy-oceanbase-database-community-edition/200.local-deployment/400.deploy-by-ui/200.deploy-by-ocp.md) 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 OCP 白屏部署 OceanBase 数据库。 ## 前提条件 - 您已部署 OCP，详细操作请参考 [OceanBase 云平台/部署指南](https://www.oceanbase.com/docs/community-ocp-cn-10000000001832350)。 - 当前登录 OCP 的用户拥有 **主机管理** 和 **Create Cluster** 的权限。 - 已上传 oceanbase-ce、 oceanbase-ce-libs 和 oceanbase-ce-utils 软件包至 OCP。 - OceanBase 宿主机已安装好 MySQL 客户端。 - OceanBase 宿主机已安装 python2.7。 - （可选）若您创建的是多副本 OceanBase 集群，则需当前 OCP 中已存在可用的 ODP 集群。如何新增 ODP 集群可参考 [OceanBase 云平台/用户指南/管理 OBProxy/创建 OBProxy 集群](https://www.oceanbase.com/docs/community-ocp-cn-10000000001832462)。 ## 操作步骤 #### 说明 本文以 OCP V4.0.3 社区版本为例提供操作指导。不同 OCP 版本的操作界面可能不同，请以实际界面为准。 ### 步骤一：添加机器到 OCP 资源池 部署 OceanBase 集群前，您需先参考本节内容将机器添加到 OCP 资源池。 1. 使用 admin 账号登录 OCP。 2. 在左侧导航栏中单击 **主机**，进入 **主机** 页面。 3. 在 **主机** 页面右上角单击 **添加主机**。 ![添加主机](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/4.deploy/5.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-01.png) 4. 在弹出的对话框中填写机器信息。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/4.deploy/5.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-02.png) 各字段填写说明如下表所示。 | **字段** | **描述** | | --- | --- | | **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`。 | | **主机别名（可选）** | 主机别名是您为配置相同的主机指定的一个标签，建议您指定有意义的名称，便于更好地管理主机。 | | **说明（可选）** | 主机的注释，便于更好地管理主机。 | 5. 填写完成后，单击 **确定**。 ### 步骤二：创建 OceanBase 集群 您可参考本节介绍通过 OCP 创建 OceanBase 集群。 1. 在 OCP 白屏界面中根据实际业务场景，找到新建集群的入口。 - 如果您没有可管理的集群，系统会在 **集群** 页面提示您新建集群，可直接在提示信息中单击 **创建集群**。 - 如果您已有可管理的集群，可单击 **集群** 后在 **集群** 页面右上角单击 **创建集群**。 2. 在 **创建集群** 页面，设置集群的基础信息。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.0/4.deploy/500.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-03.png) 基础信息相关说明如下表所示。 | **配置** | **描述** | | --- | --- | | **集群类型** | 选择 **主集群**。 | | **集群名称** | 自定义待管理的集群的名称。集群名称必须以英文字母开头，可支持大小写字母、数字和下划线，长度为 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. 设置集群的部署模式信息。 默认添加 3 个 Zone 的信息，如果您希望部署的集群 Zone 的个数大于 3 个，您可以在下方单击 **+ 新增** 按钮，增加 Zone 信息。如果部署的集群 Zone 的个数小于 3 个，您可以单击 Zone 后面的删除图标。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.0/4.deploy/500.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-04.png) 每个 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，且只能有一个。 排序方法如下： 1. 勾选左侧列表框中的一个或多个 Zone。左侧列表框中显示了当前集群中所有可选的 Zone。 2. 单击中间的 > 按钮。 此时勾选的 Zone 就会被移动到 **优先级排序** 列表中。同时勾选的多个 Zone 具有相同的优先级。 3. 重复 1、2 动作，添加低一优先级的 Zone。 4. 如需调整优先级，可在 **优先级排序** 列表中拖拽以调整顺序。 列表中从上到下，优先级依次递减。 | 4. 打开 **参数配置** 模块，并配置集群参数。 - 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。 - 您也可通过如图 ② 处，单击 **选择参数模板** 选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。 #### 说明 在未创建集群参数模板的情况下，您可单击 **新建集群模板**，为集群创建参数模板，详情可参见 OceanBase 云平台文档 [集群参数模板管理](https://www.oceanbase.com/docs/community-ocp-cn-10000000001832453)。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.0/4.deploy/500.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-05.png) 5. 打开 **自定义配置**，对路径及端口进行配置。 - 配置路径： 1. 在 **路径配置** 模块，根据需要自定义 **软件安装路径**、**数据盘路径** 和 **日志盘路径** 。 2. 配置完成后，单击 **测试**，校验路径是否可用。若不可用，您可根据测试结果进行排查，或将路径修改为其它可用路径。 ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.0/4.deploy/500.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-06.png) - 配置端口： 1. 在 **端口配置** 模块，自定义 **SQL 端口** 和 **RPC 端口**。 2. 配置完成后，单击 **测试**，校验端口是否已被占用。若被占用，您需重新配置可用端口。 ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.0/4.deploy/500.deploy-oceanbase-database-community-edition/2.deploy-by-ocp-07.png) 6. 完成测试后，单击 **提交**。 7. 在弹出的 **确认提交信息** 对话框中，确认信息无误后，单击 **确定**。 #### 说明 您可在 **系统管理 > 任务** 中查看该任务的执行进度。 ## 相关文档 集群部署完成后，需创建业务租户，详细信息请参见 [OceanBase 云平台/用户指南/管理租户/租户基础操作/新建租户](https://www.oceanbase.com/docs/community-ocp-cn-10000000001834181)。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线