建築
リクエストがクライアントから Postgresにどのように伝わるか、組織とプロジェクトがどのように分離されるか、サービスがどのように拡張されるか。
1 つのバックエンド、8 つのサービス#
Aurabase は、8 つの Axum サービスを構築する Rust モノリポジトリです。各サービスには独自のポートと独自の /v1/<service>/… ルートがあり、サービスは NATS 要求/応答を介して相互に通信します。アプリケーションからのすべてのトラフィックは 1 つのゲートウェイを通過します。
サービスは、再起動、クラッシュ、または独自に展開できます。ゲートウェイはサーキット ブレーカーを使用して各サービスの健全性を追跡します。60 秒以内に 5 回失敗すると、そのサービスに対して 503 を 30 秒間応答し、その後再試行します。
サービスと責任#
各サービスは 1 つのドメイン、独自の SQL 移行、および独自のデータを所有します。アプリケーションはゲートウェイを介してのみアクセスします。
| サービス | ドメイン | 責任 |
|---|---|---|
aura-gateway | APIゲートウェイ | プロキシ、認証ミドルウェア、レート制限、サーキットブレーカー |
aura-auth | 認証 | サインアップ、サインイン、OAuth 2.1、TOTP MFA および WebAuthn、セッション、JWKS |
aura-db | データベース | PostgRESTを介した CRUD、バージョン管理された移行、型の生成、スキーマ管理 |
aura-realtime | リアルタイム | WebSocket、SSE、イベントリレー、プレゼンス、Postgres 変更データキャプチャ |
aura-storage | ストレージ | S3- 互換性のあるオブジェクト ストレージ、マルチパート アップロード、署名付き URL、画像変換 |
aura-functions | Edge Functions | WASM および Deno ランタイム、cron、非同期ジョブ キュー、配信不能キュー |
aura-notifications | 通知 | トランザクション電子メール (SMTP)、SMS、モバイル プッシュ、HMAC署名付き Webhook |
aura-ai | AIゲートウェイ | 1 つのエンドポイント、埋め込み、pgvector を使用した RAG による LLM 推論 |
組織やプロジェクトごとの孤立#
各組織は独自の PostgreSQL クラスターを取得し、その組織用に予約された Kubernetes 名前空間内の CloudNativePG (CNPG) を使用してプロビジョニングされます。 2 つの組織間でクラスター、名前空間、接続プールが共有されることはありません。クラスターの容量 (vCPU、メモリ、レプリカ) は組織の計画に従います。
そのクラスター内では、各プロジェクトが独自の Postgres データベースを取得し、4 つのスキーマに分割されます。各プロジェクトには独自の接続ロールがあり、それは独自のロールのメンバーのみです。プロジェクトのスキーマに対する権限はそれらのロールに付与され、 PUBLICには付与されません。ゲートウェイは、クライアントの JWT内のプロジェクトからの接続 search_path を設定し、アプリケーション テーブルは行レベルのセキュリティ (RLS) によって保護されます。
エンタープライズ オファーでは、プロジェクトは独自の名前空間で専用の CNPG クラスターを取得することもできます。分離は、アクセス許可に加えて、クラスターの物理的な分離によってもたらされます。
| スキーマ | オーナー | 内容 |
|---|---|---|
project_{uuid} | あなた | アプリケーションテーブル |
project_{uuid}_auth | aura-auth | users、 sessions、 oauth_accounts、 mfa |
project_{uuid}_storage | aura-storage | buckets、 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 のパスです。
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に接続します。準備ができたらクラスターに参加し、リクエストを処理します。リーダーの選出や分散した調整はありません。