Orchestrator数据库编排工具脚本使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00369/article/details/148490714

Orchestrator数据库编排工具脚本使用指南

orchestrator MySQL replication topology management and HA 项目地址: https://gitcode.com/gh_mirrors/orc/orchestrator

概述

Orchestrator是一款强大的MySQL复制拓扑管理工具，它提供了丰富的命令行接口和API来管理MySQL集群。本文将详细介绍如何通过脚本与Orchestrator交互，实现各种常见的数据库管理任务。

基础查询操作

查看集群别名信息

orchestrator-client -c clusters-alias

该命令会返回所有集群及其别名的列表，格式为主机名:端口,别名。这对于快速了解当前环境中的数据库集群结构非常有用。

提取并排序集群别名

orchestrator-client -c clusters-alias | cut -d"," -f2 | sort

这个管道命令先提取别名部分，然后进行排序输出，便于管理员快速浏览所有集群名称。

集群拓扑查询

查询集群主节点

orchestrator-client -c which-cluster-master -alias mycluster

此命令返回指定别名集群的主库信息，是故障转移和日常维护的重要参考。

查询集群所有实例

orchestrator-client -c which-cluster-instances -alias mycluster

该命令列出集群中所有已知实例，包括可能已经离线的节点，为全面了解集群状态提供依据。

批量操作技巧

遍历集群实例执行操作

orchestrator-client -c which-cluster-instances -alias mycluster | cut -d":" -f 1 | while read h ; do
  echo "Host is $h"
done

这种模式可以扩展为执行任何需要在多个实例上运行的操作，如配置变更、状态检查等。

半同步复制管理

禁用集群所有实例的半同步复制：

orchestrator-client -c which-cluster-instances -alias mycluster | while read i ; do
  orchestrator-client -c disable-semi-sync-master -i $i
done

仅启用主库的半同步复制：

orchestrator-client -c which-cluster-master -alias mycluster | while read i ; do
  orchestrator-client -c enable-semi-sync-master -i $i
done

禁用除主库外所有实例的半同步复制：

master=$(orchestrator-client -c which-cluster-master -alias mycluster)
orchestrator-client -c which-cluster-instances -alias mycluster | grep -v $master | while read i ; do
  orchestrator-client -c disable-semi-sync-master -i $i
done

设置只读模式

orchestrator-client -c which-cluster-instances -alias mycluster | grep -v $master | while read i ; do
  orchestrator-client -c set-read-only -i $i
done

这个操作确保所有从库保持只读状态，是维护数据一致性的重要手段。

高级API使用

获取实例完整信息

master_host=$(orchestrator-client -c which-cluster-master -alias mycluster | cut -d":" -f1)
orchestrator-client -c api -path instance/$master_host/3306 | jq .

通过API可以获取实例的详细信息，包括版本、复制状态、GTID配置等，结合jq工具可以方便地解析JSON输出。

提取特定字段

提取主机名：

orchestrator-client -c api -path instance/$master_host/3306 | jq .Key.Hostname -r

查询主库的主机名：

orchestrator-client -c api -path instance/$master_host/3306 | jq .MasterKey.Hostname -r

集群拓扑分析

列出集群所有主机名：

orchestrator-client -c api -path cluster/alias/mycluster | jq .[].Key.Hostname -r

查询每个实例的主库信息：

orchestrator-client -c api -path cluster/alias/mycluster | jq .[].MasterKey.Hostname -r

统计实例的从库数量：

orchestrator-client -c api -path instance/$master_host/3306 | jq '.Replicas | length'

数据中心的分布分析

查询实例所在数据中心

orchestrator-client -c api -path instance/mysql-bb00.dc1.domain.net/3306 | jq '.DataCenter'

分析集群在数据中心的分布

orchestrator-client -c api -path cluster/mycluster | jq '.[].DataCenter' -r | sort | uniq -c

识别跨数据中心的复制

orchestrator-client -c api -path cluster/mycluster |
    jq '.[] | select(.MasterKey.Hostname != "") |
        (.Key.Hostname + ":" + (.Key.Port | tostring) + " " + .DataCenter + " " + .MasterKey.Hostname + "/" + (.MasterKey.Port | tostring))' -r |
    while read h dc m ; do
      orchestrator-client -c api -path "instance/$m" | jq '.DataCenter' -r |
        { read master_dc ; [ "$master_dc" != "$dc" ] && echo $h ; } ;
    done

复制管理技巧

安全重启复制

orchestrator-client -c restart-replica-statements -i mysql-bb00.dc1.domain.net -query "change master to auto_position=1" | jq .[] -r | mysql -h mysql-bb00.dc1.domain.net

这种方法会根据实例当前状态生成适当的SQL语句，确保不会意外启动已经停止的复制。