Архитектура Starry
Starry спроектирован как децентрализованный, бессерверный (masterless) GitOps-оркестратор для управления разнородным парком виртуальных машин (VPS), облачных инстансов и физических серверов.
1. Концептуальная диаграмма
+--------------------------------------------------+
| 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 МБ, работающий без установки дополнительных сред выполнения.
Бинарник работает в двух режимах:
Режим CLI (
starry <command>):- Запускается на рабочей станции инженера или в CI/CD раннере.
- Считывает
starry.yaml, расшифровывает секреты с помощьюSTARRY_MASTER_KEY. - Опрашивает ноды по SSH, строит граф зависимостей (DAG) и вычисляет разницу состояний (Diff).
- Оркестрирует параллельное применение изменений без необходимости постоянного управляющего сервера (Master).
Режим 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 Engine | Podman (Libpod) |
|---|---|---|
| API Сокет | /var/run/docker.sock | /run/podman/podman.sock |
| Rootless режим | Экспериментальный | Нативный из коробки |
| Поддерживаемые ОС | Ubuntu, Debian, Alpine | RHEL, AlmaLinux, Rocky, Fedora, Arch |
| Управление | Демон dockerd | Бездемоновый (fork/exec через conmon/crun) |
P2P-стриминг образов (Image Mesh)
При миграции контейнера или масштабировании сервиса на новую ноду в условиях недоступности внешнего Docker Hub / Registry, Starry умеет стримить образ контейнера напрямую между нодами по протоколу WireGuard через сжатый поток zstd, минуя внешние сети.
5. Атомарный файрвол nftables и Deadman Switch
Безопасность сетевого периметра обеспечивается подсистемой nftables:
- Изоляция портов: Порты контейнеров (кроме публичных HTTP/HTTPS точек входа) открываются строго на интерфейсе
wg0. Из внешней сети эти порты не видны и не сканируются. - Атомарность правил: Конфигурация транслируется в нативный синтаксис
nftablesи загружается атомарно через командуnft -f. - 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 (перезагрузка без простоя):
- Временный вывод ноды из балансировки или переключение DNS.
- Корректная остановка сервисов (Graceful stop).
- Перезагрузка сервера (
reboot). - Ожидание возвращения SSH и запуск агента Starry.
- Проверка состояния сервисов и возврат рабочего трафика на узел.