--- title: "部署 OCP | OceanBase 文档中心" description: 部署 OCP 本节为您介绍如何部署 OCP。 OCP 有两种部署方式： 黑屏部署 和 交互式部署 。 说明 OCP 仅 V4.0.0-BP1 及以上版本支持交互式部署方式。 交互式部署方式暂只支持英文模式。 黑屏部署 前提条件 部署 OCP 的宿主机上已安装 Docker，并且 docker 命令在系统的 PATH … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.0.0 社区版 # 部署 OCP 更新时间：2026-04-14 15:15:53 [编辑](https://github.com/oceanbase/ocp-doc/edit/V4.0.0/zh-CN/300.deployment-guide/600.deploy-ocp.md) 本节为您介绍如何部署 OCP。 OCP 有两种部署方式：**黑屏部署** 和 **交互式部署**。 #### 说明 - OCP 仅 V4.0.0-BP1 及以上版本支持交互式部署方式。 - 交互式部署方式暂只支持英文模式。 ## 黑屏部署 ### 前提条件 - 部署 OCP 的宿主机上已安装 Docker，并且 docker 命令在系统的 PATH 路径中可以找到。目前暂不兼容 podman-docker，Docker 的安装请参见 [安装 Docker](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866513)。 - 已参见 [安装准备](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866612) 获取 `ocp-4.0.0-ce.tar.gz` 软件包，并将软件包上传至 OCP 宿主机的任一目录进行解压，获取如下文件。 - `ocp_installer.sh`：OCP 安装脚本。 - `ocp.tar.gz`：OCP 镜像文件。 - `ocp-installer.tar.gz`：OCP 安装程序镜像文件。 - `config.yaml`：OCP 配置文件。 - 已参见 [修改配置文件](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866613) 并根据实际部署情况对 OCP 配置文件进行修改。 - 若您在部署 OCP 时选择使用已有集群，您需要提前创建好两个租户以及租户下的用户，分别用来存放 meta 数据和 monitor 数据，详细创建方式可参考 [新建租户](https://www.oceanbase.com/docs/community-observer-cn-10000000000901642)、[创建用户](https://www.oceanbase.com/docs/community-observer-cn-10000000000902264)；同时，所创建的用户需具有 DDL 和 DML 权限。 ### 操作步骤 1. 以 root 用户登录 OCP 宿主机，并进入 `ocp_installer.sh` 文件所在路径下。 2. （可选）调用 `ocp_installer.sh` ，查看部署 OCP 的使用方法。 ```bash #./ocp_installer.sh help Usage: ./ocp_installer.sh COMMAND -c config_file -i installer_image_file [-o ocp_image_file] [-k ssh_key_file] [-v] [-h] Description: OCP installer Commands: install install OCP uninstall delete OCP and metadb(if configured) upgrade upgrade OCP replace replace OCP container, used for upgrade to the bp version, or just restart Options: -c required, path to config file -i installer image file -o ocp image file -k ssh_key_file -v show verbose messages -h show this help mesages ``` 3. 执行以下命令部署 OCP。 ```bash # 使用密码的方式认证 ./ocp_installer.sh install -c config.yaml -i ./ocp-installer.tar.gz -o ./ocp.tar.gz # 使用密钥文件的方式认证 ./ocp_installer.sh install -c config.yaml -k /root/.ssh/id_rsa -i ./ocp-installer.tar.gz -o ./ocp.tar.gz ``` ## 交互式部署 ### 前提条件 - 部署 OCP 的宿主机上已安装 Docker，Docker 的安装请参见 [安装 Docker](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866513)。 - 已参见 [安装准备](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866612) 获取 `ocp-4.0.0-ce.tar.gz` 软件包，并将软件包上传至 OCP 宿主机的任一目录进行解压，获取如下文件。 - `ocp_installer.sh`：OCP 安装脚本。 - `ocp.tar.gz`：OCP 镜像文件。 - `ocp-installer.tar.gz`：OCP 安装程序镜像文件。 - `config.yaml`：OCP 配置文件。 ```bash #./ocp_installer.sh help Usage: ./ocp_installer.sh COMMAND -c config_file -i installer_image_file [-o ocp_image_file] [-k ssh_key_file] [-v] [-h] Description: OCP installer Commands: launch launch installer install install OCP uninstall delete OCP and metadb(if configured) upgrade upgrade OCP replace replace OCP container, used for upgrade to the bp version, or just restart Options: -c required, path to config file -i installer image file -o ocp image file -k ssh_key_file -v show verbose messages -p expose port of installer container -h show this help mesages ``` 3. 执行以下命令启动 ocp-installer。 ```bash # 默认参数，将使用当前目录下的镜像文件，当前用户的 id_rsa 文件，3000 端口 ./ocp_installer.sh launch # 自定义参数，可以指定镜像文件，key文件，端口信息 ./ocp_installer.sh launch -i ocp-installer.tar.gz -o ocp.tar.gz -k /root/.ssh/id_rsa -p 3000 ``` 4. 通过浏览器访问对应的 `IP:port` 进入到部署页面，单击 **Install**。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E7%99%BB%E5%BD%95OCP.png) 5. 添加部署 OCP 所使用的主机，填写完成后单击 **Next**。 需填写的信息包括：用来连接的主机的用户名、端口、认证方式、主机 IP 等信息。 #### 说明 认证方式支持两种：密码和私钥。若使用私钥认证，需要在调用 `ocp_installer.sh` 的时候通过 `-k` 参数指定，即可映射到容器中的特定目录。 ``` ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E6%B7%BB%E5%8A%A0%E4%B8%BB%E6%9C%BA.png) ``` 6. 配置元数据库信息，配置完成后单击 **Next**。 元数据库信息支持 **全新部署** 和 **使用已有集群** 两种方式进行配置。 - **全新部署（create metadb cluster）** 1. 在集群模块，填写集群名、端口、安装目录等基本信息。如果需要自定义一些参数，可以以 key value 的形式进行配置。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%85%A8%E6%96%B0%E9%83%A8%E7%BD%B2.png) 2. 在租户模块，配置租户信息，包括：租户名、资源、以及在租户中新建的用户名、密码 和 database。 OCP 部署需要两个租户，分别为 Meta 租户和 Monitor 租户。 ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E7%A7%9F%E6%88%B7%E4%BF%A1%E6%81%AF.png) 3. 在 obproxy 模块，配置 obproxy 的安装路径、端口信息。 如果已经配置有 VIP，可以将 VIP 的信息配置进去，OCP 会使用 VIP 地址来进行访问。 ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/obproxy.png) - **使用已有集群（use existing obcluster）** 填写集群连接地址及已创建好的 meta 用户和 monitor 用户的连接方式。 ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E4%BD%BF%E7%94%A8%E5%B7%B2%E6%9C%89%E9%9B%86%E7%BE%A4.png) 7. 配置 OCP 部署相关信息，配置完成后单击 **Submit**。 OCP 部署的相关信息包括：OCP 的容器名称、端口、资源以及日志目录信息。如果已经有配置好的 VIP，可以填写此 VIP 信息。OCP 部署集群及其他服务时会使用该 VIP 地址，以方便其他组件访问。 ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%AE%89%E8%A3%85%E5%8D%87%E7%BA%A7ocp.png) 8. 部署任务提交后会跳转到日志查看页面，初始化 metadb 的过程比较久，请您耐心等待。 待任务结束，可单击 **Finish** 退出安装程序。在退出安装程序前，可先确认下主机上 ocp-installer 的容器状态是否为安装完成。 ![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E6%8F%90%E4%BA%A4%E4%BB%BB%E5%8A%A1.png) ### 任务回滚 提交任务成功之后，在 `./task` 目录下会保存当前任务的信息。当任务失败需要回滚时，可以将对应的 yaml 文件作为配置文件，并参考 [卸载 OCP](https://www.oceanbase.com/docs/community-ocp-cn-10000000000866514) 清理部署环境后重新进行部署。 上一篇 下一篇 ![有帮助](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) 咨询热线