skills.rest
cockroachdb
cockroachdbOFFICIAL
Explore all skills by this author →
WebsiteGitHub

upgrading-cluster-version

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
One-click install
npx skills add https://github.com/cockroachdb/claude-plugin --skill upgrading-cluster-version
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
stakpakstakpak
4

infrastructure-software-upgrades

Plan and execute infrastructure component upgrades with backups and rollback options.

Official
Intermediate
rohitg00rohitg00
944

k8s-diagnostics

Diagnose Kubernetes cluster health, metrics, and resource differences across namespaces.

Community
Intermediate
air-gappedair-gapped
5

rancher-upgrade

Plan and sequence community-edition Rancher upgrades across air-gapped multi-cluster fleets.

Official
Advanced
cockroachdbcockroachdb
3

managing-cluster-capacity

Automates CockroachDB cluster capacity planning and execution across deployment tiers.

Official
Advanced