用途:在改动集群前,先盘点已安装拓扑、锁定目标版本、保留 values 并演练恢复;把独立 release 合并为 umbrella 视为带停机的迁移,而非普通 chart 升级。
主要能力:区分命名空间中是单个 castai umbrella release 还是多个独立 release;梳理 Terraform、GitOps、控制台与 castctl 的归属;采集组件镜像、就绪状态、告警事件、PDB、HPA 等基线;渲染目标 umbrella values 并审查 CRD、RBAC、webhook、组件模式与被移除的 values;选择升级或迁移路径;保护恢复流程;变更后做一致性验证。
使用方式:用 Bash(helm:) 判断安装类型;用 Read 与 Grep 梳理归属;用 Bash(kubectl:) 采集基线;用 Bash(helm:) 渲染 values,Terraform 交付时用 Bash(terraform:) 保存已审查的 plan。已有 umbrella release 使用文档化的 chart 升级并加 --reset-then-reuse-values,需 Helm 3.14 或更新版本;仅改配置不改组件时锁定当前 chart 版本。独立 release 使用 Bash(castctl:*) 的 cluster migrate,期间组件与两个 autoscaler 会暂停。迁移前设置并保护 values 导出目标;umbrella 安装失败时保留生成的 values 与调试快照,修正冲突后按文档用 values 文件恢复。
适用场景:遗留集群在维护窗口内用 castctl 迁移多个独立 release 并验证为单个 umbrella release;GitOps 集群在改 values 时锁定当前 chart 以避免意外升级组件。
限制:需要确切的 kube context、安装负责人、当前 release、chart/provider 锁定与目标版本,以及维护窗口、回滚阈值和证据路径;权限冲突时不得继续。导出文件可能含敏感配置,不得公开,仅可对副本脱敏后审查。Helm 低于 3.14 需先升级客户端。变更后自动化模式不一致时应暂停推进并恢复已审查模式。具体命令细节与完整参数暂未提供。