一、操作场景
注意：为确保升级成功，请勿在升级前和升级过程中对网关实例执行变更类操作。升级过程中，网关控制台将禁止写入，请妥善安排你的升级计划。
二、步骤1：发起版本升级
1. 登录 AI 网关 控制台，进入实例列表页面。
2. 在目标实例的版本列，在右侧操作列单击更多 > 升级网关版本，弹出实例版本升级对话框。
三、步骤2：升级前检查
1. 在升级前检查页签，查看系统提示：
·确认实例处于「运行中」，未绑定启用中的弹性伸缩策略，且子网 IP 数量足够扩容。
·检查过程中请勿对实例执行变更类操作。
·升级前请确保已放通对应分组的子网网段（如默认分组 10.0.6.0/24）。升级会动态新建节点，若子网网段未在安全组、网络 ACL、防火墙、后端服务白名单等相应位置放通，新节点将被拦截，导致升级失败。可单击 VPC 控制台 链接前往检查。
2. 在升级环境检查区域，查看各检查项结果；如需重新检测，可以单击重新检查。
| 检查项 | 检查通过条件 | 检查失败处理措施 |
| 实例状态 | 状态处于运行中 | 等待实例变更完成，状态处于运行中后执行重新检查 |
| 服务后端状态 | 不存在后端指向网关 admin 地址的服务 | 删除服务或修改服务地址后执行重新检查 |
| 弹性伸缩状态 | 所有弹性伸缩规则未启用 | 关闭启用状态的弹性伸缩规则后执行重新检查 |
| 子网 IP 数量 | 子网 IP 数量足够 | 前往 VPC，释放子网 IP 后执行重新检查 |
| 节点权重 | 节点权重一致 | 前往实例详情 > 基础信息 > 部署架构，手动调整节点权重，保持节点权重一致后执行重新检查，仅专业版支持修改节点权重 |
3. 全部检查项通过后，单击下一步。
注意：说明：
注意：升级前须通过对应的子网网段放通检查，否则升级将失败。
四、步骤3：确认升级并提交
1. 在确认升级页签，阅读升级注意事项（灰度发布机制、耗时说明、连接影响、写入限制、路径匹配优先级策略变化等）。
2. 确认实例 ID、实例名称、当前网关版本信息，填写升级目标版本。确认无误后，单击下一步。
3. 在切流计划页签，勾选我已知晓网关版本升级相关事宜，并同意进行版本升级。
4. 单击升级，提交升级任务。
注意：说明：
注意：升级提交后为异步受理，系统受理后即可关闭对话框，无需等待接口返回，避免因接口超时导致升级状态不明。如有疑问可提交工单咨询。
五、步骤4：查看升级进度与结果
1. 升级提交后，在实例列表或升级详情页查看升级进度。
2. 升级页面展示各阶段的计划时间、实际时间、进度与结果。
六、灰度策略
本次升级采用灰度发布策略，整体分为两个阶段：版本升级与资源回收。升级为异步受理，避免因接口超时导致升级状态不明；升级页面将展示各阶段的计划时间、实际时间、进度与结果，升级过程全程可观测。
1. 版本升级
主要用于配置升级所需的组件资源。该过程中节点数可能临时增加，属于正常情况。升级整体耗时与实例当前节点数相关，节点数越多耗时可能越长，请耐心等待。
2. 资源回收
版本升级完成后，需你手动确认并同意执行资源回收；确认后网关将自动触发旧资源回收流程，销毁升级过程中新增的多余节点。
注意：1. 连接无损：升级过程对连接无损；若业务存在大量长连接，建议在业务低峰期进行升级操作。
注意：2. 写入限制：升级过程中将禁止写入操作，升级完成后自动恢复。
注意：3. 正则路径匹配优先级策略变更：当某个 HTTP path 同时匹配多条配置时，新版本将按正则表达式字符串长度排序（原版本按创建时间先后排序）。若你有相关配置，可能存在策略差异，请提前验证。
七、撤销升级
如在升级过程发现业务异常，可撤销升级。
1. 在 AI 网关 > 实例列表页面，找到目标网关实例，单击状态列的查看任务状态。
2. 单击撤销升级。网关将启动撤销升级任务，将流量回切以保证生产的稳定性。