[2026-09-26] eagle: personal/projects/balda/balda-kraken-mm-deploy.md personal/projects/balda/balda-mm-delegation-plan.md personal/projects/balda/mattermost-kraken-deploy.md personal/tech/hermes-secret-redaction-bypass.md

This commit is contained in:
Alexey Martemyanov committed 2026-09-26 11:34:53 +06:00
1 parent e7091dd819
commit eab4ef5dc9
4 files changed
+348 -4

No files matched your search

@@ -0,0 +1,156 @@
# Фаза 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-переменные перебивают конфиг).
```bash
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** — существенное дублируется в этом доке.
## Связанные заметки
- [[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-питфоллы