Установка

Soul Stack поставляется четырьмя исполняемыми файлами: keeper (центральный сервер), soul (агент на хосте), soulctl (клиентский CLI оператора) и soul-lint (офлайн-линтер). Способ установки выбирается под вашу инфраструктуру.

Внешняя инфраструктура — на вас

Пакеты и релизы несут только исполняемые файлы, systemd-юниты и примеры конфигов. PostgreSQL, Redis и Vault Soul Stack не поставляет в комплекте — это внешние компоненты, которые вы поднимаете и эксплуатируете сами.

• PostgreSQL — единственное холодное хранилище Keeper-кластера: реестры агентов и операторов, каталог сервисов, журналы.
• Redis — heartbeat-кэш, lease на идентификаторы агентов, координация между инстансами Keeper.
• Vault — PKI для выпуска mTLS-идентичности агентов и хранение секретов (DSN PostgreSQL, пароль Redis, ключ подписи операторских токенов).

Обязательный контур — PostgreSQL + Redis + Vault (все три; Keeper проверяет каждый на старте и не стартует без любого из них). Все три должны быть доступны по сети с хоста, где работает Keeper. Требования к версиям, обязательные параметры и режимы каждого компонента — Подготовка инфраструктуры; demo-сценарий поднятия — Quick Start → Что понадобится.

Какой способ выбрать

deb / rpm

Основной прод-способ. Готовые пакеты для Debian/Ubuntu и RHEL-семейства. Кладут исполняемый файл, systemd-юнит, env-файл и пример конфига; при обновлении не перетирают рабочий конфиг.

Когда: продакшен-инсталляция на Linux-хостах с пакетным менеджером, управление через systemd.

Подробно — Из deb/rpm-пакетов.

Бинарные релизы

Готовый статический исполняемый файл без пакетного менеджера. systemd-юнит, пользователь и каталоги — вручную.

Когда: контейнеры, immutable-образы, дистрибутивы без deb/rpm, ручной контроль над раскладкой.

Подробно — Из бинарных релизов.

Из исходников

Сборка из Go-исходников через go.work + make build.

Когда: разработка, контрибьюция, кастомные сборки, платформы без готовых артефактов.

Подробно — Из исходников.

Что несёт каждый артефакт

Исполняемый файл	Где живёт	Как ставится
keeper	центральный узел (1+ инстанс)	пакет soul-stack-keeper / релиз / сборка
soul	каждый управляемый хост	пакет soul-stack-soul / релиз / сборка
soul-lint	рабочая станция оператора, CI	пакет soul-stack-soul-lint / релиз / сборка
soulctl	рабочая станция оператора	релиз / сборка (отдельным deb/rpm-пакетом не поставляется)

Пакеты soul-stack-keeper и soul-stack-soul несут демон + systemd-юнит + env-файл + пример конфига. soul-stack-soul-lint — только CLI без демона и конфига. soulctl — клиентский инструмент оператора, ставится из релизного исполняемого файла или сборкой.