04. 部署前端 Pages

路径 B（Dev Console） — 本章适用于 Dev Console 工作流。若偏好命令行，请参阅 路径 A：部署前端 Pages。

仅部署核心前端应用：apps/web 和 apps/admin。Pages 项目会在部署时由 Dev Console 自动创建。

1. 通过 Dev Console Pipeline 部署

在 Dev Console → Deploy 标签 → Pipeline：

1. 确认后端部署（步骤 3）已完成。
2. 执行步骤 5（Deploy Frontend）。Dev Console 会依次构建并部署 web 和 admin。
3. 或使用画布：点击每个前端应用卡片（web、admin）上的 Build & Deploy 按钮。

2. 配置前端环境变量

首次部署后：

1. 在 Dev Console → Deploy 标签 → Frontend Secrets 或 Environment 区块。
2. 为 apps/web 设置：
   • 正确的后端服务 URL
   • 期望的 app_key
   • 登录或站点配置所需的公共环境变量
3. 为 apps/admin 设置 auth 相关 URL 和服务端点。

建议先用仓库默认值，确认系统正常后再自定义。

3. 若出现 SESSION binding 警告

出现无效 SESSION binding 的警告，通常表示 Cloudflare KV binding 尚未配置：

• 检查 Wrangler binding 配置
• 检查 Cloudflare Pages 或 Worker 的环境 binding
• 确认目标环境与之前准备的一致

4. 本章结束前检查清单

• 两个 Pages 项目已创建（由 Dev Console 自动创建）
• apps/web 已成功部署
• apps/admin 已成功部署
• 关键前端环境变量已填写
• 若有 SESSION 警告，已理解并处理

以上完成后，可进入域名和生产 URL 配置。