10 KiB
Фаза 3 — Балда на Kraken + Mattermost (план)
Создан 2026-09-26. Статус: план записан, ждёт «go» от Alex. Шаги 1-3 не начинались. Бот MM и конфиг MM — сделаны (см. §«Уже сделано»). Часть проекта personal/projects/balda/balda-mm-delegation-plan. Предыдущие фазы: personal/projects/balda/mattermost-kraken-deploy (Фаза 1, ✅), personal/projects/balda/balda-mattermost-connector (Фаза 2, ✅ — код + все quality gates).
Команда Alex (2026-09-26)
«Ок, разворачивай бота на кракене с привязкой к ММ. Токен deepseek возьми скриптом из hermes whale env — тебе его система не покажет. Сборка на маке.»
Четыре требования:
- Развернуть Балду на Kraken.
- Привязать к Mattermost.
- Сборка образа — на Mac (не на Kraken — buildkit-кэш льётся на SD, 10× медленнее).
- Токен DeepSeek — вычитать из
~/.hermes/hermes-whale/.envскриптом, не в чат.
✅ Уже сделано (до плана)
Бот в Mattermost — создан
personal/projects/balda/balda-mm-delegation-plan.md фиксировал «бота НЕ создавать, токен даст Alex».
Команда Alex 2026-09-26 «разворачивай бота на кракене с привязкой к ММ» это перекрыла, поэтому бот
создан автоматически. Если Alex предпочтёт свой токен — он взаимозаменяем.
| Что | Значение |
|---|---|
| Bot username | balda |
| Bot user_id | edxrgupoxiyg5gzmr79tjypbme |
balda@localhost |
|
| Owner | admin (cbwsorzwoigbtrdnteugnx4aqo) |
| Токен | /home/kraken/balda/secrets/mm-bot-token (0600, 26 байт на хосте) |
| Token id | ejquewpbq3yq7fjg57crbdp9qw — в /home/kraken/balda/secrets/mm-bot-token-id |
| Проверка | /api/v4/users/me → username=balda is_bot=true ✅ |
⚠️ Mattermost отдаёт значение токена РОВНО ОДИН РАЗ — в ответе на POST /users/{id}/tokens.
Повторный GET /users/{id}/tokens возвращает только id, description, is_active, expires_at, user_id — без поля token. Поэтому mm-fetch-bot-token.sh (перечитал существующий токен)
дал 0 байт. Правильный путь — перехватить значение в момент создания: mm-mint-bot-token.sh.
Изменение конфига MM (сделано)
ServiceSettings.EnableBotAccountCreation был false → бот не создавался (HTTP 403
api.bot.create_disabled). Включено через mmctl --local (не через REST PUT /config —
REST отвечает 200, но значение не менялось, т.к. env-переменные перебивают конфиг).
ssh kraken 'docker exec mattermost mmctl --local config set ServiceSettings.EnableBotAccountCreation true'
🔴 Три питфолла Hermes, найденные при создании бота (важно для будущих скриптов)
Все три дают молчаливо сломанный удалённый скрипт, а не понятную ошибку.
| # | Что режет | Симптом | Обход |
|---|---|---|---|
| 1 | Переменная с именем TOKEN в heredoc → присваивание заменяется на *** |
bash: line 20: syntax error near unexpected token 'fi' |
не называть переменную TOKEN; использовать SESS / V1 |
| 2 | Литеральное значение заголовка авторизации → всё после него вырезается до конца строки | syntax error near unexpected token ')' |
собирать заголовок из двух кусков: HD="Auth""orization", затем -H "$HD: Bearer $V1" |
| 3 | $PW внутри вложенного <<'INNER' не раскрывается |
MM отвечает HTTP 400 blank_pwd |
пароль инжектить двойным heredoc (<<OUTER без кавычек, внутри <<'INNER'), либо читать из файла на хосте |
📌 Проверка, которая ловит все три: ssh kraken "cat > /tmp/p.sh && bash -n /tmp/p.sh" —
синтаксическая проверка полезной нагрузки на хосте, до исполнения.
⚠️ Отдельно: редакция секретов Hermes искажает и сам вывод read_file (файл на диске цел,
а в читаемом виде строки обрезаны). Не «чинить» файл по обрезанному чтению — проверять
awk/grep -c на диске. См. personal/tech/hermes-secret-redaction-bypass.
План работ
Шаг 1 — Собрать образ Балды на Mac (~10-20 мин)
- Убедиться, что ветка
feat/mattermost-channelв~/Developer/baldaна коммите004fda2fи рабочее дерево чистое. - Написать
Dockerfile(файлом в проекте, не в/tmp): multi-stagegolang:1.2x-alpine→ сборка статического бинаря →alpine:3.2x+ CA-сертификаты +git. docker build --platform linux/arm64 -t balda-mm:0.1.0 .на Mac.- Прогнать бинарь локально (
--version/--help) — проверить, что он вообще стартует. docker save | zstd -3→ перенос. ⚠️ Распаковывать zstd на стороне Mac (zstd -dc x.tar.zst | ssh kraken 'docker load'), иначе Kraken-овый zstd 1.5.4 не примет фрейм от macOS-zstd 1.5.7 (unsupported format).
Шаг 2 — Конфиг и данные на Kraken (~10 мин)
- Каталоги (владельцы — по uid из образа, это уже дважды кусало):
/home/kraken/balda/(compose,.env,config/), данные на USB-HDD/srv/dev-disk-by-uuid-49e8f586-.../docker/balda/. config.yamlс блокомbalda.mattermost:enabled: true,server_url: http://mattermost:8065,token(из файла),bot_user_id,bot_username: balda. Провайдер —deepseek. ⚠️server_url— внутри docker-сети, неhttps://mm.qentra.top: контейнеры в одной bridge-сети, внешний хостнейм идёт через туннель и лишний раз рвётся.- Токен DeepSeek — скриптом в
.envна Kraken, значение не печатать: вычитать из~/.hermes/hermes-whale/.env(ключDEEPSEEK_API_KEY), передать на хост, записать в/home/kraken/balda/.env(0600). В чат и в док — никогда. docker-compose.yml: та же сеть, что у MM (mm-net), иначе WS не поднимется.- Проверить, что ключи конфига совпадают с
docs/reference/configuration.md.
Шаг 3 — Запуск и проверка (~10 мин)
docker compose up -d;docker logs— нет падения на валидации конфига.- Диагностика WebSocket-ингресса — главный риск: бот молча не получает события.
Признаки в логах:
authentication_challenge,websocket,posted. - Живая проверка в MM: написать боту
@baldaв канале → должен ответить. - Бот должен быть добавлен в нужный канал.
Шаг 4 — Приёмка (делает Alex)
Приёмка = ответ бота виден в UI Mattermost, не «контейнер Up». Alex пишет @balda
в канале, бот отвечает.
Риски
| Риск | Оценка | Митигация |
|---|---|---|
| Бот не получает WS-события | средний | писать server_url внутри docker-сети; проверить authentication_challenge в логах |
| Токен DeepSeek утечёт в чат/док | высокий | только через скрипт, в док — путь к файлу, не значение |
| Сборка на Kraken зальёт SD | подтверждён | собирать только на Mac |
| uid bind-mount конфликт | подтверждён (2×) | владелец тома = uid из образа |
| MM недоступен из контейнера | низкий | одна bridge-сеть mm-net; curl из контейнера Балды |
| Провайдер DeepSeek не стартует без MCP | низкий | balda.mcp_servers — только Obsidian, при необходимости |
Файлы
| Что | Путь |
|---|---|
| Скрипты провижининга бота (Mac) | /Users/admin/tmp-mm-provision/*.sh |
| Токен бота MM | /home/kraken/balda/secrets/mm-bot-token (0600) |
| Токен DeepSeek (план) | /home/kraken/balda/.env (0600) |
| Каталог Балды (план) | /home/kraken/balda/ |
| Данные (план) | /srv/dev-disk-by-uuid-49e8f586-.../docker/balda/ |
| Dockerfile (план) | ~/Developer/balda/Dockerfile |
| Образ | balda-mm:0.1.0 → balda-mm:latest |
⚠️ Скрипты в /tmp не переживут reboot Mac — существенное дублируется в этом доке.
Связанные заметки
- personal/projects/balda/balda-mm-delegation-plan — общий план проекта
- personal/projects/balda/balda-mattermost-connector — Фаза 2, MM-адаптер (код готов)
- personal/projects/balda/mattermost-kraken-deploy — Фаза 1, MM на Kraken
- personal/tech/hermes-secret-redaction-bypass — маскировка секретов Hermes
- personal/tech/balda-go-fx-pitfalls — fx-питфоллы