部署
部署目标
一套代码实现多端部署:Cloudflare Workers、Vercel 与 Docker 容器容器化。
MuseMVP 将所有业务逻辑实现在共享的 Next.js/Node 模块中。平台差异仅存在于部署配置之中。
核心理念
一套代码,多端通行:不仅可以同时部署到多个不同平台,而且不同环境之间无需维护独立分支代码,极大降低维护成本。
目标环境对比与选择
Cloudflare Worker
边缘加速交付与 Hyperdrive 连接池。采用 HYPERDRIVE_FIRST 数据库策略。
Vercel
快速托管发布的 Serverless 路线。采用 DATABASE_URL_FIRST 数据库策略。
Docker 原生
自建基础设施与完整网络管控的 Node 容器化。采用 DATABASE_URL_FIRST 数据库策略。
生产发布前核查
引入流量前
在将生产真实流量路由至该域名之前,务必确认以下清单均已完成。
环境变量就位:确保所有必需的环境变量均已在目标平台(Dashboard / Vault)的正式环境内准确配妥。
站点链接校验:确保 NEXT_PUBLIC_SITE_URL 和各个 OAuth 登录或支付回调接口采用真实的 HTTPS 生产域名。
数据库已迁移:务必确认针对生产数据库环境执行过 pnpm drizzle:migrate。
核心流程跑通:手动或自动完整验证过“注册/登录”、“购买与计费更新”和“文档首页加载”这几项基准流程。