控制面就地升级

就地升级会替换控制面（Control Plane，CP），同时复用其数据库。源 CP 进程停止并启动目标 CP 期间，控制台和 Admin API 不可用。如果确切的版本路径允许存在混合版本窗口，现有数据面（Data Plane，DP）节点可以继续代理其最后一份有效配置。

升级准备

1. 确认确切的源版本和目标版本。对于 LTS 版本，请使用选择 LTS 升级路径；对于其他版本，请在发布说明或 API7 支持团队方案中确认该版本组合。
2. 安排 CP 管理功能中断时间，并定义写入冻结边界、验收标准、中止阈值、回滚负责人和回滚期限。
3. 保存源 CP 清单、配置项、配置、镜像标签和所需凭证。
4. 创建数据库原生备份并恢复到隔离数据库。验证恢复后的源版本和代表性资源。
5. 从目标软件包的默认配置构建目标清单，并应用特定版本路径指南和发布说明所要求的全部变更。更新每个已启用的 CP 组件，包括 api7/api7-ee-3-integrated、api7/api7-ee-dp-manager，以及已启用的开发者门户后端、API 使用情况服务或文件服务器镜像。

升级控制面

1. 开始冻结通过控制台、Admin API、开发者门户、ADC、自动化、计划任务、直接数据库集成和其他所有数据库写入方发起的管理写入。
2. 停止所有源 CP 进程和其他数据库客户端。切勿让源版本和目标版本 CP 同时连接同一个数据库。
3. 创建最终源备份，并再次完成隔离恢复检查。在整个回滚窗口内保持此备份不可变。
4. 按照特定版本路径的迁移顺序启动目标 CP。如果该路径要求使用一个控制台副本执行迁移，请让其他所有目标数据库客户端保持停止状态，直至该副本通过验证。
5. 验证目标版本、迁移日志、代表性资源、IAM 策略、许可证以及每个网关组的兼容性报告。
6. 只有迁移门禁通过后，才能恢复其余目标 CP 副本和可选组件。
7. 在预定义的观察期内观察目标 CP。如果达到中止阈值，请继续冻结写入，并按照特定版本路径执行基于备份的回滚。

只有所有必需的目标组件均健康，且指定的决策负责人记录了验收结果，CP 升级才算完成。

下一步

保持写入冻结，并继续执行数据面滚动升级。只有所有 DP 都达到已验收的目标状态后，才能恢复管理写入。