Docker 部署
用户可以在五个容器中部署一个多节点高可用 SequoiaDB 集群。
集群包含一个协调节点与编目节点,三个三副本数据节点,与一个 MySQL 实例节点。
样例环境
Docker 环境 | Mac Docker 2.0.0.3 |
---|---|
容器操作系统版本 | Ubuntu 18 |
数据库版本 | SequoiaDB 3.2.1 |
集群部署 | 一个运行协调和编目节点,三个运行数据节点,一个运行 MySQL 实例 |
Docker 在 Linux/Windows/MacOS 平台安装方法可参考官方文档。
对于 Linux 环境可参考本样例安装 Docker 环境。
拉取镜像
- $ docker pull sequoiadb/sequoiadb
- $ docker pull sequoiadb/sequoiasql-mysql
- $ docker run -it -d --name coord_catalog sequoiadb/sequoiadb:latest
- $ docker run -it -d --name sdb_data1 sequoiadb/sequoiadb:latest
- $ docker run -it -d --name sdb_data2 sequoiadb/sequoiadb:latest
- $ docker run -it -d --name sdb_data3 sequoiadb/sequoiadb:latest
查看四个容器的容器 ID
- $ docker ps -a | awk '{print $NF}';
- NAMES
- sdb_data3
- sdb_data2
- sdb_data1
- coord_catalog
查看四个容器的容器对应的 IP 地址
- $ docker inspect coord_catalog | grep IPAddress |awk 'NR==2 {print $0}'
- $ docker inspect sdb_data1 | grep IPAddress |awk 'NR==2 {print $0}'
- $ docker inspect sdb_data2 | grep IPAddress |awk 'NR==2 {print $0}'
四条命令的输出结果分别为各个容器自身的 IP 地址:
部署 SequoiaDB 集群
根据集群规划以及各个容器的 IP 地址,在对应参数填入各自的地址与端口号。
- $ docker exec coord_catalog "/init.sh" \
- --coord='172.17.0.2:11810' \
- --catalog='172.17.0.2:11800' \
- --data='group1=172.17.0.3:11820,172.17.0.4:11820,172.17.0.5:11820;group2=172.17.0.4:11830,172.17.0.5:11830,172.17.0.3:11830;group3=172.17.0.5:11840,172.17.0.3:11840,172.17.0.4:11840'
该命令输出结果为:
- Begin generating SequoiaDB conf file
- Finish generating SequoiaDB conf file
- Restarting sdbcm process, it will take 10 seconds
- Deploy...
- Execute command: /opt/sequoiadb/tools/deploy/../../bin/sdb -f /opt/sequoiadb/tools/deploy/quickDeploy.js -e ''
- ************ Deploy SequoiaDB ************************
- Create catalog: 172.17.0.2:11800
- Create coord: 172.17.0.2:11810
- Create data: 172.17.0.3:11820
- Create data: 172.17.0.4:11820
- Create data: 172.17.0.5:11820
- Create data: 172.17.0.4:11830
- Create data: 172.17.0.5:11830
- Create data: 172.17.0.3:11830
- Create data: 172.17.0.5:11840
- Create data: 172.17.0.3:11840
- Create data: 172.17.0.4:11840
启动一个 MySQL 实例容器
- $ docker run -it -d -p 3306:3306 --name mysql sequoiadb/sequoiasql-mysql:latest
- $ docker ps -a | awk '{print $NF}';
输出结果为包括 MySQL 实例在内的所有容器名:
- NAMES
- mysql
- sdb_data2
- sdb_data1
- coord_catalog
查看容器 IP 地址
- "IPAddress": "172.17.0.6",
将 MySQL 实例注册入协调节点
- $ docker exec mysql "/init.sh" --port=3306 --coord='172.17.0.2:11810'
输出结果为:
- Creating SequoiaSQL instance: MySQLInstance
- Modify configuration file and restart the instance: MySQLInstance
- Restarting instance: MySQLInstance
- Opening remote access to user root
- Restarting instance: MySQLInstance
- Instance MySQLInstance is created on port 3306, default user is root
- $ mysql -h 127.0.0.1 -P 3306 -u root
可以得到 MySQL 连接成功的输出:
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 2
- Server version: 5.7.25 Source distribution
- Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
- Oracle is a registered trademark of Oracle Corporation and/or its
- affiliates. Other names may be trademarks of their respective
- owners.
- Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
用户可以使用 MySQL 命令创建数据库与表:
重置镜像
为方便用户重置已经创建了数据库节点的容器,用户可以使用 cleanup.sh 脚本进行本地容器的重置。
- $ docker exec mysql /cleanup.sh
- $ docker exec coord_catalog /cleanup.sh
- $ docker exec sdb_data1 /cleanup.sh
- $ docker exec sdb_data3 /cleanup.sh