Skip to content

Двойной движок: Docker и Podman (Rootless), Конфиги (files) и Приоритеты ​

Starry из коробки поддерживает работу с двумя главными контейнерными средами Linux — Docker Engine и Podman (как в rootful, так и в полностью непривилегированном rootless режиме).

Общение с демонами происходит напрямую через Unix Domain Socket (SocketsHttpHandler) с нулевым оверхедом и без тяжелых сторонних SDK.


1. Сравнение движков: Docker vs Podman ​

ХарактеристикаDocker EnginePodman (Rootful / Rootless)
АрхитектураКлиент-серверный демон dockerdDaemonless, сокет активируется через systemd.socket
Путь к сокету/var/run/docker.sock/run/podman/podman.sock (rootful)
/run/user/$UID/podman/podman.sock (rootless)
ПривилегииТребует права root / группу dockerПолная поддержка Rootless в пространстве пользователя
P2P стримингdocker save | zstd | ssh docker loadpodman save | zstd | ssh podman load

Starry автоматически определяет доступный сокет на ноде и адаптирует параметры монтирования и сетевого режима.


2. Динамическая шаблонизация конфигов (files) и SIGHUP-перезагрузка ​

Часто сервисам требуются конфигурационные файлы (например, nginx.conf, prometheus.yml, settings.toml), которые меняются чаще, чем сами образы.

В манифесте сервиса Starry поддерживает секцию files:

yaml
services:
  web:
    image: "nginx:alpine"
    node: "bocchi"
    priority: 80
    files:
      /etc/nginx/conf.d/default.conf: |
        server {
            listen 80;
            server_name _;
            location / {
                proxy_pass http://api.internal:8080;
            }
        }

Механизм горячего обновления: ​

  1. Starry вычисляет хеш SHA-256 для каждого монтируемого файла.
  2. Файлы сохраняются на хосте в /var/lib/starry/files/<service>/... и монтируются в контейнер в режиме ro (read-only).
  3. При изменении содержимого файла Starry атомарно обновляет файл на хосте.
  4. Если контейнер уже запущен, Starry отправляет сигнал SIGHUP (POST /containers/{id}/kill?signal=SIGHUP), и процесс (например, Nginx) перечитывает конфигурацию без перезапуска контейнера и без простоя соединений!

3. Приоритизация запуска (priority: int) ​

Для предотвращения сбоев при старте зависимых сервисов (например, когда бэкенд падает из-за недоступности базы данных), каждый сервис наделяется числовым приоритетом от 0 до 100:

ПриоритетКатегорияПримеры
0 – 9Системные реестрыПриватный Docker Registry
10 – 29СУБД и кэшиPostgreSQL, Redis, ClickHouse, RabbitMQ
30 – 69Внутренние бэкендыAPI-серверы, воркеры, микросервисы
70 – 100Внешние прокси и IngressNginx, Caddy, Traefik, Envoy

Starry сортирует сервисы по возрастанию priority и запускает их ярусами: базы данных гарантированно готовы к моменту старта бэкендов!

Released under the MIT License.