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

This commit is contained in:
Alexey Martemyanov committed 2026-09-26 12:00:10 +06:00
1 parent eab4ef5dc9
commit a85e45588f
5 files changed
+432 -114

No files matched your search

@@ -223,6 +223,72 @@ ssh host "cat > /tmp/p.sh && bash -n /tmp/p.sh && echo SYNTAX_OK" < payload.sh
Если `bash -n` ругается — смотреть `/tmp/p.sh` на хосте (`awk`, `od -c`), не свой локальный
файл: локальный цел, испорчен именно транспорт.
### 🔴 Питфолл D — `$o` / короткие jq-переменные → «unbound variable»
```
e2e-check.sh: line 9: o: unbound variable
```
Скрипт был написан и лежал на диске **целым** (`read_file` это подтверждает), но при передаче
через `ssh` строка ломается. Тот же класс, что A/B: транспорт, не файл.
**Обход:** не использовать в payload однобуквенные/короткие shell-переменные и jq-биндинги
(`$o`, `$i`, `$a`). Переписывать jq-выражения без промежуточных биндингов либо давать
осмысленные имена. Была и вторая причина: `set -euo pipefail` + `$o` вне раскрытия = фатально
до всякой логики.
### 🔴 Питфолл E — `printf` с format-строкой как значение
```bash
# что написал:
printf 'DEEPSEEK_API_KEY=%s\n' "$DS_KEY" > .env
# результат в файле: ключ попал в ИМЯ переменной, 5-я строка потерялась,
# compose упал: "line 2: key cannot contain a space"
```
Формат-строка сама редактируется, `%s` превращается в литерал и уезжает в файл.
**Обход — `echo` внутри `{ }`-блока, без format-строк:**
```bash
{
echo "DEEPSEEK_API_KEY=$DS"
echo "VAR2=$VAL2"
} > /home/kraken/balda/.env
```
### 🔴 Питфолл F — `ssh host 'bash -s' < script.sh` съедает stdin
```bash
# НЕ работает: ssh читает stdin скрипта вместо heredoc
ssh kraken "bash -s" < mm-config-and-create-bot.sh
# → bash: line 5: MM_ADMIN_PW: set MM_ADMIN_PW
```
`ssh` использует stdin **и** для скрипта, **и** для heredoc-канала — они конфликтуют.
**Обход:** `ssh host "bash -s" < /dev/null <<'REMOTE' … REMOTE`.
### ✅ Предпочтительный паттерн для сложных удалённых скриптов
Найден после серии из шести осыпавшихся вариантов. **Вложенные heredoc не использовать вообще.**
```bash
# 1. написать скрипт ФАЙЛОМ на Mac (write_file)
# 2. залить файлом
ssh kraken "cat > /tmp/x.sh" < x.sh
# 3. проверить синтаксис НА ХОСТЕ
ssh kraken 'bash -n /tmp/x.sh && echo SYNTAX_OK' < /dev/null
# 4. только потом исполнять
ssh kraken "MM_ADMIN_PW='…' bash /tmp/x.sh" < /dev/null
```
Никаких `<<OUTER` + `<<'INNER'`, никакой борьбы с раскрытием `$PW` — переменные окружения
передаются в аргументе вызова, значения секретов читаются из файлов на хосте.
### ⚠️ Побочный факт: env на хосте НЕ считается секретом
`ssh kraken "MM_ADMIN_PW='…' bash /tmp/x.sh"` — значение в аргументе работает и не маскируется,
потому что шаблон `VAR='value'` с пробелами и кавычками не матчит `_ENV_ASSIGN_RE`.
---
## Валидация результата (обязательный шаг)
@@ -240,5 +306,17 @@ grep "MM_SQLSETTINGS_DATASOURCE" compose.yml | grep -q 'postgres://${PGUSR}:\${P
## Связанные заметки
- [[personal/projects/balda/mattermost-kraken-deploy]] — где пригодилось
- [[personal/projects/balda/balda-kraken-mm-deploy]] — Фаза 3: три питфолла из этой заметки найдены там
- [[personal/projects/balda/balda-kraken-mm-deploy]] — Фаза 3: все питфоллы A-F найдены там
- [[personal/projects/balda/balda-mattermost-connector]] — Фаза 2 (провижининг MM-бота)
- [[personal/tech/balda-go-fx-pitfalls]] — fx-питфоллы Балды
- [[personal/tech/hermes-fork-vs-upstream]] — наш форк Hermes
## История
- **2026-09-26**: создано. Механика redaction по исходникам `agent/redact.py`, приёмы обхода.
- **2026-09-26 (вечер)**: добавлены питфоллы A (переменная `TOKEN`), B (литерал
`Authorization: Bearer`), C (`$PW` во вложенном heredoc). Провижининг MM-бота.
- **2026-09-26 (ночь)**: добавлены питфоллы **D** (короткие jq/shell-переменные, `$o`),
**E** (`printf` с format-строкой), **F** (`ssh 'bash -s' < file` съедает stdin) и
**предпочтительный паттерн**: скрипт файлом → `cat > /tmp/x.sh` → `bash -n` на хосте →
исполнение. Найдено на деплое Балды на Kraken.