專案的服務:網頁服務、工作程序與排程工作。
在專案中新增背景工作程序、排程工作、更多網頁服務、資料庫與 Valkey——來自專案本身的程式碼、另一個儲存庫或現成映像檔——可透過名稱互相連線,並合併在同一張帳單。
一個專案不只是一個程序。除了主應用程式,您還可以執行佇列工作程序、夜間工作、獨立的 API、資料庫——每個都是擁有自己資源的服務,全部合併在同一張帳單。
服務列在應用程式的總覽 → 服務 → 新增服務。一個專案最多可有 10 個服務。主服務必須先上線,且專案的訂閱必須有效(試用期也算)。
服務類型
| 類型 | 說明 |
|---|---|
| 網頁服務 | 另一個網站或 API——擁有公開網址或僅限內部 |
| 背景工作程序 | 持續執行:佇列、Horizon、Celery、消費者 |
| 排程工作 | 依排程啟動(cron 格式,UTC),完成工作後停止 |
| PostgreSQL、MySQL、Valkey | 代管資料庫——請參閱資料庫 |
| NATS、RabbitMQ | 處理事件與佇列的訊息代理,僅限內部——請參閱事件與佇列 |
公開網址或僅限內部
新增網頁服務時,請選擇連線方式——預設不會選取任何選項:
- 公開網址——可從網際網路透過
https://<name>.rivervo.app開啟;可以使用您自己的網域。 - 僅限內部——沒有網際網路網址,也沒有網域;只有應用程式的其他服務能連到它。適合網站背後的 API、管理後端或搜尋引擎。
背景工作程序、排程工作與資料庫永遠不會公開,因此不需要選擇。之後可在服務的設定 → 公開網址中變更——請參閱服務之間的通訊。
程式碼來源
此專案的程式碼
以另一種方式啟動相同的程式碼:佇列工作程序、排程器、WebSocket 伺服器(例如 Laravel Reverb)、monorepo 中的某個資料夾、獨立的 API。
- 指令為必填——服務要執行的內容,例如
php artisan queue:work或node worker.js。 - 網頁服務必須監聽
$PORT中的連接埠。 - 排程工作還需要 cron 格式(UTC)的排程,例如
*/5 * * * *。 - 主服務的每個新版本也會部署到這些服務,因此它們始終執行相同的程式碼。
另一個儲存庫
來自您已連接 Git 帳戶中另一個儲存庫的網頁服務或背景工作程序,擁有自己的分支,必要時也可設定專案資料夾與建置與啟動指令(欄位留空即使用我們偵測到的設定)。它有自己的部署與版本,並會部署推送到其分支的每次更新。目前尚未為服務提供分支預覽。
現成映像檔
來自 Docker Hub、GitHub Container Registry 或任何其他登錄檔中現成映像檔(Docker 映像檔)的網頁服務或背景工作程序——例如 nginx:1.27 或 ghcr.io/org/app:tag。
- 連接埠——映像檔監聽的連接埠;我們也會透過
$PORT傳入。 - 指令——選填;留空則依映像檔的建置方式啟動。
- 私人登錄檔——使用者名稱與密碼或存取權杖。這些資訊會加密保存,只用於下載映像檔,且不會再次顯示。
- 開啟自動部署時,我們會每天檢查一次標籤是否指向較新的版本並進行部署。部署分頁中的重新下載映像檔可立即執行。
Kafka(範本)
新增服務中的 Kafka 是一鍵預設:它會從官方 Apache Kafka 映像檔(3.9)建立服務——KRaft 模式下的單一代理,不使用 ZooKeeper。適合開發與中等負載。
- 僅限內部——沒有公開網址,也無法從外部存取;只有應用程式的服務能連到它。
- 應用程式的其他程式碼服務會取得
KAFKA_BROKERS=<service name>:9092與RIVERVO_<NAME>_URL=<service name>:9092。 - 主題會在第一次使用時自動建立。
- 起始配置為 1 GB 記憶體 · 1 個 CPU 核心 · 10 GB 磁碟。與任何來自現成映像檔的服務一樣,您可以變更其資源與變數。
- 資料保存在服務磁碟上的資料資料夾中。
它不具備的功能:
- 單一代理——沒有複寫;每個主題的複寫因子都是 1。
- **沒有代管的 Kafka 備份。**每日備份會在 Kafka 執行時,以檔案形式複製其資料資料夾。這不是一致性的 Kafka 備份:還原後可能遺失最近的訊息,或 Kafka 啟動時可能需要復原其日誌。
- 沒有維護時段、無法從外部存取,也沒有 Kafka UI。
- Kafka 的升級由您自行處理:在服務的設定中變更映像檔。
若需要具備備份與自動設定連線變數的佇列與事件,請參閱事件與佇列——NATS 與 RabbitMQ。
透過名稱互相連線
專案的服務透過私人網路以名稱互相通訊:名為 api 的服務,其他服務可透過 api 連到它,名為 db 的資料庫則透過 db,主服務則是 web。專案內服務之間的流量不計入流量。
每個網頁服務都會顯示其內部網址——例如 http://api:8080——其他服務則會透過變數 RIVERVO_API_URL 取得。運作方式、僅限內部的服務、多個執行個體與逾時:請參閱服務之間的通訊。
每個服務都會取得專案的變數——包括資料庫連線——以及自己的變數,後者優先於專案的變數。請參閱環境變數。
資源與價格
每個服務都有自己的記憶體、CPU 與磁碟,計價方式與任何應用程式相同:記憶體每 GB $207.51、每個 CPU 核心 $138.34,按月計費,每 GB 記憶體內含 10 GB 磁碟,超出部分每 GB $5.19。一個服務最多可有 8 GB 記憶體。
新增服務時,其價格會加到專案的帳單中——當月只計算剩餘的部分。專案在免費試用期間,新服務在試用結束前免費。
總覽會顯示專案合計——專案所有服務每月的總費用。
應用程式內的工作程序
不一定需要獨立的服務。主應用程式的程序分頁提供:
- 背景工作程序——在網站旁最多可執行 5 個長時間執行的程序,例如佇列工作程序。它們共用應用程式的資源,並在每次部署時重新啟動。
- 排程指令——最多 10 個依排程執行的指令(cron 格式,UTC)。其輸出記錄在日誌的排程下。
- 主控台——在執行中的應用程式內執行一次性指令,可使用其變數與資料庫。指令最多可執行 15 分鐘;這裡不支援互動式指令(tinker、shell)。
當工作程序需要自己的資源,讓繁重的佇列永遠不拖慢網站時,獨立服務是更好的選擇。
變更服務
從服務清單開啟服務。其設定包含指令、排程、映像檔或分支,以及資源;變更會儲存,服務會套用變更後重新啟動。每個服務也有自己的日誌與監控。