用途：端到端指导 CockroachDB 版本升级。提供流程前会先收集部署上下文，只给出与运行者层级相关的步骤，涵盖升级规划、执行与验证。
主要能力：适用于自托管手动滚动二进制替换并控制最终化；Advanced、BYOC 通过 Cloud Console 发起主版本升级或配置补丁应用方式；各层级均支持验证升级完成；自托管可决定最终化或回滚。升级前健康检查建议改用 reviewing-cluster-health，节点排空与维护窗口配置建议改用 performing-cluster-maintenance。
使用方式：先确认部署层级（Self-Hosted、Advanced、BYOC、Standard、Basic）、当前版本，并视层级提供升级类型、目标版本、部署平台、进程管理器、节点数等。自托管需先做升级前校验，例如运行 cockroach node status --decommission --certs-dir=<certs-dir> --host=<any-live-node>，确认各节点 is_live=true、build 一致、ranges_underreplicated 为 0，并检查无批量作业与遗留最终化。主版本建议先禁用自动最终化：SET CLUSTER SETTING cluster.preserve_downgrade_option = '<current_version>'；随后逐节点滚动升级并逐一验证。主版本最终化不可逆，需确认 build 列一致后执行 RESET CLUSTER SETTING cluster.preserve_downgrade_option。回滚仅在最终化前可行。Advanced/BYOC 在 Cloud Console → Cluster → Settings → Upgrade 发起主版本升级，补丁在维护窗口自动应用；Standard 与 Basic 全自动，无需管理节点。
限制与注意：切勿跳过主版本、最终化前不可逆、升级期间不要更改集群设置；Advanced 需在 EOS 前自行发起主版本升级。具体可用版本、价格与支持细节暂未提供。