Architecture overview

Stable

Компоненты платформы: CP, Gateway, Compute, Storage и Console.

Обновлено: 4 февраля 2026 г.

Основные компоненты платформы и их зоны ответственности.

Control Plane (CP): каталог tenants/БД/timeline/state, выдаёт API‑ключи и DSN‑шаблоны, инициирует start/stop, валидирует auth, публикует API v2.
Console: web‑интерфейс поверх API CP. Все действия в UI эквивалентны вызовам API/CLI.
Provisioner: поднимает и уничтожает compute (Kubernetes pod/VM), прокидывает bootstrap‑спеку агенту (timeline, адреса Pageserver/Safekeeper, register_token).
Gateway: единый внешний PostgreSQL endpoint (TLS). При отсутствии compute инициирует autostart и маршрутизирует соединение.
Compute/Agent: живёт внутри compute, получает сертификат, генерирует и применяет managed‑конфиг PostgreSQL, стартует Postgres, регистрируется в CP, публикует readiness/health.
Safekeeper: принимает WAL от PostgreSQL и отгружает сегменты в объектное хранилище.
Pageserver: подписывается на WAL, применяет его и пишет page‑слои в объектное хранилище. Источник истины для данных и timeline.
S3‑совместимое хранилище: долгоживущие данные и WAL; compute можно терять без потери состояния.

Ключевая идея: compute — статeless, а состояние БД живёт в Pageserver/Safekeeper/S3. Это позволяет быстро стартовать/останавливать БД и восстанавливаться после сбоев без ручных процедур.