このファイルには、コード内に実際に存在するこのアーキテクチャが文書化されており、2026 年 8 月 23 日の時点でファイルごとに検証されており、図、図、抜粋が含まれています。これは、「Rust Engineering」クラスターの柱となるページです。概要と、公開されている、または公開中の詳細な技術分析 (Axum、Cargo ワークスペース、ゲートウェイ、PostgREST、pg_graphql、およびファイルの残りの部分) へのリンクが示されています。競合する BaaSとの完全な製品比較については、 の比較 Aurabase と Supabaseを参照してください。
必需品
- シングル ワークスペース カーゴ: 1 つの
cargo build --workspaceによってまとめてコンパイルされた 18 クレート (11 のビジネス サービス、auraCLI、5 つの共有ライブラリ、 Rust SDK)。 - ビジネス コードの重さは約 274,000 行の Rust (2026 年 8 月 23 日、
find+wc -lで測定) で、これらの 18 個のクレートに分散されています。 - ゲートウェイ (
aura-gateway) は、データ (SDK、ポート 8080) と管理 (Studio、ポート 8090) の 2 つのプレーンを分離し、それぞれが独自のミドルウェア スタックと認証を備えています。 - Aurabase は PostgRESTを書き換えません。実際のアップストリーム バイナリ (16.5) はテナントごとに実行され、Rust サービスによって調整されます。付加価値は代わりにではなく、その周りにあります。
- 純粋な Rustからの唯一の顕著な違い: Edge Functions (
denoモード) のデフォルトのランタイムは、V8 Isolates に基づく専用の TypeScript サービスです。wasmモード用に、ネイティブおよび Wasmtime経由の Rust 内の 2 番目のパスが存在します。
Aurabase とサービスごとに組み立てられた BaaS の違い
ほとんどのオープン ソース Postgres BaaS は、サービスを複数の言語でパッケージ化しています。これは価値判断ではありません。これは具体的な結果をもたらすアーキテクチャ上の事実です。つまり、使用されている言語と同数のコンパイル チェーン、エラー規約、認証ロジックが同期を保つ必要があります。
Aurabaseでは、私たちが自分たちで作成および保守する製品レイヤー (ゲートウェイ、認証、データベース、リアルタイム、ストレージ、通知、AI、プロビジョニング、アカウント管理) は、単一の Cargo ワークスペース、単一言語、単一のビルド チェーンです。これは、このファイルに記載されている選択です。
「統合コア」とは、運用環境で実行されているすべてのものが Rustであることを意味するものではありません。他の Postgres BaaSと同様に、 Aurabase も、自身が作成したものではないオープンソースのビルディング ブロック ( PostgreSQL 自体、 PostgREST、 NATS) に依存しています。異種スタックの構造上の違いは、これらの共有ビルディング ブロックには関係しません。それは、それらを調整する製品層に関係します。次のセクションでは、コードを監査したときに見つかった唯一の実際の例外 (Edge Functions、セクション 09) を含め、この境界が正確にどこを通過するかについて詳しく説明します。
18 個のクレート、1 つのコンパイル チェーン
ルート Cargo.toml は、リゾルバー v2 の Cargo ワークスペース を 18 メンバー (11 のビジネス サービス、aura-cliCLI、5 つの共有ライブラリ、および aurabase-rsSDK) で宣言します。リポジトリに表示される実際のリストは次のとおりです。
[workspace]
resolver = "2"
members = [
# サービス (11)
"services/aura-gateway", "services/aura-auth", "services/aura-db",
"services/aura-provisioner", "services/aura-realtime", "services/aura-storage",
"services/aura-functions", "services/aura-notifications", "services/aura-ai",
"services/aura-migrator", "services/aura-control",
# ツール
"aura-cli",
# リブ (5)
"libs/aura-core", "libs/aura-crypto", "libs/aura-db-adapters",
"libs/aura-migrations", "libs/aura-telemetry",
"aurabase-rs",
]
共有依存関係は [workspace.dependencies]に存在します: Axum 0.8 (WebSocket、マルチパート、マクロを使用)、Tokio、Tower/Tower-HTTP、SQLx 0.8 (Postgres + セカンダリ NoSQL エンジンの mongodb 経由の MongoDB)、async-nats 0.47、sqlparser 0.53 (NL2SQLの SQL 検証) )、oauth2 5、jsonwebtoken 10、およびほぼすべてのサービスにある 2 つのパフォーマンス ライブラリ (グローバル アロケーターとしての mimalloc と、メモリ内キャッシュ用の moka/dashmap) です。
リリース プロファイルには、 "abort"ではなく panic = "unwind" という想定される選択が記載されています。ファイルのコメントは一目瞭然です。Axum/Tokio ハンドラーのパニックは、プロセス全体をダウンさせて競合するリクエストを遮断するのではなく、ランタイムによって分離されます (影響を受けるリクエストは 500 を返します)。この同じメモによれば、abort のパフォーマンスの向上 (RPS の約 1 ~ 2%) は、絶縁の損失に見合うものではありません。これは、コードに記載されている信頼性と速度のトレードオフであり、マーケティング上の主張ではありません。
単一の cargo build --workspace で全体がコンパイルされます。単一の cargo test --workspace がテスト スイート全体を実行します。単一の cargo clippy --workspace --all-targets -- -D warnings は、同じルールで製品全体をリントします。この構造の詳細 (依存関係の継承、ライブラリとサービス間の内部グラフ、構造の拡張中に遭遇した落とし穴) は、専用記事の主題です: Cargo ワークスペース アーキテクチャ、マルチサービス Rust バックエンドを構造化する方法。
サービス別の Rust 行 (find services -name '*.rs' | xargs wc -l、2026 年 8 月 23 日):
オーラコントロール
36 024
オーラデータベース
30 255
オーラ認証
28 431
オーラプロビジョナー
28 271
オーラ通知
18 498
持つだろう
18 305
オーラゲートウェイ
16 938
オーラリアルタイム
16 799
オーラストレージ
13 747
オーラ機能
11 619
オーラマイグレーター
538
共有ライブラリ (aura-db-adapters: 24,725 行、aura-core: 7,259、aura-migrations: 3,641、aura-crypto: 2,718、aura-telemetry: 201)、CLI (aura-cli: 9,845) および Rust SDK (aurabase-rs: 6,363)。 aura-migrator は、一度だけ使用する移行ジョブであり、長期間存続する HTTP サーバーではなく、ワークスペース内で意図的に最小のサービスのままです。
11 のビジネス サービス、それぞれがスタンドアロンの Axum サーバー
各サービスは、独自の構成とポートを備えた独立した Axum/Tokio バイナリです。 11 個のうち 10 個は /health と /metrics を公開し、 mimalloc をグローバル アロケーターとして宣言します。唯一の例外である aura-migratorは、継続的に実行されるサーバーではなく、単一目的のジョブです。
| オーラゲートウェイ | デュアルプレーン ゲートウェイ (データ:8080、管理:8090): 他のすべてのサービスへのプロキシ。 |
|---|---|
| オーラ認証 | 認証: JWT、15 の名前付き OAuth プロバイダー + プロジェクト、セッション、 MFAごとの汎用 OIDC。 |
| オーラデータベース | データベース API: PostgREST テナントごとの管理/リロード、Postgres および MongoDB アダプター、CDC。 |
| オーラプロビジョナー | プロジェクトのライフ サイクル: テナントごとの専用または共有 CNPG クラスター、ロール、PostgREST。 |
| オーラリアルタイム | WebSocket と SSE、CDC ブロードキャスト、NATS JetStream KV を介したクロスインスタンス プレゼンス。 |
| オーラストレージ | S3 互換オブジェクト (SeaweedFS)、 Postgresから転送可能な RLS ポリシー。 |
| オーラ機能 | Edge Functions: デプロイメント、ジョブ、cron、ネイティブ Wasmtime ランタイム (セクション 09 を参照)。 |
| オーラ通知 | 電子メール、プッシュ、送信 Webhook。 |
| 持つだろう | NL2SQL、RAG および LLM ゲートウェイ (ネイティブ OpenAI、Anthropic、Gemini + 任意の OpenAI 互換エンドポイント)。 |
| オーラマイグレーター | 移行エンジン: プロビジョニングごとに再生される保持スキーマの単一ソース。 |
| オーラコントロール | 管理プラン: 開発者アカウント、組織、請求、Studio API。 |
aura CLI (約 9,800 行) は SDK と同じ API と通信します。これには特権パスがありません。各サービスの完全なリファレンスは、アーキテクチャ ドキュメント および CLI リファレンスにあります。
サービス間のドリフトを回避する 5 つのクレート
多言語スタックでは、セキュリティ ルール (エラー形式、SSRF 保護、レート制限) を言語ごとに再実装する必要があり、ほとんどの場合、数か月にわたって変動します。 Aurabase は、これをワークスペース ライブラリに 1 回コーディングし、関連するすべてのサービスによって使用されます。
| オーラコア | 7 259 l. | 共有プリミティブ: エラー、API 応答エンベロープ、JWT クレーム、内部サービス間認証、NATS ヘルパー、レート制限、SSRF で保護された HTTP クライアント、サーキット ブレーカー、テナント解決、メータリング。 |
|---|---|---|
| aura-db-アダプター | 24 725 l. | aura-db で使用される統合データベース、Postgres、および MongoDB 実装を適応させる特性。 |
| オーラクリプト | 2 718 l. | パスワード ハッシュ、トークン生成、JWT 署名/検証、フィールド レベルの暗号化。 |
| オーラの移行 | 3 641 l. | 移行エンジン — プロビジョナーによって再生されるテナント スキーマの単一ソース (各サービスの移行/特定のフォルダーではありません)。 |
| オーラテレメトリー | 201 l. | OpenTelemetry + トレース構成。11 のサービスで共有されます。 |
直接的な影響: aura-core のセキュリティ パッチ (SSRF 保護など) は、5 つの言語で 5 つの個別のパッチを介するのではなく、次の cargo buildの各コンシューマ サービスに伝播します。
デュアル プラン: SDK トラフィックと Studio トラフィック
aura-gateway は、同じクライアントも同じ認証モデルも持たない 2 つのサーフェスを分離します。データ プレーン (ポート 8080、変数 GATEWAY_PORT) は、API キー (apikey、 X-API-Key または ?apikey=) によって認証された SDK/アプリ トラフィックを受信します。管理プレーン (ポート 8090、 MANAGEMENT_PORT) は、 JWT コンソール (Authorization: Bearer) によって認証された Studio/管理トラフィックを受信します。
// データプレーン — API キー
.route("/v1/auth/{*path}", any(auth_proxy))
.route("/v1/db/{*path}", any(db_proxy))
.route("/v1/realtime/ws", get(realtime_ws_proxy))
.route("/v1/realtime/sse", get(realtime_sse_proxy))
.route("/v1/storage/{*path}", any(storage_proxy))
.route("/v1/notifications/{*path}", any(notifications_proxy))
.route("/v1/ai/{*path}", any(ai_dispatcher))
.route("/v1/functions/{*path}", any(functions_proxy))
// 管理計画 — JWT コンソール
.route("/v1/control/{*path}", any(control_proxy))
各プレーンには独自のミドルウェア スタック (クエリ識別、アクセス ログ、レート制限、認証 (プレーン固有)、サーキット ブレーカー、プロキシ) が搭載されています。これらは、互いに同じように信頼すべきではない 2 つのサーフェス間で偶然共有された単一のチェーンではなく、別個のモジュール (middleware/rate_limit.rs、 middleware/circuit_breaker.rs、 middleware/auth_data_plane.rs、 middleware/auth_management_plane.rs) に実装されています。方法。
ミドルウェアの正確な順序、ターゲットごとのレート制限、および NATS/HTTP プロキシについては、専用の記事「 デュアルプレーン ゲートウェイ、 Rustでのデータ プレーン/管理プレーン API ゲートウェイの設計」の主題です。
Aurabase が Rust で PostgREST を再実装しない理由
SDK が使用する自己生成 REST API は、社内の Rust モジュールではありません。これは、実際のアップストリーム バイナリ PostgREST (postgrest/postgrest:v16.5) であり、専用プロジェクト (deploy/cnpg/tenant-postgrest.yaml) ごとに 2 つのレプリカにデプロイされ、テナントの CNPG インスタンスと同じ場所に配置されます。 aura-provisioner はこのデプロイメントを作成し、aura-db は各スキーマのリロード後にそのエンドポイント OPTIONS を調査して、PostgREST が DDL の変更を考慮していることを確認します。
これは、近道ではなく、想定されるアーキテクチャ上の選択です。PostgREST は成熟した、広く採用されているプロジェクトであり、その動作を Rust で少しずつ書き換えても何も起こりません。 Aurabaseの Rust の作業は、クエリ エンジン自体の内部ではなく、マルチテナント ルーティング、プロビジョニング、NetworkPolicy によるネットワーク分離、ゲートウェイとの共有認証、調整されたスキーマ リロードに焦点を当てています。この互換性が実際に何をカバーするのか、またどこで終わるのかについては、別の記事で説明します: PostgREST、実際の互換性、およびの代替案。
GraphQL 側でも同じロジック: Postgres 拡張機能 pg_graphql (プリコンパイルされた .deb パッケージ、v1.6.1) は専用の CNPG イメージにインストールされ、POST /v1/control/projects/{project_id}/graphql/enable エンドポイントを介してプロジェクトごとにオンデマンドでアクティブ化されます。これは書き換えられた GraphQL エンジンでもありません。 Hasura および PostGraphileとの詳細および正直な比較: Postgres 上のネイティブ GraphQL API と pg_graphql。
RLS と認証者の役割 (アプリケーション層ではない)
マルチテナント分離は、アプリケーション ORM によって追加された WHERE tenant_id = ? フィルターに依存しません。各リクエストは aura_authenticatorロールを通過し、リクエストを実行する前にトランザクション スコープの SET LOCAL ROLE tenant_<uuid> を実行します。これは、まさに PostgREST 自体が期待するモデルです。行レベルのセキュリティは、残りの部分をビジネス コード レベルではなくエンジン レベルで実行します。
すべてのプロジェクトが同じ Postgres トポロジを共有するわけではありません。 aura-provisioner コードは、少なくとも 2 つの実際のバリアントを持つ ProjectInstanceKind 型を公開します。 FullyDedicated (完全にプロジェクト専用のCNPG インスタンス) と SharedClusterDedicated (共有 CNPG クラスター上の RLS によって分離されたスキーマ) です。契約したプランによってトポロジが決まります。これは「全員に専用のベースを提供する」という一律の約束ではありません。
「純粋にアプリケーションを分離するのではなく、プロジェクトごとに専用ベースを使用する理由」という観点は、専用記事の主題です: RLS およびプロジェクトごとの専用ベース。 行レベル セキュリティ ドキュメントでは、実際の実装について説明しています。
JetStreamではなく NATS コア: サービス間の非同期メッセージング
11 のビジネス サービスのうち 10 は、Cargo.toml の直接の依存関係として async-nats を宣言しています。宣言なしで宣言しているのは aura-migrator だけです。このクレート名が示していないこと: これらのサービスは、ほぼどこでも [JetStreamではなく、 NATS、コア パブ/サブ API (Client::publish / publish_with_headers、 最大 1 回配信 、永続化または再生なし) を使用しています。](https://docs.nats.io/nats-concepts/jetstream)。これは、最も重要な 3 つの用途のコードで検証されたケースです。 PostgreSQL CDC から aura-realtimeへの配布、 aura-functions での Edge Functions ジョブの通知 (DLQ 自体は NATSではなく Postgresに存在します)、 aura-provisioner と残りの部分の間のイベントのプロビジョニングです。艦隊。
JetStream — NATS' 永続性と名前付きストリーム モード — モノリポジトリ内の 1 つの検証済みの場所にのみ表示されます: aura-realtime のクロスインスタンス プレゼンス KV ストア (バケット aura_presence、メモリ ストア、60 秒 max_age)。これは、ws-front の複数のインスタンス (クロスインスタンス) 間で誰がどのチャネルに接続しているかを同期します。共有状態であり、再生するイベントのストリームではありません。ワークスペース内の他の場所では、永続的な JetStream ストリームが見つかりませんでした。 CDC パイプラインの詳細 - wal2json、Lease Kubernetes による一意の cdc-worker の選択、ws-frontレプリカへのコア NATS ファンアウト、サブスクライバーによる RLS 再検証 - は専用記事の主題です: は PostgreSQL をブロードキャストします CDC NATS。 リアルタイム ドキュメント では、SDK 側での使用法について説明しています。
Edge Functions: 2 つのニーズに対応する 2 つのランタイム
これは、このファイルの最も重要なニュアンスであり、Aurabase 製品コードの純粋な Rust からの唯一の実質的な相違点です。各関数は、 "wasm" または "deno"に相当する runtime フィールドを持ちます。呼び出しハンドラーはそれに応じて実行パスを選択します。実際のスニペットはコード自体でコメント化されています。
// ランタイムに応じたディスパッチ: WASM (wasmtime) または Deno (エッジ ランタイム経由の V8 分離)
let resp = if func.runtime == "wasm" {
state.runtime.invoke(&wasm_bytes, &func.code_hash, req).await?
} else {
// aura-edge-runtime へのプロキシ — V8 分離 (supabase/edge-runtime、MIT)
proxy_to_edge_runtime(&state.config.edge_runtime_url, …).await?
};
wasm モードはネイティブです。 aura-functions は Wasmtime (バージョン 43、機能 async および cranelift) に直接依存し、燃料カウント、エポックによる割り込み、 StoreLimitsによるメモリ境界を使用して、同じ Rust プロセスでモジュールを実行します。 deno モード — 既存の Supabase コードとのほぼ直接的な Deno.serve() 互換性のために Studio エディターでデフォルトで使用されるモード — supabase/edge-runtime で明示的にモデル化された、約 550 行の別個の TypeScript サービスである aura-edge-runtimeに実行を委任します。 (MIT ライセンス)。各呼び出しを独自の V8 Isolate に分離します。
制御 (デプロイメント、権限、ジョブ、cron、クォータ) は完全に aura-functionsの Rust に残ります。 deno モードでユーザー コードを実行した場合のみ、Rust バイナリが終了します。これは防御可能なエンジニアリング上の妥協 (V8 Isolates は Deno がこのレベルのサンドボックスにネイティブに提供するものです) であり、黙っておきたい省略ではありません。 Wasmtime と Wasmer の比較と WebAssembly のコールド スタート分析は、このファイルで近々公開されますが、このテーマについてさらに詳しく説明します。
両方のデプロイメント パスのハウツー ドキュメントについては、 Edge Functionsを参照してください。 Supabaseからの Deno 移行プレイブックについては、「 Supabase プロジェクトを Aurabaseに移行する」を参照してください。この違いについては、このファイルの前にすでに説明されています。
この心が一つになることで具体的に何が変わるのか
SDK を通じて API を呼び出すだけの場合、このアーキテクチャは目に見えなくなります。これが目標です。これは主に 3 つの対象者にとって重要です。実稼働データを移行する前にマルチテナント バックエンドの運用信頼性を評価する人、リポジトリ (MIT、単一モノリポジトリ) に貢献する予定の人、および Aurabase 側のセキュリティ パッチがなぜゆっくりではなく急速に広まるのかを理解したい人です。
具体的には、1 つの IC (cargo build --workspace、 cargo test --workspace、 cargo clippy --workspace --all-targets -- -D warnings) で製品表面の 90% 以上をカバーします。 aura-core のコード レビューは、良く言えば (修正が途中で失われない)、悪くすれば (分離が不十分な変更が同じくらい早く広がる)、一度に 10 個のサービスに影響を与える可能性があります。これは魔法の解決策ではなく妥協策です。だからこそ、マーケティング概要ではなく実際のアーキテクチャを文書化します。
Rust エンジニアリング ファイルの残りの部分
このピラー ページは、公開されたクラスターの技術分析にリンクしています。このページの公開時の実際のステータス — 対応する記事がオンラインになるとすぐにリンクがアクティブになります。
クラスター A — フレームワークとアーキテクチャ
Axum と Actix-web: 本番環境の Rust バックエンドのフレームワークはどちらですか?公開されました
Cargo ワークスペース アーキテクチャ: マルチサービスの構築方法 Rust バックエンド公開済み
デュアルプレーン ゲートウェイ: Rustでのデータプレーン/管理プレーン API ゲートウェイの設計公開済み
クラスター B — Postgres の自己生成 API
PostgREST: 互換性が実際にカバーするものと、代替手段が存在するもの公開済み
Postgres と pg_graphqlのネイティブ GraphQL API : Hasura と PostGraphile が同じことをしないこと公開
RLS およびプロジェクトごとの専用ベース: Aurabaseからのマルチテナント絶縁の選択
クラスター C — リアルタイムとメッセージング
PostgreSQL CDC を NATSで配布: リアルタイム アーキテクチャ公開
クラスター D — Edge Functions WebAssembly
| Wasmtime と Wasmer: 運用環境での Edge Functions の WebAssembly ランタイム | 近日公開予定 |
|---|---|
| Rust/WASM の Edge Functions と Cloudflare Workers および Vercel Edge の比較 | 近日公開予定 |
| WebAssembly のコールド スタート: ベンチマークが実際に示していること (そしてまだ言えないこと) | 近日公開予定 |
クラスター E — 移行と代替案
RLS ポリシーを書き換えずに、Supabase プロジェクトを Aurabase に移行します。公開済み
ソブリン セルフホスティング: Rustに対する Aurabase の位置付け -native BaaS近日公開予定