건축
요청이 클라이언트에서 Postgres로 이동하는 방법, 조직과 프로젝트가 격리되는 방법, 서비스 확장 방법.
백엔드 1개, 서비스 8개#
Aurabase는 8개의 Axum 서비스를 구축하는 Rust 모노레포입니다. 각 서비스에는 자체 포트와 /v1/<service>/… 경로가 있으며 서비스는 NATS 요청/응답을 통해 서로 통신합니다. 애플리케이션의 모든 트래픽은 하나의 게이트웨이를 통과합니다.
서비스는 자체적으로 다시 시작되거나 중단되거나 배포될 수 있습니다. 게이트웨이는 회로 차단기를 사용하여 각 서비스의 상태를 추적합니다. 60초 내에 5번의 오류가 발생한 후 30초 동안 해당 서비스에 대해 503에 응답한 다음 다시 시도합니다.
서비스 및 책임#
각 서비스는 하나의 도메인, 자체 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서명된 웹후크 |
aura-ai | AI 게이트웨이 | 하나의 끝점, 임베딩, pgvector을 사용한 RAG를 통한 LLM 추론 |
조직 및 프로젝트별 격리#
각 조직은 예약된 Kubernetes 네임스페이스에서 CloudNativePG(CNPG)로 프로비저닝된 자체 PostgreSQL 클러스터를 얻습니다. 클러스터, 네임스페이스 또는 연결 풀은 두 조직 간에 공유되지 않습니다. 클러스터 용량(vCPU, 메모리, 복제본)은 조직의 계획을 따릅니다.
해당 클러스터 내에서 각 프로젝트는 4개의 스키마로 분할된 자체 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 세션을 보유합니다. 어떤 애플리케이션 데이터도 통과하지 않습니다.
컬에서 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
각 단계에서는 request_id로 상관된 tracing을 사용하여 구조화된 로그를 작성합니다.
스케일링#
서비스는 상태 비저장입니다. 용량을 추가하려면 바이너리의 또 다른 복제본을 시작하고 NATS에 연결하세요. 클러스터에 참여하고 준비가 되면 요청을 처리합니다. 리더 선출도 없고 분산된 조정도 없습니다.