upgrading-cluster-version

Name: upgrading-cluster-version
Availability: InStock
Author: CockroachDB

Plans and executes CockroachDB version upgrades across deployment tiers with safety checks.

3|3|Updated Mar 11, 2026

Search Tags:#rollback #maintenance #upgrade #cluster #version #cockroachdb #pre-checks

Ready to run

npx skills add https://github.com/cockroachdb/claude-plugin --skill upgrading-cluster-version

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: upgrading-cluster-version
Source: https://github.com/cockroachdb/claude-plugin/tree/main/skills/operations-and-lifecycle/upgrading-cluster-version
Command: npx skills add https://github.com/cockroachdb/claude-plugin --skill upgrading-cluster-version

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans and executes CockroachDB version upgrades across deployment tiers with tier-specific steps and safety checks to minimize risk and downtime.

Core Features & Use Cases

Tier-aware upgrade procedures for Self-Hosted, Advanced, BYOC, Standard, and Basic deployments.
Pre-upgrade health checks, rollback readiness, and finalization guidance.
Use case: tailored upgrade workflows that adapt to tier requirements and provide verification steps.

Quick Start

Specify your deployment tier and current version to generate a tailored upgrade plan.

Frequently Asked Questions about upgrading-cluster-version

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

FAQPage Schema

How do I upgrade a CockroachDB cluster version safely across different deployment tiers?▼

To upgrade a CockroachDB cluster version safely, you must follow tier-specific procedures for Self-Hosted, Advanced, BYOC, Standard, or Basic deployments, including pre-upgrade health checks, rollback readiness, and proper finalization steps to minimize downtime.

What pre-checks are required before upgrading a CockroachDB cluster?▼

Pre-upgrade health checks for a CockroachDB cluster require accessing the target cluster's CLI and SQL interface to query versions and verify operational health, ensuring the environment is ready and rollback paths are secure before execution.

Can I roll back a CockroachDB version upgrade if something goes wrong?▼

Yes, rollback options are supported during the CockroachDB version upgrade process, providing safe rollback paths and readiness checks before you finalize the new version across your deployment topology.

Do I need manual finalization for a CockroachDB Self-Hosted cluster upgrade?▼

Yes, CockroachDB Self-Hosted cluster upgrades require manual finalization, whereas Standard and Basic tier upgrades are fully automatic, and Advanced or BYOC cloud deployments are handled via the cloud console.

What is the best way to plan a CockroachDB upgrade for a specific deployment topology?▼

The best way to plan a CockroachDB upgrade is to specify your deployment tier and current version to generate a tailored workflow that adapts to tier requirements and provides verification steps for safe execution.