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

157 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Фаза 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-питфоллы