Skip to content

Архитектура и синтаксис конфигурации (Starry v3.0) ​

В версии Starry v3.0 конфигурационный движок построен на базе чистой функциональной библиотеки Starry.Dsl (F#). Инфраструктура описывается как единый граф с поддержкой подстановки поддеревьев, наследования объектов через $: и интерполяции переменных и секретов.


1. Унифицированный граф AST и организация файлов ​

Любая папка и файл внутри директории конфигурации автоматически становятся узлом в едином иммутабельном AST:

  • Структурированные файлы (.yaml, .json, .toml): Парсятся и монтируются в соответствующую ветку графа (например, nodes/germany.yaml -> root.nodes.germany).
  • Текстовые и конфигурационные файлы (files/*): Любой текстовый файл (например, files/nginx.conf или files/init.sql) загружается в граф как StringNode под своим путем (root.files.["nginx.conf"]).
  • Произвольные пользовательские ветки: Вы можете создавать любые удобные секции (presets, secrets, vars, dns_providers, backups, certs) — валидатор не блокирует произвольные структуры.

2. Разрешение ссылок ($) и наследование ($:) ​

Подстановка целых поддеревьев ​

Если значение узла указывает на путь к объекту (например, env: "$presets.db_env"), Starry заменяет ссылку на глубокую копию целевого поддерева:

yaml
presets:
  db_env:
    POSTGRES_DB: "starry"
    POSTGRES_USER: "admin"
    POSTGRES_PASSWORD: "ENC[AES256_GCM:v1:...]"

services:
  database:
    image: "postgres:16"
    env: "$presets.db_env"

Наследование и слияние объектов ($:) ​

Через специальный ключ "$" сервис или узел может наследовать свойства одного или нескольких базовых пресетов:

yaml
presets:
  base_service:
    restart: "always"
    priority: 50
    networks: ["$networks.app_net"]

services:
  web:
    $: "$presets.base_service"
    image: "nginx:alpine"
    priority: 80 # Переопределяет priority из base_service

Интерполяция строк и файлов ​

Внутри любых строк (включая переменные окружения и текст файлов в files/) поддерживается синтаксис $path.to.value и ${path.to.value}. При развертывании секреты автоматически расшифровываются.


3. Схема адресации IPv6 Mesh (fd67:b00b::/32) и реестр ID ​

  • Префикс кластера: fd67:b00b::/32.
  • Подсеть узла (/48): Каждому серверу выделяется статическая подсеть fd67:b00b:<host_id>::/48. В интерфейсе WireGuard starry0 адрес равен fd67:b00b:<host_id>::1/32, а в пирах прописывается AllowedIPs = fd67:b00b:<host_id>::/48.
  • Подсеть контейнера (/64): Каждой реплике контейнера выделяется подсеть fd67:b00b:<host_id>:<container_id>::/64. Внутри контейнера работает ровно один сетевой интерфейс (eth0) с адресом fd67:b00b:<host_id>:<container_id>::1/64.
  • Реестр ID (.starry/id-ledger.json): При удалении сервиса или сервера их идентификаторы попадают в список tombstoned и никогда не переиспользуются повторно.

4. Именованные двунаправленные порты (ports:) ​

Секция ports: задает именованные правила маршрутизации:

yaml
ports:
  shop_https_v4:
    from: "$nodes.germany.ipv4:443"
    to: "$ingress:443"
    proto: "tcp"
    bidirectional: true # Входящий DNAT + исходящий SNAT через IP ноды germany!

  custom_proxy:
    from: "$nodes.finland.ipv4:443"
    to: "my-proxy:443"

5. Встроенный Nginx Ingress ($ingress) и L4 SNI Proxy ​

  • $ingress получает внутренний адрес fd67:b00b:<host_id>:ffff::1 и не захватывает порт 443 на сервере без явного правила в ports:.
  • Входящий трафик обрабатывается через stream { ssl_preread on; }:
    • Маршруты sni: "<target>" пробрасываются на Layer 4 без расшифровки TLS.
    • Маршруты http: "<target>" направляются в блок http {} для терминации SSL и проксирования HTTP/WebSocket/gRPC.

6. Иерархические домены (domains:) и Cloudflare Origin Rules ​

yaml
domains:
  rocks:
    bocchi:
      dns_provider: "$dns_providers.cf"
      cert: "$certs.bocchi_wildcard"
      node: "$nodes.germany"

      "@":
        http: "landing:80"
      shop:
        http: "shop-web:3000"
      vpn:
        sni: "xray:8443"
        proxy_protocol: true

Если порт входа в правиле ports: отличается от 443 (например, 8443), провайдер Cloudflare автоматически создает Origin Rule через Cloudflare Rulesets API для прозрачного проксирования на нужный порт!

Released under the MIT License.