概述

今天主要总结一下MySQL复制拓扑管理工具Orchestrator的执行命令。

orchestrator 通过 -c 来执行具体的命令，通过 orchestrator help 查看所有命令的帮助文档， orchestrator help relocate 查看具体命令relocate的帮助文档。

orchestrator 提供的命令很多，这里提一些比较重要和常用的命令，没有提到的可自行去文档或者源码中查看。

1、MySQL实例管理命令

1.1、discover

用于发现实例以及该实例的主、从库信息，将获取到的信息写入后台数据库database_instance等相关表

orchestrator --config=./orchestrator.conf.json -c discover -i host_name

1.2、forget

移除实例信息，即从database_instance表中删除相关记录

orchestrator --config=./orchestrator.conf.json -c forget -i host_name

1.3、begin-maintenance

标记一个实例进入维护模式，在database_instance_maintenance表中插入记录

orchestrator -c begin-maintenance -i instance.to.lock.com --duration=3h --reason="load testing; do not disturb"

1.4、end-maintenance

标记一个实例退出维护模式，即更新 database_instance_maintenance 表中相关记录

orchestrator -c end-maintenance -i locked.instance.com

1.5、in-maintenance

查询实例是否处于维护模式，从表database_instance_maintenance中查询

orchestrator -c in-maintenance -i locked.instance.com

1.6、begin-downtime

标记一个实例进入下线模式，在database_instance_downtime表中插入记录

orchestrator -c begin-downtime -i instance.to.downtime.com --duration=3h --reason="dba handling; do not do recovery"

1.7、end-downtime

标记一个实例退出下线模式，在database_instance_downtime表中删除记录

orchestrator -c end-downtime -i downtimed.instance.com

2、 MySQL实例信息查询命令

2.1、find

通过正则表达式搜索实例名

orchestrator -c find -pattern "backup.*us-east"

2.2、search

通过关键字匹配搜索实例名

orchestrator -c search -pattern "search string"

2.3、clusters

输出所有的MySQL集群名称，通过sql查询database_instance相关表获取

orchestrator -c clusters

2.4、clusters-alias

输出所有MySQL集群名称以及别名

orchestrator -c clusters-alias

2.5、all-clusters-masters

输出所有MySQL集群可写的主库信息

orchestrator -c all-clusters-masters

2.6、topology

输出实例所属集群的拓扑信息

orchestrator -c topology -i instance.belonging.to.a.topology.com

2.7、topology-tabulated

输出实例所属集群的拓扑信息，类似topology命令，输出格式稍有不同

orchestrator -c topology-tabulated -i instance.belonging.to.a.topology.com

2.8、all-instances

输出所有已知的实例

orchestrator -c all-instances

2.9、which-instance

输出实例的完整的信息

orchestrator -c which-instance -i instance.to.check.com

2.10、which-cluster

输出MySQL实例所属的集群名称

orchestrator -c which-cluster -i instance.to.check.com

2.11、which-cluster-domain

输出MySQL实例所属集群的域名

orchestrator -c which-cluster-domain -i instance.to.check.com

2.12、which-heuristic-domain-instance

给定一个集群域名，输出与其关联的可写的实例

orchestrator -c which-heuristic-domain-instance -alias some_alias

2.13、which-cluster-master

输出实例所属集群的主库信息

orchestrator -c which-cluster-master -i instance.to.check.com

2.14、which-cluster-instances

输出实例所属集群的所有实例信息

orchestrator -c which-cluster-instances -i instance.to.check.com

2.15、which-master

列出实例所属集群的主库信息，与which-cluster-master类似

orchestrator -c which-master -i a.known.replica.com

2.16、which-downtimed-instances

列出处于下线状态的实例

orchestrator -c which-downtimed-instances

2.17、which-replicas

输出实例的从库信息

orchestrator -c which-replicas -i a.known.instance.com

2.18、which-lost-in-recovery

输出处于下线状态，在故障恢复过程中丢失的实例

orchestrator -c which-lost-in-recovery

2.19、instance-status

输出实例的状态信息

orchestrator -c instance-status -i instance.to.investigate.com

2.20、get-cluster-heuristic-lag

输出实例所属集群的最大延迟信息

orchestrator -c get-cluster-heuristic-lag -i instance.that.is.part.of.cluster.com

3、 故障恢复命令

3.1、recover

主库故障切换，主库必须关闭，执行才有效果， -i 参数必须是已经关闭的主库， 新主库不需要指定，由orchestrator自己选择。

orchestrator -c recover -i dead.instance.com --debug

3.2、recover-lite

主库故障切换，与recover类似，简化的部分操作，更加轻量化。

orchestrator -c recover-lite -i dead.instance.com --debug

3.3、force-master-failover

不管主库是否正常，强制故障切换，切换后主库不关闭，新主库不需要指定，由orchestrator选择。这个操作比较危险，谨慎使用。

orchestrator -c force-master-failover

3.4、force-master-takeover

不管主库是否正常，强制主从切换，-i指定集群中任一实例，-d 指定新主库， 注意 切换后旧主库不会指向新主库，需要手动操作。

orchestrator -c force-master-takeover -i instance.in.relevant.cluster.com -d immediate.child.of.master.com

3.5、graceful-master-takeover

主从切换，旧主库会指向新主库，但是复制线程是停止的，需要人工手动执行start slave，恢复复制。

orchestrator -c graceful-master-takeover -i instance.in.relevant.cluster.com -d immediate.child.of.master.com

3.6、replication-analysis

根据已有的拓扑关系分析潜在的故障事件，分析结果输出格式不稳定，未来可能改变，建议不要使用该功能。

orchestrator -c replication-analysis

3.7、ack-all-recoveries/ack-cluster-recoveries/ack-instance-recoveries

确认已有的故障恢复，防止未来再次发生故障时，会阻塞故障切换

orchestrator -c ack-all-recoveries --reason="dba has taken taken necessary steps"

orchestrator -c ack-cluster-recoveries -i instance.in.a.cluster.com --reason="reson message"

orchestrator -c ack-instance-recoveries -i instance.that.failed.com --reason="reson message"

3.8、relocate

调整拓扑结构，-i 指定的实例更改为 -d 指定实例的从库。

orchestrator -c relocate -i replica.to.relocate.com -d instance.that.becomes.its.master

觉得有用的朋友多帮忙转发哦！后面会分享更多devops和DBA方面的内容，感兴趣的朋友可以关注下~