作者简介:海芊(Amber 宝宝),网红文档工程师。
个人频道:Amber loves OB https://space.bilibili.com/557737255
最近社区有很多小伙伴反映 OMS 部署有困难,今天就手把手教大家如何部署。除了图文教程,我也录制了视频教程,大家根据需要使用即可。PS:企业版也可同样处理哦~~
视频教程
部署单节点单地域社区版 OMS 视频教程
图文教程
前提条件
在开搞之前,需要大家确认一下部署环境是不是满足要求:
- 确认安装环境符合系统和网络要求,详情请参见 系统和网络要求。
- 已准备 MetaOB 集群作为 OMS 社区版的元信息库。
- (可选)已准备时序数据库为 OMS 社区版存储性能监控和DDL/DML统计数据信息。
- 已准备 3 个文件系统目录,并分别映射至 OMS使用的:/home/admin/logs(管控组件的日志目录),/home/ds/store (store 组件的运行目录),/home/ds/run(connector 组件的运行目录)目录。
- 已获取 OMS 社区版安装包,通常安装包为以 oms 开头的 tar.gz 文件。比如我用的安装包为
oms-docker.tar.gz
。下载地址:OceanBase 社区版下载中心。
部署流程
1. 执行下述命令,从 OMS 社区版安装包加载镜像。
docker load -i <OMS 社区版安装包>
返回的结果如下:
可以看到我用的是社区版 v202210_v40ce_ce 版本。
2. 执行下述命令,从加载的镜像中获取部署脚本。
sudo docker run -d --net host --name oms-config-tool <OMS_IMAGE> bash && sudo docker cp oms-config-tool:/root/docker_remote_deploy.sh . && sudo docker rm -f oms-config-tool
注意:这里要把 <OMS_IMAGE>
替换成你实际的镜像。你可以通过以下命令,获取到加载的相应镜像的 [IMAGE ID] 或 [REPOSITORY:TAG],即为相应加载后镜像的唯一标识符 <OMS_IMAGE>。
$sudo docker images
REPOSITORY TAG IMAGE ID
reg.docker.alibaba-inc.com/oceanbase/oms v202210_v40ce_ce 2786e8a6eccd
我在实际部署时返回的结果如下:
此时,可以看到部署脚本为 docker_remote_deploy.sh
。
3. 通过部署脚本启动部署工具。
sh docker_remote_deploy.sh -o <部署工具映射目录> -i <本机 IP 地址> -d <OMS_IMAGE>
- 部署工具映射目录:用于存放部署流程中的日志和临时文件的目录,需要您输入当前机器上的一个可用目录。
- 本机 IP 地址:执行脚本的宿主机的 IP 地址。在单节点场景下,会被默认解析为 CM 配置信息中的对应 IP 地址。
- OMS 镜像地址 OMS_IMAGE:已经在第 2 步中说明,不再重复。
运行以上命令,返回结果如下:
这里的选择的部署模式是 单地域单节点
,无配置文件
。
然后根据部署工具提示完成部署,每次输入后,通过回车进入下一步。
- 根据提示输入 MetaOB 配置信息。
您需要提供 MetaOB 的 IP、端口号、用户名和密码,并为其设置前缀。例如,当前缀设置为 oms 时,最终库名分别为 oms_rm、oms_cm 和 oms_cm_hb。
2. (可选)根据提示输入时序数据库的配置信息。
注意:目前仅支持时序数据库 INFLUXDB。
您需要提供时序数据库的 URL、数据库和密码。
然后输入本机的用户名和密码,以及挂载根目录等部署一个节点时需要的额外信息。
注意:这里会在容器内通过 SSH 远程命令执行本机脚本,因此需要填充通过 SSH 登录的用户名和密码,用户需要具有 SUDO 权限。
OMS 会在你挂载的根目录下这个目录下生成 oms_logs, oms_store, oms_run 三个子目录,分别映射到容器的 /home/admin/logs, /home/ds/store, /home/ds/run三 个目录。生产环境下,这三个应该分别对应不同的文件系统。
输入配置文件 config.yaml
将写入的路径,以符号 /
结尾。输入 OMS 社区版容器在宿主机上的挂载根目录。
以上步骤完成之后,OMS 即将开始部署流程。流程如下:
- 【步骤一】校验 config.yaml 配置文件
- 【步骤二】创建 OMS 元信息库
- 【步骤三】创建 OMS 各组件的配置文件
- 【步骤四】重启 OMS 所有组件
部署完成后,会提示 【结束】全部初始化步骤执行成功。
后续操作
OceanBase 迁移服务(OceanBase Migration Service,OMS)社区版部署完成后,您可以通过 OMS 社区版的访问地址登录 OMS 社区版管理控制台。详细信息,参考 登录 OMS 社区版控制台文档。