diff --git a/AGENTS.md b/AGENTS.md index c425d89..8de5e2a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -281,6 +281,27 @@ Cron-скрипты (бэкапы) должны пушить в Uptime Kuma по - Проверять длину, а не значение: `echo "length: ${#VAR}"`. - Если нужно передать — через файл с chmod 600. +### Инфраструктура под Git (с 28.10.2026) + +- Все 26 CT с Docker описаны в `deploy/ctNNN/docker-compose.yml`. Секреты — + в `.env` рядом (chmod 600), в Git только `env.example`. +- Compose-файлы генеративные: `ops/scripts/docker-to-compose.py NNN --write --force --env-out`. + Руками править можно, но следующая генерация перезапишет — правьте генератор. +- **Перед удалением контейнеров** обязательна сверка: + `python3 ops/scripts/check-compose-parity.py NNN` → должно быть 0 расхождений. + Проверяет image, entrypoint, command, ключи env, монтирования, порты. +- **Проверять плагин**: `pct exec NNN -- docker compose version`. Без него + `up -d` молча не выполнится, а контейнеры уже удалены. Если плагина нет: + `docker-compose-linux-x86_64` в `/usr/local/lib/docker/cli-plugins/` + (в CT113 нужен v2.24.7: dockerd там 20.10, API 1.41). +- Удалять контейнеры по одному (`docker rm -f NAME` в цикле): команда с + несколькими именами прерывается на первом отсутствующем. +- Снапшот невозможен на 12 CT с bind-монтированиями (103, 105, 109, 111, 117, + 118, 120, 123, 125, 126, 155, 160): `pct snapshot` вернёт «snapshot feature + is not available». Вместо него — `cp /etc/pve/lxc/NNN.conf`, при серьёзных + работах `vzdump`. +- Реестр автоматизаций генерируется: `ops/scripts/build-automations-registry.py`. + ### Инструменты диагностики # Matrix БД (в контейнере нет sqlite3, использовать python3)