云云AI 开发日志:静态官网与控制台的环境和部署整理

部署从确认环境开始

网页端可以在本地运行,也可以生成测试或正式环境的静态产物。真正准备部署时,我首先确认构建使用哪个后端地址,而不是只看构建命令有没有执行成功。页面能打开,不代表它正在请求正确的业务环境。

云云AI 的营销站和控制台分别读取自己的环境变量。这两个入口需要一起检查,避免官网介绍来自一个环境,登录后的订单和直播数据却来自另一个环境。

静态页面的数据在构建时确定

Astro 的公开页面在构建阶段获取后端内容,再写入 HTML。测试构建和正式构建应明确指定 API 地址;如果沿用了本地地址,服务器上即使能够访问静态文件,也可能出现内容缺失或数据不符合预期。

因此检查营销站时,我会看首页内容、定价信息和博客链接是否完整,也会核对页面标题与描述。构建日志通过以后,还需要看生成的页面是否符合预期。

控制台需要检查直接访问

Vue 控制台包含多条业务路由。用户可能从首页点击进入,也可能收藏某个页面后直接打开。Nginx 的静态站配置需要正确处理这些路径,页面刷新后仍然能够进入对应的前端路由。

业务接口继续直连后端域名。检查控制台时,登录、登录失效、页面刷新和接口错误都是值得覆盖的访问方式,不能只走一次最顺利的点击流程。

把检查过程留成可复用记录

项目按范围进行类型、格式、测试和构建检查,生成产物后再做浏览器冒烟验证。维护者审核正式产物,再按既定流程发布。这些步骤把源码问题、环境问题和页面问题分别暴露出来。

这次整理让我更明确地把部署看作一条完整链路:选择环境、构建、检查页面、审核产物。以后继续更新官网和控制台时,这份日志也可以作为回看部署边界的入口。

项目链接

云云AI · 直播助手

同项目开发日志