Руководства

Практические end-to-end туториалы: пройти путь целиком — от пустого кластера до работающего сервиса на душах — и попутно увидеть, как устроены ключевые операции Soul Stack.

В отличие от Quick Start (один хост, минимальный demo за пять минут) и справочных разделов DSL / Модули / Конфигурация, руководства показывают связные сценарии работы: что делать по шагам, в каком порядке и почему именно так.

С чего начать

Если вы только что прошли Quick Start — продолжайте отсюда. Если кластер ещё не поднят, сначала пройдите Установку и Quick Start.

Онбординг душПодключить сразу несколько хостов: регистрация, bootstrap-токены, soul init, soul run, проверка connected. Covens для последующего таргетинга.

Первый сервис на душахПолный проход: зарегистрировать сервис (git + ref), создать incarnation на coven, увидеть applied на нескольких хостах и проверить результат.

Оркестрация сценариемУправление порядком раскатки: rolling (serial:), run_once:, таргетинг по стабильным фактам (where:), probe живой роли и rolling-рестарт по onchanges:.

Мониторинг из коробкиМетрики через Prometheus scrape (:9090, pull) и трейсы через OpenTelemetry push; на что смотреть; пример Destiny, ставящего экспортер на хосты.

Порядок прохождения

Рекомендованная последовательность:

1. Онбординг душ — без подключённых хостов применять нечего.
2. Первый сервис на душах — раскатать состояние на эти хосты.
3. Оркестрация сценарием — управлять тем, как именно состояние раскатывается по душам.
4. Мониторинг из коробки — наблюдать за кластером и хостами в эксплуатации.

Каждое руководство самодостаточно и ссылается на нужные справочные разделы — читать строго по порядку не обязательно.

Что дальше

• Концепции — словарь и ментальная модель: Keeper, Souls, Destiny, Soulprint, Essence, Coven.
• DSL — нормативная грамматика Destiny / Scenario / Essence.
• Эксплуатация — масштабирование, обновления, бэкап, troubleshooting.