kubeblocks-op-switchover

Orchestrate planned primary-secondary switchovers for KubeBlocks-managed database clusters.

3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-op-switchover
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubeblocks-op-switchover
Source: https://github.com/apecloud/kubeblocks-skills/tree/main/skills/kubeblocks-op-switchover
Command: npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-op-switchover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Primary Day-2 switchover entry for KubeBlocks-managed database clusters. Use this for planned primary-secondary switchovers on existing clusters. Confirm support in the ops capability matrix when available. The legacy kubeblocks-switchover skill remains only as a compatibility shim.

Core Features & Use Cases

  • Identify the cluster, engine, and requested action for a switchover.
  • Confirm engine support against the ops capability matrix before acting.
  • Route monitoring to kubeblocks-observability-router and broken-state diagnosis to kubeblocks-troubleshoot, with rollback boundaries.

Quick Start

Initiate a planned primary-secondary switchover on an existing KubeBlocks cluster by verifying support in the ops-capability-matrix and following the predefined Day-2 workflow.

Frequently Asked Questions about kubeblocks-op-switchover

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a planned primary-secondary switchover for a database cluster?

A planned primary-secondary switchover for KubeBlocks-managed clusters is orchestrated by verifying engine support in the ops capability matrix and following a predefined workflow. This ensures safe role transition during promotion scenarios.

Can I use this switchover workflow for any database engine managed by KubeBlocks?

Switchover support depends on the specific database engine. You must confirm engine support against the KubeBlocks ops capability matrix before initiating the action to ensure the workflow is permitted.

What is a Day-2 switchover in the context of cluster management?

A Day-2 switchover is a planned operational task that orchestrates a primary-secondary role transition for existing database clusters. It includes capability verification, health checks, and rollback boundaries to avoid unsafe states.

What happens if a cluster is in a broken state during a switchover attempt?

If a cluster is in a broken state, the switchover process routes diagnosis to troubleshooting mechanisms. It establishes rollback boundaries to prevent unsafe states and ensure safe operational transitions.

Does the switchover process include monitoring and health checks?

Yes, the switchover process routes monitoring to observability tools and includes explicit health checks. These checks verify step sequencing and safe role transition throughout the operational workflow.

How does this switchover skill differ from the legacy kubeblocks-switchover?

This skill serves as the primary Day-2 switchover entry for KubeBlocks clusters. The legacy kubeblocks-switchover skill remains only as a compatibility shim for older operational workflows.