Архитектура и синтаксис конфигурации (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 заменяет ссылку на глубокую копию целевого поддерева:
presets:
db_env:
POSTGRES_DB: "starry"
POSTGRES_USER: "admin"
POSTGRES_PASSWORD: "ENC[AES256_GCM:v1:...]"
services:
database:
image: "postgres:16"
env: "$presets.db_env"Наследование и слияние объектов ($:)
Через специальный ключ "$" сервис или узел может наследовать свойства одного или нескольких базовых пресетов:
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. В интерфейсе WireGuardstarry0адрес равен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: задает именованные правила маршрутизации:
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
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 для прозрачного проксирования на нужный порт!