Webdev 服务端与自动部署上线
本次更新概览
本次更新在 Tony 已完成主要开发内容的基础上,将 Webdev 服务端版本正式部署到生产服务器,并完成自动发布闭环。
- Tony 完成主体开发:包括 Webdev 服务端化、聊天助手相关接口,以及构建、打包、上传和 release 发布流程。
- 我这边完成生产落地:将 Tony 的代码成功部署到服务器,配置长期运行服务和网站转发。
- 补齐权限范围外的工作:完善 Tony 因缺少服务器和 GitHub 管理权限而无法完成的生产配置、密钥接入、发布验证和回滚流程。
当前主站、中英文页面、聊天助手服务端接口和 Anura 健康检查均已通过验证。
这次工作的重点不是重新开发 Tony 已完成的功能,而是把现有成果从“代码和部署流程基本完成”推进到“生产环境正式可用”。
工作衔接
Tony 已完成的内容
- 将 Webdev 从静态导出模式调整为 Next.js 服务端运行模式。
- 完成聊天助手及相关服务端接口所需的代码改造。
- 完成服务端版本的构建、打包、上传和 release 发布流程。
- 编写新的 GitHub Actions 部署 workflow,并整理部署所需的服务名称、端口和运行账号等配置。
- 完成代码层面的测试、构建和 standalone 产物准备。
Tony 已经完成了本次更新的绝大部分内容。剩余部分主要依赖生产服务器和 GitHub 管理权限,因此无法在他的权限范围内彻底完成。
本次完成的部署与闭环
我这边负责将 Tony 已完成的代码和 workflow 接入真实生产环境:
- 核对服务器上的运行账号、端口、Node.js 环境和现有服务状态。
- 在服务器上创建并启用 Webdev 的长期运行服务。
- 将 Nginx 从静态文件模式切换为 Next.js 服务端反向代理。
- 成功部署 Tony 的服务端版本,并完成首次静态站到服务端的生产切换。
- 补齐 GitHub Actions 中与服务器权限和生产环境相关的配置。
- 完善发布前检查、启动等待、页面验证、接口验证和失败回滚。
- 加固部署密钥和运行时密钥的传输与临时文件清理。
- 统一自动构建与服务器运行环境,完成两轮真实自动部署验证。
本次协作的实际分工是:Tony 完成主要产品和工程实现,我这边完成生产部署、权限衔接与自动发布闭环。
产品侧变化
升级完成后,Webdev 不再只是静态页面,可以稳定承载聊天助手等需要服务端运行的产品能力。
后续产品版本进入生产分支后,系统会自动完成:
1. 代码质量检查。 2. 自动测试和生产构建。 3. 服务端产物打包与上传。 4. 新版本发布和服务切换。 5. 首页、中英文页面和服务端接口验证。 6. 发布失败时恢复上一稳定版本。
这意味着后续 Webdev 更新不再依赖人工上传和手动切换文件,发布效率和稳定性均得到提升。
当前上线状态
- 主站可正常访问。
- 英文和中文页面可正常访问。
- 页面已确认由 Next.js 服务端提供。
- 聊天助手服务端接口已正常接入生产环境。
- Webdev 服务已设置为服务器启动后自动运行。
- Anura 页面和接口未受到本次切换影响。
- 最新两次自动部署均完整通过。
产品验收入口
- 主站:https://kldevelopmentlab.com/
- 英文页面:https://kldevelopmentlab.com/en/
- 中文页面:https://kldevelopmentlab.com/zh/
- Anura:https://kldevelopmentlab.com/anura/
后续发布方式
日常开发仍在主开发分支进行。只有经过确认、需要正式上线的版本才进入生产分支,并触发自动部署。
建议下一步为生产分支增加发布保护,避免未经确认的代码被直接推送到线上。