跳到主要内容

切换 ApeCloud MySQL 集群

数据库 switchover 是指在数据库集群中将主数据库的角色切换到备用数据库的过程，使备用数据库成为新的主数据库实例。通常在主数据库故障、维护或升级时执行 switchover 操作，以确保数据库服务的高可用性和连续性。可使用 kbcli 命令对 ApeCloud MySQL 集群版执行切换，KubeBlocks 将切换实例角色。

开始之前​

  • 确保集群正常运行。

  • 检查以下角色探针参数是否存在，确认是否已启用探针。

    kubectl get cd apecloud-mysql -o yaml
    >
    probes:
      roleProbe:
        failureThreshold: 2
        periodSeconds: 1
        timeoutSeconds: 1

切换集群​

将 ApeCloud MySQL 集群版集群的一个 Follower 切换为 Leader，并将原 Leader 实例切换为 Follower。

  • 不指定 Leader 实例进行切换。

    kbcli cluster promote mycluster

  • 指定一个新的 Leader 实例进行切换。

    kbcli cluster promote mycluster --instance='mycluster-mysql-2'

  • 如果有多个组件，可以使用 --components 参数指定一个组件。

    kbcli cluster promote mycluster --instance='mycluster-mysql-2' --components='apecloud-mysql'

验证集群切换​

查看实例状态，验证切换是否成功。

kbcli cluster list-instances

处理异常情况​

如果报错，请参考异常处理排查问题。