←К документации

Self-hosted deployment overview

Stable

Обзор развёртывания spg99 в Kubernetes/облаке.

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

Self-hosted развёртывание ориентировано на команды, которые хотят запустить spg99 в своём Kubernetes/облаке.

Этот документ — обзор. Конкретные манифесты/values зависят от вашей поставки.

Компоненты

  • control-plane — API, каталог, выдача register_token/certs, оркестрация start/stop.
  • gateway — единая PostgreSQL точка входа (TLS), прокси/пул соединений.
  • provisioner — создаёт compute (pods/VM), подготавливает bootstrap.
  • pageserver — хранение данных timeline в S3, выдаёт страницы compute.
  • safekeeper — приём WAL, устойчивость при сбоях, интеграция с S3.
  • console — UI для пользователей (опционально).

Минимальные требования

  • Kubernetes кластер (желательно 3+ зоны доступности для HA).
  • Persistent Volumes (SSD рекомендуется) для:
    • control-plane каталога,
    • pageserver кэша/working dir,
    • safekeeper данных/сегментов.
  • S3‑совместимое объектное хранилище (durability слой).
  • Ingress/DNS для публикации:
    • <gateway-host>:5432 (PostgreSQL),
    • <cp-host> (HTTPS для API/Console).

Базовые шаги (типовой план)

  1. Подготовьте namespace, imagePullSecrets и StorageClass (SSD).
  2. Создайте secrets:
    • доступ к S3 (ключ/секрет/endpoint/bucket),
    • секреты CP (ключ для шифрования tenant password, seed для PKI и т. п.).
  3. Сформируйте config.yaml (network addresses, ports, endpoints) и смонтируйте его в сервисы.
  4. Разверните Helm chart (control-plane, gateway, pageserver, safekeeper, provisioner, console).
  5. Настройте мониторинг (Prometheus/Loki) и алерты.

HA и отказоустойчивость (в общих чертах)

  • Safekeeper обычно запускается в 3 экземплярах (кворум).
  • Pageserver хранит слои в S3 и может быть восстановлен при потере ноды.
  • Compute статeless и может быть пересоздан без потери данных.

Если вам нужны строгие RPO/RTO, уточните целевую топологию и параметры у команды платформы.