kubeblocks-switchover

Document primary/secondary switchover steps with pre-checks and verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Legacy compatibility shim that preserves the switchover workflow as a reference while kubeblocks-op-switchover remains the recommended primary path for production use.

Core Features & Use Cases

  • Documents pre-checks, workflow steps, and troubleshooting for primary/secondary switchover across supported engines.
  • Covers MySQL, PostgreSQL, Redis, and MongoDB replication setups with dry-run validation and verification guidance.
  • Provides a reference workflow for maintenance scenarios, upgrades, and controlled rollouts.

Quick Start

Follow the legacy switchover workflow documented here and use kubeblocks-op-switchover as the primary production path.

Frequently Asked Questions about kubeblocks-switchover

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

FAQPage Schema
How do I perform a safe switchover for a multi-replica database cluster on Kubernetes?

To perform a safe switchover, you promote a secondary replica and demote the current primary using documented pre-checks, dry-run validation, and verification steps. This ensures high availability across supported engines like MySQL, PostgreSQL, Redis, and MongoDB.

What databases are supported for primary/secondary switchover in Kubernetes maintenance scenarios?

Primary/secondary switchover is supported for MySQL, PostgreSQL, Redis, and MongoDB replication setups. The workflow includes engine-specific steps for promoting a secondary and demoting the current primary during maintenance or controlled rollouts.

Can I validate a replication switchover before applying it to my production database?

Yes, you can validate a replication switchover before applying it by using the dry-run validation process. This checks cluster health and verifies steps before you promote a secondary and demote the current primary.

What is the recommended path for production database switchover versus this legacy workflow?

The recommended path for production database switchover is using the kubeblocks-op-switchover approach. This legacy switchover workflow serves as a reference documenting steps for promoting a secondary and demoting a primary across supported engines.

Why is my database switchover failing and how do I troubleshoot it?

If your database switchover is failing, troubleshoot it by following the documented rollback and troubleshooting guidance. Ensure pre-checks and cluster health checks pass before attempting to promote a secondary and demote the primary.

Do I need an OpsRequest to initiate a switchover for high availability?

Yes, an OpsRequest is used to initiate a switchover for high availability. It triggers the workflow to promote a secondary and demote the current primary across supported engines while enforcing safe practices like dry-run validation.