立即开始

部署、预览和回滚。

推送如何上线、分支预览、回到早期版本、用于迁移的发布命令、构建设置、部署钩子、维护模式和预览密码。

1 分钟阅读

应用上线后,发布更改基本无需打开控制面板:推送到分支,新版本就会自动上线。本文介绍与此相关的一切——部署标签页、预览、进程标签页以及设置中的几个开关。

每次推送自动部署

每次推送到应用的分支,系统都会构建最新提交并部署。新版本在当前版本旁启动,只有在正常响应后才开始接收访客;如果新版本无法启动,原版本会继续运行,我们会通过电子邮件(如已绑定,还会通过 Telegram)通知您。

如果推送时已有构建在队列中等待,该推送会并入那次构建,因此连续多次推送不会造成长队列。

您可以在设置 → 每次推送都部署中关闭此功能。关闭后,可通过控制面板、API 或部署钩子进行部署。

从控制面板部署

部署标签页列出所有部署:触发方式(推送、控制面板、回滚、部署钩子)、提交、耗时和状态。点击某次部署可查看完整的构建日志。

重新部署提供两个选项:

  • 构建最新提交——获取分支上的最新代码并构建。
  • 重新部署当前版本——应用变更后的变量,不重新构建。编辑变量后使用。

打开旁的菜单中有同样的两个操作以及重启。

回滚

您可以回到最近 5 个成功版本中的任意一个。在部署标签页中,点击目标版本上的回滚并确认。早期版本会在当前版本旁启动,并在正常响应后接管访问——无需重新构建。

回滚不会撤销数据库更改。如果某次发布修改了数据库结构,请同时恢复数据库——请参阅数据库。

分支预览

推送到其他任何分支都会生成独立的预览——一个单独的地址,可在上线前检查更改。在预览标签页中打开。

  • 同时最多 3 个预览,已包含在价格中。
  • 7 天内没有新推送的预览会被删除。下次推送到该分支时会重新生成。
  • 预览只获得为其指定的变量——请参阅环境变量。
  • 预览只为项目的主服务生成,不为其他服务生成。

预览密码

在预览标签页中,预览密码 → 要求输入密码。输入用户名和密码(至少 8 个字符)。此后只有知道密码的人才能打开预览;应用本身仍对所有人开放。

发布命令(迁移)

进程标签页 → 发布命令。该命令在每次部署时、新版本接收访客之前运行一次——通常用于数据库迁移。如果命令失败,部署会停止,当前版本继续运行,因此出错的迁移不会影响访客。

对于有相应命令的框架,我们会给出推荐:

框架推荐的发布命令
Laravelphp artisan migrate --force
Djangopython manage.py migrate --noinput
Prisma (Node.js)npx prisma migrate deploy

使用推荐命令即保留该命令;您也可以输入自己的命令,或选择无。更改从下次部署起生效。

构建设置

在设置 → 构建设置中可以修改我们检测到的配置:

  • 安装命令——例如 npm ci
  • 构建命令——例如 npm run build
  • 启动命令——启动应用的命令。应用必须监听 $PORT 中的端口。
  • 输出目录——用于静态网站,存放构建后文件的目录。
  • 项目目录——用于包含多个项目的仓库。

留空则使用我们检测到的配置。下次部署将使用新设置构建;立即构建可马上开始。

设置中还可以指定部署的分支。

部署钩子

设置 → 部署钩子 → 创建钩子。部署钩子是一个私密地址:其他服务向它发送 POST 请求时,系统会构建并部署分支上的最新提交。典型用法是在 CMS 中发布内容后重新构建网站。

curl -X POST "<控制面板中的钩子地址>"
  • 地址只显示一次——请在创建钩子时复制。任何持有该地址的人都能触发部署,请妥善保管。
  • 每个钩子每小时最多 10 次部署。在构建等待期间到达的调用会并入该构建。
  • 撤销会立即停用该地址;调用它的服务需要使用新地址。

维护模式

设置 → 维护模式 → 显示维护页面。访客看到的不是应用,而是一个包含您留言的简短页面;留言留空时显示“我们正在进行一些改进,请稍后再来访问。”

应用本身继续运行,您可以在重新开放前检查一切。您的私密链接可让打开它的设备像平时一样访问应用,有效期 12 小时。新链接会生成新的链接,旧链接随即失效。

关闭开关即可重新向访客开放应用。

部署通知

部署未完成时,我们会通过电子邮件(如已绑定,还会通过 Telegram)通知您。如需同时将事件发送给团队——新版本上线、部署未完成、服务停止或恢复、内存或处理器占用过高、备份或数据库磁盘相关事件——请在设置 → 团队通知中添加 Slack、Discord 或您自己的 Webhook。Webhook 消息为 JSON 格式,并在 X-Rivervo-Signature 请求头中附带签名,签名密钥只显示一次。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持