performing-cluster-maintenance

Plan and coordinate CockroachDB cluster maintenance across deployment tiers.

3|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/cockroachdb/claude-plugin --skill performing-cluster-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performing-cluster-maintenance
Source: https://github.com/cockroachdb/claude-plugin/tree/main/skills/operations-and-lifecycle/performing-cluster-maintenance
Command: npx skills add https://github.com/cockroachdb/claude-plugin --skill performing-cluster-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manages planned cluster maintenance across all CockroachDB deployment tiers. Self-Hosted covers node drain procedures for OS patching, hardware changes, and configuration updates. Advanced/BYOC covers maintenance window configuration, patch scheduling, deferral policies, and monitoring during CRL-managed maintenance. Standard and Basic maintenance is fully managed with no customer action. Use when planning maintenance, configuring maintenance windows, or preparing applications for maintenance events.

Core Features & Use Cases

  • Supports tier-aware drain, maintenance window configuration, patch scheduling, and monitoring during CRL-managed maintenance.
  • Provides pre-maintenance validation checks and post-maintenance verification to ensure cluster health and availability.
  • Use case: plan OS patches, hardware changes, or configuration updates, schedule maintenance windows, and verify recovery across all deployment tiers.

Quick Start

Plan and execute a maintenance window for your CockroachDB cluster.

Frequently Asked Questions about performing-cluster-maintenance

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

FAQPage Schema
How do I perform node draining for CockroachDB cluster maintenance?

Node draining for CockroachDB cluster maintenance safely redistributes traffic before OS patching or hardware changes. The skill provides tier-aware drain procedures with pre-maintenance validation checks to ensure cluster health and minimize downtime across Self-Hosted deployments.

What is a CockroachDB maintenance window and when do I need to configure one?

A CockroachDB maintenance window is a scheduled period for applying patches and configuration updates. You need to configure one when planning maintenance events on Advanced or BYOC deployments to manage patch scheduling, deferral policies, and CRL-managed monitoring.

Does CockroachDB maintenance planning work across all deployment tiers?

CockroachDB maintenance planning works across all deployment tiers. Self-Hosted covers node drain procedures, Advanced and BYOC support maintenance window configuration, while Standard and Basic maintenance is fully managed by Cockroach Labs with no customer action required.

How do I verify CockroachDB cluster health after completing maintenance?

Verify CockroachDB cluster health after maintenance by running post-maintenance verification checks. The skill provides validation procedures to ensure cluster availability, confirm successful recovery, and validate that all nodes are operational across the applicable deployment tiers.

What are the prechecks required before draining a CockroachDB node?

Prechecks before draining a CockroachDB node involve pre-maintenance validation checks that assess cluster health and availability. The skill satisfies high-level prerequisites and workflow requirements, including tier-specific steps to ensure safe node draining and prevent data loss.

What's the best way to schedule CockroachDB patching to minimize downtime?

The best way to schedule CockroachDB patching to minimize downtime is by configuring maintenance windows with defined patch scheduling and deferral policies. The skill coordinates maintenance across deployment tiers, applying safety guidelines and monitoring during CRL-managed maintenance events.