立即开始

项目服务:Web 服务、Worker 和定时作业。

为项目添加后台 Worker、定时作业、更多 Web 服务、数据库和 Valkey——可来自项目自身代码、其他仓库或现成镜像——服务间可按名称访问,统一账单。

2 分钟阅读

一个项目通常不止一个进程。除主应用外,您还可以运行队列 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 需要独立资源、避免繁重的队列拖慢网站时,单独的服务是更好的选择。

修改服务

从 服务 列表中打开服务。其 设置 包含命令、计划、镜像或分支以及资源;更改保存后,服务会以新设置重启。每个服务也有自己的 日志 和 监控。

还有疑问?

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

联系技术支持