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

1. 创建库及用户:

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'@'%';

1. 调整参数文件

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--在该时间内再次出现故障，不会进行迁移，避免出现并发恢复和不稳定

1. 配置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的节点

1. 启动服务:

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