建筑
请求如何从您的客户端传输到 Postgres、组织和项目如何隔离以及服务如何扩展。
一个后端,八个服务#
Aurabase 是一个 Rust monorepo,它构建了八个 Axum 服务。每个服务都有自己的端口和自己的 /v1/<service>/… 路由,并且服务通过 NATS 请求/回复相互通信。来自应用程序的所有流量都经过一个网关。
服务可以重新启动、崩溃或自行部署。网关使用断路器跟踪每个服务的运行状况:在 60 秒内发生 5 次故障后,它会为该服务应答 503 30 秒,然后重试。
服务与责任#
每个服务都拥有一个域、自己的 SQL 迁移和自己的数据。您的应用程序只能通过网关到达它们。
| 服务 | 域名 | 职责 |
|---|---|---|
aura-gateway | API网关 | 代理、认证中间件、速率限制、断路器 |
aura-auth | 认证 | 注册、登录、OAuth 2.1、TOTP MFA 和 WebAuthn、会话、JWKS |
aura-db | 数据库 | CRUD over PostgREST、版本化迁移、类型生成、模式管理 |
aura-realtime | 实时 | WebSocket、SSE、事件中继、存在、Postgres 更改数据捕获 |
aura-storage | 存储 | S3- 兼容对象存储、分段上传、签名 URL、图像转换 |
aura-functions | Edge Functions | WASM 和 Deno 运行时、cron、异步作业队列、死信队列 |
aura-notifications | 通知 | 事务性电子邮件 (SMTP)、SMS、移动推送、HMAC签名的 Webhooks |
aura-ai | 人工智能网关 | 通过一个端点、嵌入、带有 pgvector 的 RAG 进行 LLM 推理 |
按组织和项目隔离#
每个组织都有自己的 PostgreSQL 集群,并在为其保留的 Kubernetes 命名空间中使用 CloudNativePG (CNPG) 进行配置。两个组织之间不共享任何集群、命名空间或连接池。集群的容量(vCPU、内存、副本)遵循组织的计划。
在该集群内,每个项目都有自己的 Postgres 数据库,分为四个模式。每个项目都有自己的连接角色,该角色仅是其自己角色的成员。项目架构的权限被授予这些角色,而不是 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 |
三个后果如下:
- 没有跨租户访问。 两个组织从不共享集群、命名空间或连接池。
- 独立迁移。 每个项目都会自行迁移和回滚。
- 普通导出。
pg_dump --schema='project_*'转储项目的数据、扩展和策略。
aura_console 架构是共享的。它保存 projects 表和 Studio 会话。没有应用程序数据经过它。
从curl到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。它会加入集群并在准备就绪时处理请求。没有领导者选举,也没有分布式协调。