Files
obsidian-vault/personal/projects/balda/balda-kraken-mm-deploy.md
T

10 KiB
Raw Blame History

Фаза 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 — тебе его система не покажет. Сборка на маке.»

Четыре требования:

  1. Развернуть Балду на Kraken.
  2. Привязать к Mattermost.
  3. Сборка образа — на Mac (не на Kraken — buildkit-кэш льётся на SD, 10× медленнее).
  4. Токен 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
Email 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 мин)

  1. Убедиться, что ветка feat/mattermost-channel в ~/Developer/balda на коммите 004fda2f и рабочее дерево чистое.
  2. Написать Dockerfile (файлом в проекте, не в /tmp): multi-stage golang:1.2x-alpine → сборка статического бинаря → alpine:3.2x + CA-сертификаты + git.
  3. docker build --platform linux/arm64 -t balda-mm:0.1.0 . на Mac.
  4. Прогнать бинарь локально (--version / --help) — проверить, что он вообще стартует.
  5. 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 мин)

  1. Каталоги (владельцы — по uid из образа, это уже дважды кусало): /home/kraken/balda/ (compose, .env, config/), данные на USB-HDD /srv/dev-disk-by-uuid-49e8f586-.../docker/balda/.
  2. 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-сети, внешний хостнейм идёт через туннель и лишний раз рвётся.
  3. Токен DeepSeek — скриптом в .env на Kraken, значение не печатать: вычитать из ~/.hermes/hermes-whale/.env (ключ DEEPSEEK_API_KEY), передать на хост, записать в /home/kraken/balda/.env (0600). В чат и в док — никогда.
  4. docker-compose.yml: та же сеть, что у MM (mm-net), иначе WS не поднимется.
  5. Проверить, что ключи конфига совпадают с docs/reference/configuration.md.

Шаг 3 — Запуск и проверка (~10 мин)

  1. docker compose up -d; docker logs — нет падения на валидации конфига.
  2. Диагностика WebSocket-ингресса — главный риск: бот молча не получает события. Признаки в логах: authentication_challenge, websocket, posted.
  3. Живая проверка в MM: написать боту @balda в канале → должен ответить.
  4. Бот должен быть добавлен в нужный канал.

Шаг 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 — существенное дублируется в этом доке.

Связанные заметки