用語集

世代

データベースのバックアップ1件で、epoch/seq の形式(例:3/17)で識別されます。各バックアップは変更分のみを含むため、保持ウィンドウ内の任意の時点に復元できます。無料プランは7日、プロプランは30日です。詳しくはバックアップと復元を参照してください。

epoch

プロジェクトデータベースの世代系列番号です。データベースが復元されたり、別のノードに移動されたりするたびに1つ増加します。同じプロジェクト内であっても、epoch が異なれば異なるデータ系列を意味するため、それより前の epoch からのリクエストは拒否されます。

現在の値はワーカーから読み取れます。

const { project, epoch } = await env.db.identity();

Runlot-Epoch リクエストヘッダーからも取得できます。

スロット

ノードが1つのプロジェクトに割り当てる実行単位です。各スロットは1つのプロセス、1つのポート、1つのデータディレクトリを保持します。プロジェクトをどのノードのどのスロットに配置するかを決めることを**配置(placement)**と呼びます。

自動停止（park）

リクエストがない状態が一定時間(デフォルトで5分)続いた後に、ワーカープロセスをシャットダウンすることです。データは保持され、新しいリクエストが来るとプロジェクトは自動的に再起動します。詳しくは停止と再開を参照してください。

これは管理者が設定する一時停止状態とは異なります。自動停止は次のリクエストによって解除されますが、管理者が一時停止したプロジェクトは手動で解除する必要があります。

コールド

ノード上のプロセスのみを停止する場合とは異なり、これはデータベースが外部ストレージに移動された状態です。ノードのディスク容量が不足すると、データベースは暗号化されてオフサイトに保管されます。復元には約6〜7秒かかります。詳しくは再有効化を参照してください。

wire

PostgreSQL プロトコルを使ってデータベースに直接接続します。アドレスは <project>--<org>.wire.runlot.app:5433 で、psql や PostgreSQL ドライバーがこの接続を使用します。ワーカーの env.db と同じデータベースに到達しますが、動作は異なります。wire 接続はセッションを維持しますが、env.db は呼び出しごとに新しいセッションを使用します。

フロント

受信リクエストの対象プロジェクトを判定し、アクセス制御をチェックし、必要に応じてプロジェクトを再起動する層です。runlot-* ヘッダーもこの層で追加されます。HTTP と wire のリクエストはどちらもこのフロントを通過します。

org

プロジェクトを所有し、請求と権限の設定を保持する単位です。デプロイアドレスの 2 番目のラベルは組織の slug です（例: my-app.me.runlot.app の me）。詳しくは チームとロール を参照してください。

デプロイとバージョン

runlot deploy を実行するたびに 1 つのバージョンが作成されます。デプロイ履歴は保持され、runlot rollback で以前のバージョンのいずれかを再度有効化できます。

アクセス制御と認証

• アクセス制御 — デプロイ自体に誰がアクセスできるかを決定します(public、org、password)。
• 認証 — アプリケーションに登録したユーザーを管理します(env.auth)。

この 2 つは異なるレイヤーで動作します。アクセス制御 を参照してください。