部署上线
从生产配置和 Cloudflare 资源,到正式域名、业务验收与后续更新,完成网站上线。
前面的章节已经介绍了服务申请、项目创建、业务开发和功能配置。本章把这些内容连接成一次完整发布:确认要部署到哪里,准备生产配置,发布代码与数据,再在正式域名上验证真实业务。
如果你已经跟着首次部署把项目部署到 workers.dev,可以直接准备生产配置并执行更新,无需重新创建 Cloudflare 资源。跟做 WebpageToPDF 实战教程的读者,还需要先部署自己增加的 PDF Worker 等业务依赖。
本章保留哪些内容
部署按六个任务组织。上线前检查放进生产配置和验收流程,第三方回调与域名切换放在一起,发布后观察与故障处理放进最后一篇。
| 顺序 | 文章 | 解决的问题 |
|---|---|---|
| 1 | 确认部署环境与 Cloudflare 资源 | 账户、Worker、D1、KV、R2 和 Queue 分别是什么,哪些由脚本创建 |
| 2 | 准备生产配置与密钥 | 哪些配置需要上线前替换,如何同步环境变量 |
| 3 | 管理生产数据库与内容 | 数据库初始化、增量迁移、备份和文档同步如何配合 |
| 4 | 首次部署与后续更新 | 选择正确命令,理解执行顺序和中断后的处理方式 |
| 5 | 正式域名与第三方回调 | 切换站点地址,同步登录、支付、Turnstile 和邮件配置 |
| 6 | 上线验收与日常维护 | 验证关键流程,观察后台任务,处理发布故障 |
按当前状态选择入口
| 当前状态 | 下一步 |
|---|---|
| 只有本地项目,尚未创建远程资源 | 准备生产配置后运行 npm run deploy:init |
已有可访问的 workers.dev 站点 | 核对资源和配置,准备绑定正式域名 |
| 已部署且已有正式域名 | 修改代码或生产配置后运行 npm run deploy:update |
| 上次命令中途失败 | 先确认失败阶段和远程状态,按中断处理继续 |
首次部署、更新和域名切换不是同一条命令的不同写法。它们检查的前提、修改的资源以及执行顺序都不同,后文会分别说明。
本章命令均在使用 Saavo 创建的应用根目录执行。示例正式地址统一使用 https://app.example.com,请替换成自己的域名。命令会涉及远程资源的地方会明确说明,不要把本地调试和生产操作混在一起。
部署完成与正式开放
终端显示部署成功,说明脚本中的构建、发布和检查已经完成。注册邮件是否送达、用户支付后是否获得权益、业务任务是否执行成功,还需要通过真实流程验证。
建议先完成测试环境中的功能验证,再部署正式配置,最后按验收清单开放注册和收款。后续每次更新,也可以沿着同一套步骤检查受影响的功能。