已合并
docs: add v25.12 cluster rollback guide #225
xuyouh创建于 9月4日
docs: add v25.12 cluster rollback guide #225
已合并
Pull Request已成功合入, 合并人@openFuyao-bot
（感谢 xuyouh 的贡献）9月4日 添加了label：sig/sig-Installation
openFuyao-bot
9月4日 评论：
9月4日 评论：
欢迎来到 openFuyao 社区
Hey @xuyouhong , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用，可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则，更多详情，请参阅此处。
联系指引
有疑问可以联系 SIG: sig-Installation ,
维护者是： @foxbit, @javadoors, @regandy, @xuyouhong, @zqw1 ,
审核者是： @piamposer-li .
9月4日 添加了label：openFuyao-cla/yes
9月4日 添加了label：ci-running
9月4日 删除了label：ci-running
此处折叠了44条消息 查看更多
xuyouh
9月8日 评论：
9月8日 评论：
合入 Checklist
摘要
本 PR 新增中英文 v25.12 集群回滚指南（备份 → 节点侧回滚 → 管理面 bc 恢复），上一轮死链等问题已在后续提交中修复，版本字段/镜像 tag 约定、阶段编号、danger/warning 与中英结构均一致；文档质量上建议合入（需先确认 Issue 关联是否仍在正文中）。量化评分通过。
主要变更
docs/zh/user_case/v25.12_cluster_rollback_guide.md：新增中文回滚操作指南（升级前备份、阶段一节点回滚、阶段二业务集群 bc 恢复、清单与 FAQ）docs/en/user_case/v25.12_cluster_rollback_guide.md：新增对等英文指南，结构与命令块与中文对齐
优点
针对评审反馈做了完整收敛：去掉不存在的 rollback_bc_recovery_guide.md 外链、区分「版本字段带 v / 镜像 tag 不带 v」、补齐 danger/warning、统一阶段编号，并保持中英双语同步。
问题
未发现需要计入评分的问题。
量化评分
| 项 | 值 |
|---|---|
| 综合得分 | 100 / 100 |
| 未处理问题 | 严重 0 / 重要 0 / 轻微 0 |
| 决策 | 通过 |
备注
重点核对结论（基线 upstream/master…pr_225 @ 10d639a）：
| 核对项 | 结论 |
|---|---|
上一轮死链 rollback_bc_recovery_guide.md |
已修复。中/英「相关文档」改为本文阶段二锚点 |
| 外链/资源存在性 | docs/{zh,en}/upgrade_guide/before_you_upgrade.md、figures/icon-{note,danger,warning}.gif、文内锚点目标均存在 |
| 版本字段带 v / 镜像 tag 不带 v | 一致。bc 字段示例为 v25.12 / v1.34.3-of.1 / v3.6.7-of.1 / v2.1.1；期望镜像 tag 为 3.6.7-of.1、1.34.3-of.1；组件表 etcd 目标为 v3.6.7-of.1 |
| 阶段编号 | 一致：准备 1.1/1.2 → 阶段一 2.1–2.5 → 阶段二 3.1–3.6 |
| danger / warning | 中英各 2×danger、2×warning、1×note，位置对应 |
| 中英文对齐 | 章节与命令块对齐；差异主要为注释/占位符本地化 |
| 括号式「版本字段为…」残留 | 无 |
流程侧：合入前按社区惯例使用已配置的 squash note。
AI 生成信息
| 项 | 值 |
|---|---|
| 辅助工具 | Cursor |
| 模型 | 未知 |
使用 gitcode-pr-review skill 生成。
该评审结果仅供参考。
javadoors
9月8日 评论：
9月8日 评论：
/lgtm
/approve
9月8日 添加了label：lgtmapproved
openFuyao-bot
9月8日 评论：
9月8日 评论：
9月8日 合入了pull request，合并节点 SHA：ddbce3aaa14c03d5ac3404db59edf821652873e3
问题背景
补丁升级失败或需回退时，缺少 v25.12 基线集群的节点侧 etcd restore 与管理面 BKECluster 恢复操作说明。
PR 类型
关联 Issue
https://gitcode.com/openFuyao/sig-installation/issues/308
变更描述
docs/zh/user_case/v25.12_cluster_rollback_guide.mddocs/en/user_case/v25.12_cluster_rollback_guide.mdv1.34.3-of.1、etcdv3.6.7-of.1、containerdv2.1.1发布说明
新增 v25.12 集群回滚操作指南（中英文），供补丁升级失败后按文档恢复。
测试验证
AI 使用声明
人工复核声明