切换 MySQL 集群

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

开始之前

• 确保集群正常运行。

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

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

切换集群

将 MySQL 主备版集群的一个备节点切换为主节点，并将原主节点实例切换为备节点。

kubectl

instanceName 字段的值定义了本次切换是否指定了新的主节点实例。

• 不指定主节点实例进行切换。

  kubectl apply -f -<<EOF
  apiVersion: apps.kubeblocks.io/v1alpha1
  kind: OpsRequest
  metadata:
    name: mycluster-switchover-demo
    namespace: demo
  spec:
    clusterRef: mycluster
    type: Switchover
    switchover:
    - componentName: mysql
      instanceName: '*'
  >>

• 指定一个新的主节点实例进行切换。

  kubectl apply -f -<<EOF
  apiVersion: apps.kubeblocks.io/v1alpha1
  kind: OpsRequest
  metadata:
    name: mycluster-switchover-demo
    namespace: demo
  spec:
    clusterRef: mycluster
    type: Switchover
    switchover:
    - componentName: mysql
      instanceName: 'mycluster-mysql-1'
  >>

kbcli

• 不指定主节点实例进行切换。

  kbcli cluster promote mycluster --instance='mycluster-mysql-1' -n demo

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

  kbcli cluster promote mycluster --instance='mycluster-mysql-1' --components='apecloud-mysql' -n demo

验证集群切换

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

kubectl

kubectl get pods -n demo

kbcli

kbcli cluster list-instances -n demo

处理异常情况

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