概述

今天主要总结一下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方面的内容，感兴趣的朋友可以关注下~