プロジェクトのサービス:Webサービス、ワーカー、スケジュールジョブ。
バックグラウンドワーカー、スケジュールジョブ、追加のWebサービス、データベース、Valkeyをプロジェクトに追加できます。プロジェクト自体のコード、別のリポジトリ、既成のイメージから作成でき、名前でアクセスでき、請求は1つにまとまります。
プロジェクトは1つのプロセスだけではありません。メインのアプリの横で、キューワーカー、夜間ジョブ、別のAPI、データベースを、それぞれ独自のリソースを持つサービスとして動かせます。請求はすべて1つにまとまります。
サービスはアプリの概要 → サービス → サービスを追加に表示されます。1つのプロジェクトで最大10個のサービスを利用できます。メインのサービスを先に起動し、プロジェクトのサブスクリプションが有効である必要があります(無料お試し期間も含みます)。
サービスの種類
| 種類 | 内容 |
|---|---|
| Webサービス | 別のサイトまたはAPI。公開アドレスあり、または内部専用 |
| バックグラウンドワーカー | 常時稼働:キュー、Horizon、Celery、コンシューマー |
| スケジュールジョブ | スケジュール(cron形式、UTC)に従って起動し、処理を終えると停止 |
| PostgreSQL、MySQL、Valkey | マネージドデータベース。データベースをご覧ください |
| NATS、RabbitMQ | イベントとキューのためのメッセージブローカー(内部専用)。イベントとキューをご覧ください |
公開アドレスか内部専用か
Webサービスを追加するときは、アクセス方法を選びます。初期選択はありません。
- 公開アドレス:インターネットから
https://<name>.rivervo.appでアクセスでき、独自ドメインも設定できます。 - 内部専用:インターネット上のアドレスもドメインもなく、アプリの他のサービスからのみアクセスできます。サイトの裏側のAPI、管理用のバックエンド、検索エンジンに適しています。
バックグラウンドワーカー、スケジュールジョブ、データベースは公開されることがないため、選択肢はありません。後からサービスの設定 → 公開アドレスで変更できます。サービス間の通信をご覧ください。
コードの取得元
このプロジェクトのコード
同じコードを別の方法で起動します。キューワーカー、スケジューラー、WebSocketサーバー(例:Laravel Reverb)、モノレポのフォルダー、別のAPIなどです。
- コマンドは必須です。サービスが実行するもので、例:
php artisan queue:work、node worker.js。 - Webサービスは
$PORTのポートで待ち受ける必要があります。 - スケジュールジョブには、cron形式(UTC)のスケジュールも必要です。例:
*/5 * * * *。 - メインのサービスの新しいバージョンはすべて、これらのサービスにもデプロイされるため、常に同じコードで動作します。
別のリポジトリ
接続済みのGitアカウントにある別のリポジトリから、Webサービスまたはバックグラウンドワーカーを作成します。独自のブランチと、必要に応じてプロジェクトフォルダー、ビルドコマンドと起動コマンドを指定します(空欄にすると自動判別した内容を使います)。独自のデプロイとバージョンを持ち、ブランチへのプッシュごとにデプロイされます。サービスのブランチプレビューにはまだ対応していません。
既成のイメージ
Docker Hub、GitHub Container Registry、その他のレジストリにある既成のイメージ(Dockerイメージ)から、Webサービスまたはバックグラウンドワーカーを作成します。例:nginx:1.27、ghcr.io/org/app:tag。
- ポート:イメージが待ち受けるポート。
$PORTでも渡されます。 - コマンド:任意。空欄にするとイメージの既定の方法で起動します。
- プライベートレジストリ:ユーザー名と、パスワードまたはアクセストークン。暗号化して保存され、イメージのダウンロードにのみ使われ、再表示されることはありません。
- 自動デプロイが有効な場合、タグが新しいバージョンを指しているかを1日1回確認し、デプロイします。デプロイタブのイメージを再ダウンロードですぐに実行することもできます。
Kafka(テンプレート)
サービスを追加のKafkaは、ワンクリックで使えるプリセットです。Apache Kafkaの公式イメージ(3.9)からサービスを作成します。ZooKeeperを使わないKRaftモードの単一ブローカーです。開発用途や中程度の負荷に適しています。
- 内部専用:公開アドレスも外部からのアクセスもなく、アプリのサービスからのみアクセスできます。
- アプリの他のコードサービスには
KAFKA_BROKERS=<service name>:9092とRIVERVO_<NAME>_URL=<service name>:9092が渡されます。 - トピックは初めて使われたときに自動で作成されます。
- 初期状態はメモリ1GB・CPU 1コア・ディスク10GBです。既成のイメージから作成した他のサービスと同様に、リソースと変数を変更できます。
- データはサービスのディスク上のデータフォルダーに保存されます。
含まれないもの:
- ブローカーは1つ:レプリケーションはなく、すべてのトピックのレプリケーション係数は1です。
- **Kafkaのマネージドバックアップはありません。**毎日のバックアップは、Kafkaの稼働中にデータフォルダーをファイルとしてコピーします。これはKafkaとして整合性のあるバックアップではありません。復元後に直近のメッセージが欠けていたり、起動時にKafkaがログを復旧する必要があったりする場合があります。
- メンテナンス時間の設定、外部からのアクセス、Kafka UIはありません。
- Kafkaのアップグレードはお客様ご自身で行います。サービスの設定でイメージを変更してください。
バックアップと接続用の変数が自動で設定されるキューとイベントについては、イベントとキューのNATSとRabbitMQをご覧ください。
名前で相互にアクセス
プロジェクトのサービスは、プライベートネットワーク上で名前を使って通信します。apiという名前のサービスには他のサービスからapiで、dbという名前のデータベースにはdbで、メインのサービスにはwebでアクセスできます。プロジェクトのサービス間の通信はトラフィックとしてカウントされません。
各Webサービスには内部アドレス(例:http://api:8080)が表示され、他のサービスには変数RIVERVO_API_URLで渡されます。仕組み、内部専用のサービス、複数インスタンス、タイムアウトについてはサービス間の通信をご覧ください。
各サービスには、プロジェクトの変数(データベースの接続情報を含む)に加えて、サービス独自の変数が渡されます。独自の変数はプロジェクトの変数より優先されます。詳しくは環境変数をご覧ください。
リソースと料金
各サービスは独自のメモリ、CPU、ディスクを持ち、料金は通常のアプリと同じです。メモリ1GBあたり¥1,052、CPU 1コアあたり¥701(月額)で、メモリ1GBにつきディスク10GBが含まれ、それを超える分は**1GBあたり¥26**です。1つのサービスで最大8GBのメモリを利用できます。
サービスを追加すると、その料金がプロジェクトの請求に加算されます。当月分は残りの期間分のみです。プロジェクトが無料お試し期間中の場合、新しいサービスはお試し期間の終了まで無料です。
概要にはプロジェクト合計(プロジェクトの全サービスの月額合計)が表示されます。
アプリ内のワーカー
必ずしも別のサービスが必要とは限りません。メインのアプリのプロセスタブには次のものがあります。
- バックグラウンドワーカー:サイトの横で動く、最大5つの常駐プロセス(例:キューワーカー)。アプリのリソースを共有し、デプロイのたびに再起動します。
- スケジュールコマンド:スケジュール(cron形式、UTC)で実行する最大10個のコマンド。出力はログのスケジュールに記録されます。
- コンソール:稼働中のアプリ内で、その変数とデータベースを使って一度だけのコマンドを実行します。コマンドは最長15分実行できます。対話型のコマンド(tinker、シェル)にはここでは対応していません。
ワーカーに独自のリソースが必要な場合は、別のサービスにするのがおすすめです。負荷の大きいキューでサイトが遅くなることがありません。
サービスの変更
サービスの一覧からサービスを開きます。設定には、コマンド、スケジュール、イメージまたはブランチ、リソースがあります。変更は保存され、サービスはその内容で再起動します。各サービスには独自のログとモニタリングもあります。