部署 OCP

本节为您介绍如何部署 OCP。 OCP 有两种部署方式：黑屏部署 和 交互式部署。

黑屏部署

前提条件

• 部署 OCP 的宿主机上已安装 Docker，并且 docker 命令在系统的 PATH 路径中可以找到。目前暂不兼容 podman-docker，Docker 的安装请参见 安装 Docker。

• 已参见 安装准备 获取 ocp-4.0.0-ce.tar.gz 软件包，并将软件包上传至 OCP 宿主机的任一目录进行解压，获取如下文件。

  • ocp_installer.sh：OCP 安装脚本。

  • ocp.tar.gz：OCP 镜像文件。

  • ocp-installer.tar.gz：OCP 安装程序镜像文件。

  • config.yaml：OCP 配置文件。

• 已参见 修改配置文件 并根据实际部署情况对 OCP 配置文件进行修改。

• 若您在部署 OCP 时选择使用已有集群，您需要提前创建好两个租户以及租户下的用户，分别用来存放 meta 数据和 monitor 数据，详细创建方式可参考 新建租户、创建用户；同时，所创建的用户需具有 DDL 和 DML 权限。

操作步骤

1. 以 root 用户登录 OCP 宿主机，并进入 ocp_installer.sh 文件所在路径下。

2. （可选）调用 ocp_installer.sh ，查看部署 OCP 的使用方法。

   #./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。

   # 使用密码的方式认证
   ./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。

• 已参见 安装准备 获取 ocp-4.0.0-ce.tar.gz 软件包，并将软件包上传至 OCP 宿主机的任一目录进行解压，获取如下文件。

  • ocp_installer.sh：OCP 安装脚本。

  • ocp.tar.gz：OCP 镜像文件。

  • ocp-installer.tar.gz：OCP 安装程序镜像文件。

  • config.yaml：OCP 配置文件。

操作步骤

1. 以 root 用户登录 OCP 宿主机，并进入 ocp_installer.sh 文件所在路径下。

2. （可选）调用 ocp_installer.sh ，查看部署 OCP 的使用方法。

   #./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。

   # 默认参数，将使用当前目录下的镜像文件，当前用户的 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。

   

5. 添加部署 OCP 所使用的主机，填写完成后单击 Next。 需填写的信息包括：用来连接的主机的用户名、端口、认证方式、主机 IP 等信息。

![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 的形式进行配置。
     2. 在租户模块，配置租户信息，包括：租户名、资源、以及在租户中新建的用户名、密码 和 database。 OCP 部署需要两个租户，分别为 Meta 租户和 Monitor 租户。
     3. 在 obproxy 模块，配置 obproxy 的安装路径、端口信息。 如果已经配置有 VIP，可以将 VIP 的信息配置进去，OCP 会使用 VIP 地址来进行访问。

   • 使用已有集群（use existing obcluster） 填写集群连接地址及已创建好的 meta 用户和 monitor 用户的连接方式。

7. 配置 OCP 部署相关信息，配置完成后单击 Submit。 OCP 部署的相关信息包括：OCP 的容器名称、端口、资源以及日志目录信息。如果已经有配置好的 VIP，可以填写此 VIP 信息。OCP 部署集群及其他服务时会使用该 VIP 地址，以方便其他组件访问。

8. 部署任务提交后会跳转到日志查看页面，初始化 metadb 的过程比较久，请您耐心等待。 待任务结束，可单击 Finish 退出安装程序。在退出安装程序前，可先确认下主机上 ocp-installer 的容器状态是否为安装完成。

任务回滚

提交任务成功之后，在 ./task 目录下会保存当前任务的信息。当任务失败需要回滚时，可以将对应的 yaml 文件作为配置文件，并参考 卸载 OCP 清理部署环境后重新进行部署。