升级与降级

OpenResty Edge 在 25.3.10-1 版本中引入了专门的升级降级界面，旨在优化升级流程并提升配置编译速度。本文档将为您介绍这个功能。

# 注意事项

• 在执行升级前，建议先备份重要数据，例如 OpenResty Edge Admin 数据库。
• 在执行升级前，请与我们联系，以便我们能及时提供技术支持
• 对于生产环境，建议先在测试环境验证升级流程

# 升级流程

# 创建升级任务

1. 导航至控制台的 升级/降级 界面

2. 点击 “新建任务” 按钮创建升级任务：

   

3. 在弹出的表单中填写目标版本号及相关信息：

   

# 管理升级任务

任务创建后，您可以在任务列表中查看和管理所有升级/降级任务：

# 执行升级步骤

点击任务右侧的操作按钮，展开详细的升级流程步骤：

前几个步骤涉及 OpenResty Edge 组件的升级，需要您登录到相应的服务器上执行操作。请按照命令提示完成每个步骤。

在“升级 OpenResty Edge Admin Database 的表架构”步骤时，会提示进行数据库备份，请确保您的硬盘空间足够进行备份。

完成组件升级后，系统将引导您进行配置重编译：

在此步骤中：

1. 输入应用的域名并按回车键搜索
2. 从搜索结果中选择具体应用
3. 点击 “重编译” 按钮进行配置重编译
4. 重编译完成后，测试应用是否正常工作

最佳实践：建议先重编译并测试非核心应用，确认无问题后再处理核心应用并测试。

# 批量异步重编译

对于大量应用的重编译，系统提供了异步批量处理功能：

您可以设置并发编译数量，建议设置为不超过 Edge Admin 服务器 CPU 核心数，以获得最佳性能。

# 完成升级

所有步骤成功完成后，系统将显示完成界面：

# 降级流程

# 创建降级任务

降级通常在升级过程中遇到问题时执行。如果升级步骤失败，您可以：

1. 点击 “降级” 按钮启动降级流程：

   

2. 系统将自动关闭当前升级任务，并引导您创建降级任务：

   

   系统会自动填充版本号等信息，您可以根据需要进行调整。

# 执行降级步骤

降级任务的步骤会根据升级中失败的步骤自动生成，因此每个降级任务可能包含不同的步骤：

按照界面提示，逐步完成降级操作，确保系统恢复到之前的稳定版本。

通过遵循本文档的指导，您可以安全、高效地完成 OpenResty Edge 的升级和降级操作。