kubeblocks-op-horizontal-scale

Adjust replica or shard counts 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-horizontal-scale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubeblocks-op-horizontal-scale
Source: https://github.com/apecloud/kubeblocks-skills/tree/main/skills/kubeblocks-op-horizontal-scale
Command: npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-op-horizontal-scale

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables safe Day-2 horizontal scaling of KubeBlocks-managed database clusters by adjusting replica or shard counts.

Core Features & Use Cases

  • Validates scaling requests against the ops capability matrix before acting.
  • Routes monitoring to kubeblocks-observability-router and issues diagnostics through kubeblocks-troubleshoot.
  • Provides a clear rollback boundary and health checks post-change.

Quick Start

Scale the target cluster by increasing or decreasing replicas or shards after confirming matrix support and health readiness.

Frequently Asked Questions about kubeblocks-op-horizontal-scale

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

FAQPage Schema
How do I horizontally scale a KubeBlocks database cluster by adjusting replicas?

Horizontal scaling of a KubeBlocks database cluster adjusts replica or shard counts for existing clusters. It validates the scaling request against the ops capability matrix before applying changes and performing post-change health checks.

Can I add read replicas or shards to an existing KubeBlocks DB cluster?

Yes, adding read replicas and shards to an existing KubeBlocks DB cluster is supported. The operation verifies support in the ops capability matrix, routes monitoring to the observability router, and coordinates rollback if health checks fail.

What happens if a KubeBeans cluster horizontal scale operation fails?

If a KubeBlocks horizontal scale operation fails, the system coordinates a rollback to a clear boundary and runs health checks. It also issues diagnostics through the troubleshoot component to identify the root cause.

Does KubeBlocks horizontal scaling support all database engines and configurations?

KubeBlocks horizontal scaling applies across supported engines and configurations. The Skill validates each scaling request against the ops capability matrix to confirm whether the target engine supports the requested replica or shard changes.

When do I need to use Day-2 horizontal scaling for database clusters?

Day-2 horizontal scaling is needed when adjusting replica or shard counts for existing KubeBlocks-managed database clusters after initial deployment. It handles operational scaling scenarios by verifying matrix support and monitoring health readiness.