Перейти к содержимому
Логотип Аурабаза
аурабаза

Архитектура

Как запрос передается от вашего клиента к Postgres, как изолируются организации и проекты и как масштабируются сервисы.

Пояснение7 мин читатьУровень среднийПересмотрено 4 нояб. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Один бэкэнд, восемь сервисов#

Aurabase — это монорепозиторий Rust, в котором создаются восемь сервисов Axum. Каждая служба имеет свой собственный порт и собственные маршруты /v1/<service>/…, и службы общаются друг с другом посредством запроса/ответа NATS. Весь трафик ваших приложений проходит через один шлюз.

Служба может перезапуститься, выйти из строя или быть развернута самостоятельно. Шлюз отслеживает работоспособность каждой службы с помощью автоматического выключателя: после 5 сбоев в течение 60 секунд он отвечает на 503 для этой службы в течение 30 секунд, затем пытается повторить попытку.

Услуги и обязанности#

Каждый сервис владеет одним доменом, собственными миграциями SQL и собственными данными. Ваши приложения достигают их только через шлюз.

УслугаДоменОбязанности
aura-gatewayAPI-шлюзПрокси, промежуточное программное обеспечение аутентификации, ограничение скорости, автоматический выключатель
aura-authАутентификацияРегистрация, вход, OAuth 2.1, TOTP MFA и WebAuthn, сеансы, JWKS
aura-dbБаза данныхCRUD поверх PostgREST, версионная миграция, генерация типов, управление схемой
aura-realtimeВ реальном времениWebSocket, SSE, ретрансляция событий, присутствие, сбор измененных данных Postgres
aura-storageХранилищеS3— совместимое хранилище объектов, многочастная загрузка, подписанные URL-адреса, преобразование изображений
aura-functionsEdge FunctionsСреды выполнения WASM и Deno, cron, асинхронная очередь заданий, очередь недоставленных сообщений
aura-notificationsУведомленияТранзакционная электронная почта (SMTP), SMS, мобильные push-уведомления, веб-перехватчики с подписью HMAC
aura-aiAI-шлюзВывод LLM через одну конечную точку, встраивания, RAG с pgvector

Изоляция по организациям и проектам#

Каждая организация получает свой собственный кластер PostgreSQL, обеспечиваемый CloudNativePG (CNPG) в зарезервированном для него пространстве имен Kubernetes. Никакой кластер, пространство имен или пул соединений не являются общими для двух организаций. Мощность кластера (виртуальные ЦП, память, реплики) соответствует плану организации.

Внутри этого кластера каждый проект получает собственную базу данных Postgres, разделенную на четыре схемы. Каждый проект имеет свою роль подключения, которая является членом только своих ролей. Права на схемы проекта предоставляются этим ролям, а не PUBLIC. Шлюз устанавливает соединение search_path из проекта в JWT клиента, а таблицы приложения защищаются безопасностью на уровне строк (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

Далее следуют три последствия:

  • Нет межклиентского доступа. Две организации никогда не используют общий кластер, пространство имен или пул соединений.
  • Независимые миграции. Каждый проект мигрирует и откатывается самостоятельно.
  • Обычный экспорт. pg_dump --schema='project_*' выводит данные, расширения и политики проекта.
Общая схема

Схема aura_console является общей. Он содержит таблицу projects и сеансы Studio. Никакие данные приложения не проходят через него.

От завитка до Postgres#

Шлюз проверяет каждый запрос перед его маршрутизацией. Это путь GET /v1/db/{projectId}/devices от клиента REST:

путь запроса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. Он присоединяется к кластеру и обслуживает запросы, когда будет готов. Здесь нет выборов лидера и нет распределенной координации.

Чтобы пойти дальше#