用途：端到端指导 CockroachDB 版本升级。技能会先收集部署上下文，只给出与当前层级相关的步骤。适用场景包括规划或执行自托管升级、通过 Cloud Console 发起主版本升级（Advanced、BYOC）、配置补丁应用方式、验证升级完成、决定最终化或回滚。升级前健康检查用 reviewing-cluster-health，自托管节点 drain 与维护窗口配置用 performing-cluster-maintenance。
主要能力与用法：先确认部署层级（Self-Hosted、Advanced、BYOC、Standard、Basic）、当前版本，自托管还需升级类型（主版本或补丁）、目标版本、部署平台、进程管理器、节点数。自托管主版本需最终化，补丁不需要；主版本建议禁用自动最终化：SET CLUSTER SETTING cluster.preserve_downgrade_option = '<current_version>'。升级前用 cockroach node status --decommission --certs-dir=<certs-dir> --host=<any-live-node> 校验节点存活、版本一致、副本完整，并检查无批量作业与遗留最终化。滚动升级按节点执行 drain、停服、替换二进制、验证版本、启动，逐节点确认后再继续。全部节点升级后执行 RESET CLUSTER SETTING cluster.preserve_downgrade_option 最终化，最终化不可逆；最终化前可换回旧二进制回滚。Advanced/BYOC 在 Cloud Console 发起主版本升级，补丁在维护窗口自动应用；BYOC 可在自有云账号观察滚动重启。Standard/Basic 全自动，无需操作。
限制：不可跳过主版本，必须顺序升级；最终化前须充分测试；升级期间不要更改集群设置。资料未提供具体价格与 SLA 细节。