日常管理

systemctl status mysqld mysqlrouter mysqld_exporter mysql-backup.timer

my -e "
  SELECT MEMBER_HOST, MEMBER_STATE, MEMBER_ROLE, MEMBER_VERSION
  FROM performance_schema.replication_group_members ORDER BY MEMBER_HOST;"

mysh

# 等价的手工命令（注意手工运行 mysqlsh 务必携带 --no-defaults）：
sudo mysqlsh --no-defaults --js -e '
shell.options.useWizards=false;
var pw = os.loadTextFile("/etc/mysql/pigsty/cluster-password").replace(/[\r\n]+$/, "");
shell.connect({user:"dbuser_cluster", password:pw, host:"127.0.0.1", port:3306,
  "ssl-mode":"VERIFY_CA", "ssl-ca":"/etc/pki/ca.crt"});
print(dba.getCluster().status());'

# 读写入口（当前主库，可填任一成员 IP 或 NODE VIP）
mysql -h <任一成员或VIP> -P 6446 -u app -pDBUser.App --ssl-mode=VERIFY_CA --ssl-ca=/etc/pki/ca.crt app

# 只读入口（从库轮询）
mysql -h <任一成员或VIP> -P 6447 -u app -pDBUser.App --ssl-mode=VERIFY_CA --ssl-ca=/etc/pki/ca.crt app

./mysql.yml -l my-test                      # 全量收敛（需全员在线）
./mysql.yml -l my-test -t mysql_provision   # 只收敛业务库与用户（更快；也可单独用 -t mysql_db 或 -t mysql_user）

mysql_parameters:
  max_connections: 500
  long_query_time: 2

./mysql.yml -l my-test --check    # 预检：确认将要发生的变更
./mysql.yml -l my-test            # 应用：自动编排滚动重启

mysh 'dba.getCluster().setPrimaryInstance("10.10.10.12:3306")'

# 场景 A：旧机器已彻底损坏失联，直接用同一 IP 准备全新机器
./node.yml  -l 10.10.10.13          # 1. 完成新机器节点纳管（仓库、共享 CA、监控代理）
./mysql.yml -l my-test --check      # 2. 预检整套集群
./mysql.yml -l my-test              # 3. 自动 rescan 摘除旧注册，并通过 Clone 重建新成员入组

# 场景 B：旧机器仍在线可达，计划内腾退重做（目标即使当前是 PRIMARY 也会自动先切主）
./mysql-rm.yml -l 10.10.10.13 -e mysql_safeguard=false   # 1. 优雅退群并清空本机数据与配置
./mysql.yml    -l my-test                                # 2. 重新初始化并通过 Clone 重建入组

# 1. 整集群停服保数据（仅停止服务并注销监控，完整保留 /data/mysql 与受管配置）
./mysql-rm.yml -l my-test -e mysql_safeguard=false -e mysql_rm_data=false

# 重新拉起并自动恢复三节点集群（无需手工删锁文件或手工 rebootCluster）
./mysql.yml -l my-test

# 2. 彻底销毁整个集群（删除 /data/mysql 与受管配置，但始终保留 /data/backups/mysql 备份）
./mysql-rm.yml -l my-test -e mysql_safeguard=false

# 如需连同软件包一并卸载：
./mysql-rm.yml -l my-test -e mysql_safeguard=false -e mysql_rm_pkg=true

systemctl list-timers mysql-backup.timer          # 查看下次备份时间
sudo systemctl start mysql-backup                 # 手工触发（HA 上仅可写主库真正执行，从库自动跳过）
journalctl -u mysql-backup --since today          # 查看备份日志

/data/backups/mysql/<集群名>/
├── 20260729T053900Z/          # 一份已 prepare 的全量备份（可直接恢复）
│   ├── backup.ok              # 提交标记：只有完整成功的备份才有
│   ├── backup.log             # XtraBackup 执行日志
│   └── ...                    # InnoDB 数据文件
├── ...                        # 按 mysql_backup_retention（默认 3）保留最近 N 份
└── latest -> 20260729T053900Z # 原子指向最新一份

ansible my-test -b -a 'ls -l /data/backups/mysql/my-test/latest'

# 0. 确认备份可用：必须存在 backup.ok
BK=/data/backups/mysql/my-meta/latest
sudo test -f "$BK/backup.ok" && sudo cat "$BK/backup.ok"

# 1. 停止备份定时器、正在运行的备份任务与数据库（Debian/Ubuntu 将 mysqld 换为 mysql），保留现场残骸
sudo systemctl stop mysql-backup.timer mysql-backup.service mysqld
sudo mv /data/mysql /data/mysql.destroyed

# 2. 回拷备份（备份已 prepare，无需再执行 --prepare；务必加 --no-defaults 与 --datadir）
sudo install -d -m 0750 -o mysql -g mysql /data/mysql
sudo xtrabackup --no-defaults --copy-back --target-dir="$BK" --datadir=/data/mysql
sudo rm -f /data/mysql/backup.ok /data/mysql/backup.log   # 清除随备份带入的记录文件

# 3. 重建备份不包含的运行子目录
sudo install -d -m 0750 -o mysql -g mysql /data/mysql/binlog /data/mysql/tmp

# 4. 重建 Pigsty 数据目录属主标记（cluster/instance/topology 按实际实例填写）
echo '{"version": 1, "cluster": "my-meta", "instance": "my-meta-1", "topology": "standalone"}' | \
  sudo tee /data/mysql/.pigsty-mysql-initialized > /dev/null
sudo chmod 0600 /data/mysql/.pigsty-mysql-initialized
sudo chown -R mysql:mysql /data/mysql

# 5. EL 系统恢复 SELinux 上下文，然后重新启动数据库与备份定时器
sudo restorecon -RF /data/mysql 2>/dev/null || true
sudo systemctl start mysqld mysql-backup.timer

# 6. 验证数据与 GTID 位点，并确认剧本可正常收敛
my -e 'SELECT @@gtid_executed; SHOW DATABASES;'
./mysql.yml -l my-meta        # 应全绿收敛（changed=0 或仅例行项）

./mysql.yml -l my-test

# 1. 在所有存活成员上比较已执行 GTID 集合，选出最新的一台（假设为 10.10.10.12）
ansible 10.10.10.11,10.10.10.12 -b -a "mysql --defaults-extra-file=/etc/mysql/pigsty/root.cnf -NBe 'SELECT @@gtid_executed'"

# 2. 在最新成员上用 mysqlsh --no-defaults 重建集群仲裁
sudo mysqlsh --no-defaults --js -e '
shell.options.useWizards=false;
var pw = os.loadTextFile("/etc/mysql/pigsty/cluster-password").replace(/[\r\n]+$/, "");
shell.connect({user:"dbuser_cluster", password:pw, host:"10.10.10.12", port:3306,
  "ssl-mode":"VERIFY_CA", "ssl-ca":"/etc/pki/ca.crt"});
var c = dba.rebootClusterFromCompleteOutage("my-test", {force: true});
print(c.status().defaultReplicaSet.status);'

# 3. 用原 IP 补齐损坏机器后（见「替换故障成员」），整簇运行剧本自动 Clone 补齐三副本
./node.yml  -l 10.10.10.13
./mysql.yml -l my-test