157 lines
10 KiB
Markdown
157 lines
10 KiB
Markdown
# Фаза 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-питфоллы
|