ORCHESTRATOR介绍及使用
ORCHESTRATOR
一简介
MySQL高可用性和复制拓扑管理工具，支持复制拓扑结构的调整，自动故障转移和手动主从切换等。后端数据库用MySQL或SQLite存储元数据，并提供Web界面展示MySQL复制的拓扑关系及状态，通过Web可更改MySQL实例的复制关系和部分配置信息，同时也提供命令行和api接口，方便运维管理。相对比MHA来看最重要的是解决了管理节点的单点问题，其通过raft协议保证本身的高可用。
主要特点:
① 自动发现MySQL的复制拓扑，并且在web上展示。
② 重构复制关系，可以在web进行拖图来进行复制关系变更。
③ 检测主异常，并可以自动或手动恢复，通过Hooks进行自定义脚本。
④ 支持命令行和web界面管理复制。
⑤ 支持配置高可用。
二安装:
下载链接
:https://github.com/openark/orchestrator/releases/download/v3.2.2/orchestrator-3.2.2-1.x86_64.rpm
需提前安装依赖包(redhat7为例):
oniguruma-5.9.5-3.el7.x86_64.rpm
jq-1.5-1.el7.x86_64.rpm
- 创建库及用户:
CREATE DATABASE IF NOT EXISTS orchestrator;
CREATE USER 'orchestrator'@'%' IDENTIFIED BY '********';
GRANT ALL PRIVILEGES ON orchestrator.* TO ' orchestrator'@'%';
GRANT PROCESS, REPLICATION SLAVE, RELOAD ON *.* TO 'orchestrator'@'%';
GRANT SELECT ON mysql.slave_master_info TO 'orchestrator'@'%';
- 调整参数文件
cp /usr/local/orchestrator/orchestrator-sample.conf.json /usr/local/orchestrator/orchestrator.conf.json
"MySQLTopologyUser": "orchestrator", ---被管理的MySQL的用户
"MySQLTopologyPassword": "******", ---被管理的MySQL的用户密码
"MySQLOrchestratorHost": "db1", ----后端数据库地址
"MySQLOrchestratorPort": 3306, ---后端数据库端口
"MySQLOrchestratorDatabase": "orchestrator",---后端数据库名
"MySQLOrchestratorUser": "******", ---后端数据库用户名
"MySQLOrchestratorPassword": "db1",---后端数据库用户密码
"RecoverMasterClusterFilters": ["*"],---只对匹配这些正则表达式模式的集群进行主恢复(“*”模式匹配所有) "RecoverIntermediateMasterClusterFilters": ["*"],--仅在与这些正则表达式模式匹配的集群上进行IM恢复（“*”模式匹配所有）
"FailureDetectionPeriodBlockMinutes": 60,-- 在该时间内再次出现故障，不会被多次发现
"RecoveryPeriodBlockSeconds": 3600--在该时间内再次出现故障，不会进行迁移，避免出现并发恢复和不稳定
- 配置orchestrator 高可用
在每个节点上修改orchestrator.conf.json配置文件：
"RaftEnabled": true, --是否开启Raft，保证orch的高可用
"RaftDataDir": "/var/lib/orchestrator",-- Raft的数据目录
"RaftBind": "db1", -- Raft 的 bind地址
"DefaultRaftPort": 10008, -- Raft的端口
"RaftNodes": [ "db1", "db2", "db3" ] -- Raft的节点
- 启动服务:
./orchestrator --debug --config=orchestrator.conf.json http &
三．功能使用
三常见使用:
1. 列出所有集群：clusters
默认：
# orchestrator -c clusters
db2:3306
返回包含集群别名：clusters-alias
# orchestrator -c clusters-alias
db2:3306,test
2. 发现指定实例：discover/async-discover
同步发现：
# orchestrator -c discover -i db1:3306
db1:3306
异步发现：适用于批量
# orchestrator -c async-discover -i db1:3306
:null
3. 忘记指定对象：forget/forget-cluster
忘记指定实例：
# orchestrator -c forget -i db1:3306
忘记指定集群：
# orchestrator -c forget-cluster -i test
4. 打印指定集群的拓扑：topology/topology-tabulated
普通返回：
# orchestrator -c topology -i db1:3306
db2:3306 [0s,ok,5.7.25-0ubuntu0.16.04.2-log,rw,ROW,>>,GTID]
+ db1:3306 [0s,ok,5.7.25-0ubuntu0.16.04.2-log,ro,ROW,>>,GTID]
+ db3:3306 [0s,ok,5.7.25-log,ro,ROW,>>,GTID]
列表返回：
# orchestrator -c topology-tabulated -i db1:3306
db2:3306 |0s|ok|5.7.25-0ubuntu0.16.04.2-log|rw|ROW|>>,GTID
+ db1:3306|0s|ok|5.7.25-0ubuntu0.16.04.2-log|ro|ROW|>>,GTID
+ db3:3306|0s|ok|5.7.25-log |ro|ROW|>>,GTID
5. 查看使用哪个API：自己会选择出leader。which-api
# orchestrator -c which-api
db3:3000/api
也可以通过 http://192.168.163.133:3000/api/leader-check 查看。
6. 调用api请求，需要和 -path 参数一起：api..-path
# orchestrator -c api -path clusters
[ "db2:3306" ]
# orchestrator -c api -path leader-check
"OK"
# orchestrator -c api -path status
{ "Code": "OK", "Message": "Application node is healthy"...}
7. 搜索实例：search
# orchestrator -c search -i test
db2:3306
db1:3306
db3:3306
8. 打印指定实例的主库：which-master
# orchestrator -c which-master -i db1:3306
db2:3306
# orchestrator -c which-master -i db3:3306
db2:3306
# orchestrator -c which-master -i db2:3306 #自己本身是主库
:0
9. 打印指定实例的从库：which-replicas
# orchestrator -c which-replicas -i db2:3306
db1:3306
db3:3306
10. 打印指定实例的实例名：which-instance
# orchestrator -c instance -i db1:3306
---切换相关
1.手工主从切换:
test2:3306优雅的切换到test1:3306，切换之后需要手动执行start slave
orchestrator -c graceful-master-takeover -a test2:3306 -d test1:3306
2. 手动恢复，当从库进入停机或者维护模式，此时主库宕机，不会自动Failover，需要手动执行恢复，指定死掉的主实例：
orchestrator -c recover -i test1:3306
3. 手动强制恢复，不管任何情况，都进行恢复：
orchestrator -c force-master-failover -i test2:3306
--更多
orchestrator –help
浙公网安备 33010602011771号