今すぐ始める

プロジェクトのサービス:Webサービス、ワーカー、スケジュールジョブ。

バックグラウンドワーカー、スケジュールジョブ、追加のWebサービス、データベース、Valkeyをプロジェクトに追加できます。プロジェクト自体のコード、別のリポジトリ、既成のイメージから作成でき、名前でアクセスでき、請求は1つにまとまります。

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、シェル)にはここでは対応していません。

ワーカーに独自のリソースが必要な場合は、別のサービスにするのがおすすめです。負荷の大きいキューでサイトが遅くなることがありません。

サービスの変更

サービスの一覧からサービスを開きます。設定には、コマンド、スケジュール、イメージまたはブランチ、リソースがあります。変更は保存され、サービスはその内容で再起動します。各サービスには独自のログとモニタリングもあります。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる