본문으로 건너뛰기
아우라베이스 로고
아우라베이스

건축

요청이 클라이언트에서 Postgres로 이동하는 방법, 조직과 프로젝트가 격리되는 방법, 서비스 확장 방법.

설명7분 읽기레벨 중급2026. 11. 4.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

백엔드 1개, 서비스 8개#

Aurabase는 8개의 Axum 서비스를 구축하는 Rust 모노레포입니다. 각 서비스에는 자체 포트와 /v1/<service>/… 경로가 있으며 서비스는 NATS 요청/응답을 통해 서로 통신합니다. 애플리케이션의 모든 트래픽은 하나의 게이트웨이를 통과합니다.

서비스는 자체적으로 다시 시작되거나 중단되거나 배포될 수 있습니다. 게이트웨이는 회로 차단기를 사용하여 각 서비스의 상태를 추적합니다. 60초 내에 5번의 오류가 발생한 후 30초 동안 해당 서비스에 대해 503에 응답한 다음 다시 시도합니다.

서비스 및 책임#

각 서비스는 하나의 도메인, 자체 SQL 마이그레이션 및 자체 데이터를 소유합니다. 귀하의 애플리케이션은 게이트웨이를 통해서만 도달합니다.

서비스도메인책임
aura-gatewayAPI 게이트웨이프록시, 인증 미들웨어, 속도 제한, 회로 차단기
aura-auth인증가입, 로그인, OAuth 2.1, TOTP MFA 및 WebAuthn, 세션, JWKS
aura-db데이터베이스PostgREST에 대한 CRUD, 버전 마이그레이션, 유형 생성, 스키마 관리
aura-realtime실시간WebSocket, SSE, 이벤트 릴레이, 존재 여부, Postgres 변경 데이터 캡처
aura-storage저장S3-호환 가능한 객체 스토리지, 멀티파트 업로드, 서명된 URL, 이미지 변환
aura-functionsEdge FunctionsWASM 및 Deno 런타임, cron, 비동기 작업 큐, 배달 못한 편지 큐
aura-notifications알림거래 이메일(SMTP), SMS, 모바일 푸시, HMAC서명된 웹후크
aura-aiAI 게이트웨이하나의 끝점, 임베딩, pgvector을 사용한 RAG를 통한 LLM 추론

조직 및 프로젝트별 격리#

각 조직은 예약된 Kubernetes 네임스페이스에서 CloudNativePG(CNPG)로 프로비저닝된 자체 PostgreSQL 클러스터를 얻습니다. 클러스터, 네임스페이스 또는 연결 풀은 두 조직 간에 공유되지 않습니다. 클러스터 용량(vCPU, 메모리, 복제본)은 조직의 계획을 따릅니다.

해당 클러스터 내에서 각 프로젝트는 4개의 스키마로 분할된 자체 Postgres 데이터베이스를 갖습니다. 각 프로젝트에는 해당 역할의 구성원인 자체 연결 역할이 있습니다. 프로젝트 스키마에 대한 권한은 해당 역할에 부여되며 PUBLIC에는 부여되지 않습니다. 게이트웨이는 클라이언트의 JWT프로젝트에서 search_path 연결을 설정하고 애플리케이션 테이블은 행 수준 보안(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까지#

게이트웨이는 모든 요청을 라우팅하기 전에 확인합니다. 이는 REST 클라이언트의 GET /v1/db/{projectId}/devices 경로입니다.

요청 경로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

각 단계에서는 request_id로 상관된 tracing을 사용하여 구조화된 로그를 작성합니다.

스케일링#

서비스는 상태 비저장입니다. 용량을 추가하려면 바이너리의 또 다른 복제본을 시작하고 NATS에 연결하세요. 클러스터에 참여하고 준비가 되면 요청을 처리합니다. 리더 선출도 없고 분산된 조정도 없습니다.

더 나아가려면#