Skip to content

Архитектура Starry ​

Starry спроектирован как децентрализованный, бессерверный (masterless) GitOps-оркестратор для управления разнородным парком виртуальных машин (VPS), облачных инстансов и физических серверов.


1. Концептуальная диаграмма ​

text
               +--------------------------------------------------+
               |             GitOps Репозиторий                   |
               |     (starry.yaml + ENC[...] зашифрованные данные)|
               +--------------------------------------------------+
                                        │
                       ┌────────────────┴────────────────┐
                       ▼                                 ▼
             +───────────────────+             +───────────────────+
             |   Developer CLI   |             |   CI/CD Runner    |
             |   (starry apply)  |             |  (GitHub Actions) |
             +───────────────────+             +───────────────────+
                       │                                 │
                       └────────────────┬────────────────┘
                                        │ SSH / WireGuard
                                        ▼
    ┌───────────────────────────────────┬───────────────────────────────────┐
    │  Node A (Ubuntu 24.04 / Docker)   │  Node B (AlmaLinux 9 / Podman)   │
    │                                   │                                   │
    │  +-----------------------------+  │  +-----------------------------+  │
    │  |     Starry Host Agent       |  │  |     Starry Host Agent       |  │
    │  |  (Healthcheck / Telemetry)  |  │  |  (Healthcheck / Telemetry)  |  │
    │  +-----------------------------+  │  +-----------------------------+  │
    │  |      nftables Firewall      |  │  |      nftables Firewall      |  │
    │  | (ports open to wg0 mesh)    |  │  | (ports open to wg0 mesh)    |  │
    │  +-----------------------------+  │  +-----------------------------+  │
    │  |   WireGuard Mesh (10.42.0.1)│◄─┼─►│   WireGuard Mesh (10.42.0.2)│  │
    │  +-----------------------------+  │  +-----------------------------+  │
    │  |      Docker Engine API      |  │  |    Podman Libpod API (Root) |  │
    │  |   [App: Web, Nginx, DB]     |  │  |   [App: Worker, Cache]      |  │
    │  +-----------------------------+  │  +-----------------------------+  │
    └───────────────────────────────────┴───────────────────────────────────┘

2. Модель Single-Binary Hybrid ​

Starry скомпилирован в единый самодостаточный Native AOT бинарник размером менее 30 МБ, работающий без установки дополнительных сред выполнения.

Бинарник работает в двух режимах:

  1. Режим CLI (starry <command>):

    • Запускается на рабочей станции инженера или в CI/CD раннере.
    • Считывает starry.yaml, расшифровывает секреты с помощью STARRY_MASTER_KEY.
    • Опрашивает ноды по SSH, строит граф зависимостей (DAG) и вычисляет разницу состояний (Diff).
    • Оркестрирует параллельное применение изменений без необходимости постоянного управляющего сервера (Master).
  2. Режим Agent (starry agent run):

    • Запускается на серверах парка в виде легковесного системного сервиса systemd.
    • Обеспечивает автономный надзор над локальными контейнерами и перезапуск при сбоях.
    • Применяет атомарные правила nftables и следит за состоянием интерфейса WireGuard.
    • Выполняет периодические локальные Healthcheck-проверки и отправляет телеметрию.

3. Оверлейная сеть WireGuard Full-Mesh ​

Все серверные узлы объединяются в защищённую приватную сеть диапазона 10.42.0.0/16.

  • Автоматическая маршрутизация: Каждый узел получает собственный статичный IP-адрес внутри меша (например, 10.42.0.1, 10.42.0.2). Конфигурация пиров WireGuard генерируется автоматически на основе списка нод.
  • Преодоление NAT (NAT Traversal): Для серверов, расположенных за NAT или межсетевыми экранами облачных провайдеров, Starry настраивает PersistentKeepalive = 25 и динамическое определение эндпоинтов.
  • Безопасность трафика по умолчанию: Межсервисный трафик между нодами (например, обращение бэкенда к базе данных) шифруется протоколом Noise / ChaCha20-Poly1305 на уровне ядра Linux.

4. Контейнерные движки: Docker и Podman ​

Starry абстрагирует различия между контейнерными средами через единый программный интерфейс:

ХарактеристикаDocker EnginePodman (Libpod)
API Сокет/var/run/docker.sock/run/podman/podman.sock
Rootless режимЭкспериментальныйНативный из коробки
Поддерживаемые ОСUbuntu, Debian, AlpineRHEL, AlmaLinux, Rocky, Fedora, Arch
УправлениеДемон dockerdБездемоновый (fork/exec через conmon/crun)

P2P-стриминг образов (Image Mesh) ​

При миграции контейнера или масштабировании сервиса на новую ноду в условиях недоступности внешнего Docker Hub / Registry, Starry умеет стримить образ контейнера напрямую между нодами по протоколу WireGuard через сжатый поток zstd, минуя внешние сети.


5. Атомарный файрвол nftables и Deadman Switch ​

Безопасность сетевого периметра обеспечивается подсистемой nftables:

  1. Изоляция портов: Порты контейнеров (кроме публичных HTTP/HTTPS точек входа) открываются строго на интерфейсе wg0. Из внешней сети эти порты не видны и не сканируются.
  2. Атомарность правил: Конфигурация транслируется в нативный синтаксис nftables и загружается атомарно через команду nft -f.
  3. Deadman Switch Rollback: Если при обновлении правил файрвола на удалённом сервере произойдёт синтаксическая ошибка или обрыв SSH-сессии управления, таймер безопасности автоматически восстановит предыдущую валидную конфигурацию, исключая риск потери доступа к серверу.

6. Управление секретами и криптография ​

Starry придерживается концепции безопасного хранения зашифрованных данных непосредственно в репозитории:

  • Конвертное шифрование AES-256-GCM: Для каждого секрета генерируется уникальный криптографический вектор инициализации (IV, 96 бит) и аутентификационный тег (128 бит), предотвращающий подделку шифротекста.
  • Синтаксис маркеров:
    text
    ENC[AES256_GCM,data:4gY3...,iv:9kP2...,tag:z0X8...]
  • Ротация мастер-ключа в один клик: Команда starry rotate-secrets расшифровывает все значения старым ключом, генерирует новый ключ, перешифровывает весь файл starry.yaml и синхронизирует секрет в GitHub Actions через REST API LibSodium.
  • Ротация SSH и WireGuard ключей: Команда starry rotate-keys выполняет бесшовную замену приватных и публичных ключей нод с верификацией связности перед удалением устаревших ключей.

7. Декларативное сопровождение ОС и Rolling Drain ​

Starry управляет не только контейнерами, но и базовой операционной системой серверов:

  • Поддержка пакетных менеджеров: Автоматическое определение дистрибутива через /etc/os-release и работа с apt-get, dnf, apk, pacman.
  • Детекция обновлений ядра: Распознавание признаков требуемой перезагрузки (/var/run/reboot-required на Debian/Ubuntu, needs-restarting -r на RHEL/AlmaLinux).
  • Алгоритм Rolling Drain (перезагрузка без простоя):
    1. Временный вывод ноды из балансировки или переключение DNS.
    2. Корректная остановка сервисов (Graceful stop).
    3. Перезагрузка сервера (reboot).
    4. Ожидание возвращения SSH и запуск агента Starry.
    5. Проверка состояния сервисов и возврат рабочего трафика на узел.

Released under the MIT License.