サービス間の通信:内部アドレスと内部専用サービス。
1つのアプリのサービス同士が内部アドレスでアクセスする仕組み、RIVERVO_<NAME>_URL変数、公開アドレスのないサービス、複数インスタンス、タイムアウトと再試行について、Node.js、Laravel、Pythonの例とともに説明します。
1つのアプリのサービス同士は、インターネットを経由せずに直接通信します。サイトから自身のAPIを、ワーカーから内部サービスを呼び出せます。この通信は無料で、トラフィックとしてカウントされません。
以下の例では、2つのWebサービスを使います。訪問者が開くサイトで公開アドレスを持つwebと、webや他のサービスからのみ呼び出され、内部専用に設定されたapiです。
内部アドレス
すべてのWebサービス(公開アドレスありでも内部専用でも)には、http://<service-name>:<port>形式の内部アドレスがあります(例:http://api:8080)。サービスのページとアプリの概要に、コピーボタンと「このアプリの他のサービスはここからアクセスします。インターネットを経由せず、トラフィック料金もかかりません。」という説明とともに表示されます。
- ポートは、リポジトリからビルドしたサービスでは8080、既成のイメージから作成したサービスでは設定したポートです。
- このアドレスにアクセスできるのは、同じアプリのサービスだけです。インターネットや他のアプリからは開けません。
- アドレスは
http://を使います。通信はアプリの内部で完結するため、証明書の設定は不要です。
アドレスを含む変数
アドレスをコードにコピーする必要はありません。アプリのすべてのコードサービス(Webサービス、バックグラウンドワーカー、スケジュールジョブ)には、アプリの他の各Webサービスの内部アドレスを含む変数が渡されます。
RIVERVO_<NAME>_URL=http://<name>:<port>
NAMEはサービス名を大文字にし、ハイフンを_に置き換えたものです。
| サービス | 変数 |
|---|---|
api | RIVERVO_API_URL=http://api:8080 |
admin-api | RIVERVO_ADMIN_API_URL=http://admin-api:8080 |
web | RIVERVO_WEB_URL=http://web:8080 |
search(既成のイメージ、ポート7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- サービス自身を指す変数は渡されません。
- データベースとValkeyは、接続アドレスを含む独自の
RIVERVO_<NAME>_URLをそのまま持ちます。サービス名はアプリ内で一意なので、名前が重複することはありません。 - これらの変数は、変数タブの自動設定の変数に表示されます。他の自動設定の変数と同様に、同じ名前の独自の変数(または共有変数)があればそちらが使われます。環境変数をご覧ください。
- 変数は次回のデプロイでサービスに反映されます。新しいWebサービスを追加したり名前を変更したりすると、他のサービスには次回のデプロイで新しい変数や変更後の変数が渡されます。反映させるには再度デプロイしてください。たとえば
rivervo deploy <app> --no-buildなら、新しいビルドを行わずに、稼働中のバージョンを新しい変数で再起動します。
内部専用サービス
アプリの他のサービスからのみ呼び出されるWebサービス(サイトの裏側のAPI、管理用のバックエンド、検索エンジン)は、インターネットに公開する必要がありません。内部専用に設定してください。
| 公開アドレス | 内部専用 | |
|---|---|---|
インターネット上のアドレスhttps://<name>.rivervo.app | あり | なし |
| 独自ドメイン | あり | なし |
| ブランチプレビュー | あり | なし |
| 他のサービス向けの内部アドレス | あり | あり |
| 複数インスタンスとオートスケーリング、ログ、モニタリング、ヘルスチェック | あり | あり |
内部専用のサービスも他のサービスと同じように動作します。アクセスできるのが同じアプリの他のサービスだけという点のみが異なります。
サービス作成時に選ぶ
Webサービスを作成するときは(新しいアプリの最初のサービスを含み、リポジトリ、テンプレート、既成のイメージのいずれから作成する場合も)、公開アドレスか内部専用を選びます。初期選択はないため、必ずご自身で選ぶことになります。バックグラウンドワーカー、スケジュールジョブ、データベースは公開アドレスを持たないため、選択肢はありません。
この選択肢が導入される前に作成されたサービスは、公開アドレスをそのまま維持します。
後から切り替える
サービス → 設定 → 公開アドレスで、スイッチを切り替えて確定します。変更できるのは、アプリの管理者またはアカウントオーナーだけです。再起動は発生しません。
- 内部専用への切り替えは、サービスにドメインが接続されている間は拒否されます。先にドメインタブでドメインを削除してください。プレビューも先にオフにする必要があります。
- 公開アドレスを再度オンにすると、サービスには以前と同じ
https://<name>.rivervo.appのアドレスが割り当てられます。証明書の発行には1分ほどかかる場合があります。 - 内部専用のサービスへのドメイン追加は拒否されます。先に公開アドレスをオンにしてください。
ターミナルタブは、内部専用のサービスでも他のサービスと同じように使えます。
非同期通信
上記の呼び出しは応答を待ちます。サービスが処理を引き渡して先に進むべき場合(バックグラウンドジョブや、複数のサービスが反応するイベント)は、代わりにキューやメッセージブローカー(Valkey、NATS、RabbitMQ)でメッセージを送ってください。イベントとキューをご覧ください。
複数インスタンス
呼び出し先のサービスが複数のインスタンスで動いている場合、その内部名は稼働中のすべてのインスタンスにつながり、接続はそれらに振り分けられます。
接続を開いたまま再利用するクライアント(keep-aliveの接続プール)は、同じインスタンスにリクエストを送り続けることがあります。新しい接続は改めて振り分けられます。これは正常な動作で、設定は不要です。
タイムアウトと再試行
デプロイ中や、オートスケーリングがインスタンスを停止するときには、処理中のリクエストが失敗することがあります。次の2つを習慣にすると、サービス間の呼び出しが安定します。
- 短いタイムアウト:数秒にして、送信先のインスタンスが停止中でも呼び出しが止まったままにならないようにします。
- 繰り返しても安全なリクエスト(
GETでのデータ読み取り)は、短い間隔を置いて1〜2回再試行します。データを変更するリクエスト(支払い、注文)は、APIが再送と新規リクエストを区別できる場合を除き、繰り返さないでください。
例:Node.js
const api = process.env.RIVERVO_API_URL
async function getWithRetry(url, attempts = 3) {
for (let i = 1; ; i++) {
try {
const res = await fetch(url, { signal: AbortSignal.timeout(5000) })
if (res.status < 500 || i === attempts) return res
} catch (err) {
if (i === attempts) throw err
}
await new Promise((resolve) => setTimeout(resolve, 200 * i))
}
}
const res = await getWithRetry(`${api}/orders`)
const orders = await res.json()例:Laravel
config/services.phpにアドレスを記述します。
'api' => [
'url' => env('RIVERVO_API_URL'),
],その後、config()で読み込みます。本番環境では設定がキャッシュされるため、設定ファイル以外で呼び出したenv()は何も返しません。
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5)は最大5秒待ち、retry(2, 200)は200ミリ秒の間隔で最大2回試行します。
例:Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()GETを再試行する場合:
import os
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
API = os.environ["RIVERVO_API_URL"]
session = requests.Session()
retry = Retry(total=2, backoff_factor=0.2, allowed_methods=["GET"], status_forcelist=[502, 503, 504])
session.mount("http://", HTTPAdapter(max_retries=retry))
orders = session.get(f"{API}/orders", timeout=5).json()失敗したGET(接続エラー、または502、503、504の応答)は、毎回少しずつ長くなる間隔を置いて最大2回再試行されます。
コマンドラインとRivervo MCPから
rivervo appsとサービスの詳細には、各Webサービスの内部アドレスと公開アドレスの有無が表示されます。rivervo services set-public <service> on|offで公開アドレスを切り替えます。管理者ロールとフルアクセスのトークンが必要です。- Rivervo MCPでは、同じ切り替えを
set_public_addressツールで行えます。
トークンとコマンドラインについては開発者ツールをご覧ください。