コンテンツへスキップ
オーラベースのロゴ
オーラベース

建築

リクエストがクライアントから Postgresにどのように伝わるか、組織とプロジェクトがどのように分離されるか、サービスがどのように拡張されるか。

解説7 分 読み取りレベル 中間2026/11/04 に改訂

このページは自動翻訳されました。英語版が正式です。

1 つのバックエンド、8 つのサービス#

Aurabase は、8 つの Axum サービスを構築する Rust モノリポジトリです。各サービスには独自のポートと独自の /v1/<service>/… ルートがあり、サービスは NATS 要求/応答を介して相互に通信します。アプリケーションからのすべてのトラフィックは 1 つのゲートウェイを通過します。

サービスは、再起動、クラッシュ、または独自に展開できます。ゲートウェイはサーキット ブレーカーを使用して各サービスの健全性を追跡します。60 秒以内に 5 回失敗すると、そのサービスに対して 503 を 30 秒間応答し、その後再試行します。

サービスと責任#

各サービスは 1 つのドメイン、独自の SQL 移行、および独自のデータを所有します。アプリケーションはゲートウェイを介してのみアクセスします。

サービスドメイン責任
aura-gatewayAPIゲートウェイプロキシ、認証ミドルウェア、レート制限、サーキットブレーカー
aura-auth認証サインアップ、サインイン、OAuth 2.1、TOTP MFA および WebAuthn、セッション、JWKS
aura-dbデータベースPostgRESTを介した CRUD、バージョン管理された移行、型の生成、スキーマ管理
aura-realtimeリアルタイムWebSocket、SSE、イベントリレー、プレゼンス、Postgres 変更データキャプチャ
aura-storageストレージS3- 互換性のあるオブジェクト ストレージ、マルチパート アップロード、署名付き URL、画像変換
aura-functionsEdge FunctionsWASM および Deno ランタイム、cron、非同期ジョブ キュー、配信不能キュー
aura-notifications通知トランザクション電子メール (SMTP)、SMS、モバイル プッシュ、HMAC署名付き Webhook
aura-aiAIゲートウェイ1 つのエンドポイント、埋め込み、pgvector を使用した RAG による LLM 推論

組織やプロジェクトごとの孤立#

各組織は独自の PostgreSQL クラスターを取得し、その組織用に予約された Kubernetes 名前空間内の CloudNativePG (CNPG) を使用してプロビジョニングされます。 2 つの組織間でクラスター、名前空間、接続プールが共有されることはありません。クラスターの容量 (vCPU、メモリ、レプリカ) は組織の計画に従います。

そのクラスター内では、各プロジェクトが独自の Postgres データベースを取得し、4 つのスキーマに分割されます。各プロジェクトには独自の接続ロールがあり、それは独自のロールのメンバーのみです。プロジェクトのスキーマに対する権限はそれらのロールに付与され、 PUBLICには付与されません。ゲートウェイは、クライアントの JWT内のプロジェクトからの接続 search_path を設定し、アプリケーション テーブルは行レベルのセキュリティ (RLS) によって保護されます。

エンタープライズ オファーでは、プロジェクトは独自の名前空間で専用の CNPG クラスターを取得することもできます。分離は、アクセス許可に加えて、クラスターの物理的な分離によってもたらされます。

スキーマオーナー内容
project_{uuid}あなたアプリケーションテーブル
project_{uuid}_authaura-authusers、 sessions、 oauth_accounts、 mfa
project_{uuid}_storageaura-storagebuckets、 objects、 rls_policies
project_{uuid}_platformプラットフォームfunctions、 jobs、 cron、 api_keys、 webhooks

次の 3 つの結果が生じます。

  • クロステナント アクセスはありません。 2 つの組織がクラスター、名前空間、または接続プールを共有することはありません。
  • 独立した移行。 各プロジェクトは独自に移行およびロールバックされます。
  • プレーン エクスポート。 pg_dump --schema='project_*' は、プロジェクトのデータ、拡張機能、およびポリシーをダンプします。
共有スキーマ

aura_console スキーマは共有されます。 projects テーブルと Studio セッションが保持されます。アプリケーションデータはそこを通過しません。

カールからPostgresへ#

ゲートウェイは、すべてのリクエストをルーティングする前にチェックします。これは、REST クライアントからの GET /v1/db/{projectId}/devices のパスです。

リクエストパスtext
1. TLS termination        client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit             token bucket, answers 429 when the limit is reached
4. Authentication         JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker        the target service is HEALTHY, so the request goes through
6. Execution              search_path set to the project's schemas, then the query runs under RLS

各ステップは、 tracingを使用して構造化ログを書き込み、 request_idによって関連付けられます。

スケーリング#

サービスはステートレスです。容量を追加するには、バイナリの別のレプリカを起動し、 NATSに接続します。準備ができたらクラスターに参加し、リクエストを処理します。リーダーの選出や分散した調整はありません。

さらに進むには#