Архитектура
Как запрос передается от вашего клиента к Postgres, как изолируются организации и проекты и как масштабируются сервисы.
Один бэкэнд, восемь сервисов#
Aurabase — это монорепозиторий Rust, в котором создаются восемь сервисов Axum. Каждая служба имеет свой собственный порт и собственные маршруты /v1/<service>/…, и службы общаются друг с другом посредством запроса/ответа NATS. Весь трафик ваших приложений проходит через один шлюз.
Служба может перезапуститься, выйти из строя или быть развернута самостоятельно. Шлюз отслеживает работоспособность каждой службы с помощью автоматического выключателя: после 5 сбоев в течение 60 секунд он отвечает на 503 для этой службы в течение 30 секунд, затем пытается повторить попытку.
Услуги и обязанности#
Каждый сервис владеет одним доменом, собственными миграциями SQL и собственными данными. Ваши приложения достигают их только через шлюз.
| Услуга | Домен | Обязанности |
|---|---|---|
aura-gateway | API-шлюз | Прокси, промежуточное программное обеспечение аутентификации, ограничение скорости, автоматический выключатель |
aura-auth | Аутентификация | Регистрация, вход, OAuth 2.1, TOTP MFA и WebAuthn, сеансы, JWKS |
aura-db | База данных | CRUD поверх PostgREST, версионная миграция, генерация типов, управление схемой |
aura-realtime | В реальном времени | WebSocket, SSE, ретрансляция событий, присутствие, сбор измененных данных Postgres |
aura-storage | Хранилище | S3— совместимое хранилище объектов, многочастная загрузка, подписанные URL-адреса, преобразование изображений |
aura-functions | Edge Functions | Среды выполнения WASM и Deno, cron, асинхронная очередь заданий, очередь недоставленных сообщений |
aura-notifications | Уведомления | Транзакционная электронная почта (SMTP), SMS, мобильные push-уведомления, веб-перехватчики с подписью HMAC |
aura-ai | AI-шлюз | Вывод LLM через одну конечную точку, встраивания, RAG с pgvector |
Изоляция по организациям и проектам#
Каждая организация получает свой собственный кластер PostgreSQL, обеспечиваемый CloudNativePG (CNPG) в зарезервированном для него пространстве имен Kubernetes. Никакой кластер, пространство имен или пул соединений не являются общими для двух организаций. Мощность кластера (виртуальные ЦП, память, реплики) соответствует плану организации.
Внутри этого кластера каждый проект получает собственную базу данных Postgres, разделенную на четыре схемы. Каждый проект имеет свою роль подключения, которая является членом только своих ролей. Права на схемы проекта предоставляются этим ролям, а не PUBLIC. Шлюз устанавливает соединение search_path из проекта в JWT клиента, а таблицы приложения защищаются безопасностью на уровне строк (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. Никакие данные приложения не проходят через него.
От завитка до Postgres#
Шлюз проверяет каждый запрос перед его маршрутизацией. Это путь GET /v1/db/{projectId}/devices от клиента REST:
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. Он присоединяется к кластеру и обслуживает запросы, когда будет готов. Здесь нет выборов лидера и нет распределенной координации.
Чтобы пойти дальше#
- База данных
Postgres, схемы, миграции, RLS, TypeScript генерация типов
- Авторизация
OAuth, MFA, жизненный цикл сеанса, RBAC
- В реальном времени
WebSocket, SSE, присутствие, изменения Postgres
- Хранилище
S3— совместимые сегменты, преобразования, подписанные URL-адреса.
- Edge Functions
Среды выполнения WASM и Deno, cron, очередь недоставленных сообщений
- Конвенции
Именование схем, столбцов и политик RLS