项目服务:Web 服务、Worker 和定时作业。
为项目添加后台 Worker、定时作业、更多 Web 服务、数据库和 Valkey——可来自项目自身代码、其他仓库或现成镜像——服务间可按名称访问,统一账单。
一个项目通常不止一个进程。除主应用外,您还可以运行队列 Worker、夜间作业、独立 API、数据库——每个都作为拥有独立资源的 服务 运行,全部归入 同一份账单。
服务列在应用的 概览 → 服务 → 添加服务 中。一个项目最多可有 10 个服务。必须先启动主服务,且项目订阅须处于有效状态(试用期也算)。
服务类型
| 类型 | 说明 |
|---|---|
| Web 服务 | 另一个网站或 API——可有公开地址,也可仅限内部访问 |
| 后台 Worker | 持续运行:队列、Horizon、Celery、消费者 |
| 定时作业 | 按计划启动(cron 格式,UTC),完成工作后停止 |
| PostgreSQL、MySQL、Valkey | 托管数据库——请参阅数据库 |
| NATS、RabbitMQ | 用于事件和队列的消息代理,仅限内部访问——请参阅事件与队列 |
公开地址或仅限内部
添加 Web 服务 时,请选择其访问方式——不预先选定任何选项:
- 公开地址——可从互联网通过
https://<name>.rivervo.app访问;可以绑定您自己的域名。 - 仅限内部——没有互联网地址,也没有域名;只有应用的其他服务可以访问。适合网站背后的 API、管理后台或搜索引擎。
后台 Worker、定时作业和数据库从不公开,因此无需选择。之后可以在服务的 设置 → 公开地址 中更改——请参阅服务间通信。
代码来源
本项目的代码
以另一种方式启动同一份代码:队列 Worker、调度器、WebSocket 服务器(例如 Laravel Reverb)、Monorepo 中的某个文件夹、独立 API。
- 命令 为必填项——服务运行的内容,例如
php artisan queue:work或node worker.js。 - Web 服务必须监听
$PORT中的端口。 - 定时作业 还需要 cron 格式(UTC)的 计划,例如
*/5 * * * *。 - 主服务的每个新版本也会部署到这些服务,因此它们始终运行相同的代码。
其他仓库
来自您已连接 Git 账户中其他仓库的 Web 服务或后台 Worker,有独立的分支,如有需要还可设置 项目文件夹 以及 构建和启动命令(字段留空则使用自动识别的结果)。它拥有独立的部署和版本,并会部署推送到其分支的每次提交。服务暂不支持分支预览。
现成镜像
来自 Docker Hub、GitHub Container Registry 或任何其他镜像仓库的现成镜像(Docker 镜像)的 Web 服务或后台 Worker——例如 nginx:1.27 或 ghcr.io/org/app:tag。
- 端口——镜像监听的端口;我们也会通过
$PORT传递该端口。 - 命令——可选;留空则按镜像构建时的设置启动。
- 私有镜像仓库——用户名和密码或访问令牌。它们加密存储,仅用于下载镜像,之后不再显示。
- 开启自动部署后,我们 每天检查一次 标签是否指向更新的版本并进行部署。在 部署 标签页中点击 重新下载镜像 可立即执行。
Kafka(模板)
添加服务 中的 Kafka 是一键预设:它基于官方 Apache Kafka 镜像(3.9)创建服务——KRaft 模式下的单个 Broker,不使用 ZooKeeper。适合开发和中等负载。
- 仅限内部——没有公开地址,无法从外部访问;只有应用的服务可以访问。
- 应用的其他代码服务会获得
KAFKA_BROKERS=<service name>:9092和RIVERVO_<NAME>_URL=<service name>:9092。 - 主题在首次使用时自动创建。
- 初始配置为 1 GB 内存 · 1 个 CPU 核心 · 10 GB 磁盘。与所有现成镜像服务一样,您可以修改其资源和变量。
- 其数据保存在服务磁盘上的数据文件夹中。
它不具备以下功能:
- 单个 Broker——无副本;每个主题的副本因子为 1。
- 没有托管的 Kafka 备份。 每日备份会在 Kafka 运行时以文件形式复制其数据文件夹。这并不是一致的 Kafka 备份:恢复后可能缺少最近的消息,或 Kafka 启动时可能需要恢复其日志。
- 没有维护时间窗口、无法从外部访问,也没有 Kafka 管理界面。
- Kafka 升级需由您自行完成:在服务的 设置 中更换镜像。
如需带备份且自动配置连接变量的队列和事件,请参阅事件与队列——NATS 和 RabbitMQ。
按名称互相访问
项目中的服务通过私有网络按 名称 通信:名为 api 的服务可被其他服务以 api 访问,名为 db 的数据库以 db 访问,主服务则为 web。项目内服务之间的流量不计入流量。
每个 Web 服务都会显示其 内部地址——例如 http://api:8080——其他服务会通过变量 RIVERVO_API_URL 获得该地址。工作原理、仅限内部的服务、多实例和超时:请参阅服务间通信。
每个服务都会获得项目变量(包括数据库连接),以及其自身的变量,自身变量优先于项目变量。请参阅环境变量。
资源与价格
每个服务都有独立的 内存、CPU 和 磁盘,价格与任何应用相同:内存 每 GB ¥40.00、每个 CPU 核心 ¥26.66(按月),每 GB 内存包含 10 GB 磁盘,超出部分 每 GB ¥1.00。一个服务最多可有 8 GB 内存。
添加服务后,其价格会计入项目账单——当月仅收取剩余部分的费用。项目处于免费试用期间,新服务在试用结束前免费。
概览 显示 项目合计——项目所有服务每月的总费用。
应用内部的 Worker
并不总是需要单独的服务。主应用的 进程 标签页提供:
- 后台 Worker——与网站并行运行的最多 5 个长期进程,例如队列 Worker。它们共享应用的资源,并在每次部署时重启。
- 定时命令——最多 10 个按计划执行的命令(cron 格式,UTC)。其输出记录在日志的 计划任务 下。
- 控制台——在运行中的应用内执行一次性命令,可使用应用的变量和数据库。命令最长可运行 15 分钟;此处不支持交互式命令(tinker、Shell)。
当 Worker 需要独立资源、避免繁重的队列拖慢网站时,单独的服务是更好的选择。
修改服务
从 服务 列表中打开服务。其 设置 包含命令、计划、镜像或分支以及资源;更改保存后,服务会以新设置重启。每个服务也有自己的 日志 和 监控。