部署上线

从生产配置和 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,请替换成自己的域名。命令会涉及远程资源的地方会明确说明,不要把本地调试和生产操作混在一起。

部署完成与正式开放

终端显示部署成功,说明脚本中的构建、发布和检查已经完成。注册邮件是否送达、用户支付后是否获得权益、业务任务是否执行成功,还需要通过真实流程验证。

建议先完成测试环境中的功能验证,再部署正式配置,最后按验收清单开放注册和收款。后续每次更新,也可以沿着同一套步骤检查受影响的功能。