From 66251e4a89179dd191bef6b17b9dfd01bf4eca06 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Wed, 28 Oct 2026 14:04:59 +0300 Subject: [PATCH] =?UTF-8?q?[DOCS]=20AGENTS.md:=20=D0=B8=D0=BD=D1=84=D1=80?= =?UTF-8?q?=D0=B0=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=82=D1=83=D1=80=D0=B0=20?= =?UTF-8?q?=D0=BF=D0=BE=D0=B4=20Git,=20=D1=81=D0=B2=D0=B5=D1=80=D0=BA?= =?UTF-8?q?=D0=B0=20=D0=BF=D0=B5=D1=80=D0=B5=D0=B4=20=D1=83=D0=B4=D0=B0?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=B8=D0=B5=D0=BC,=20=D0=BE=D0=B3=D1=80?= =?UTF-8?q?=D0=B0=D0=BD=D0=B8=D1=87=D0=B5=D0=BD=D0=B8=D1=8F=20=D1=81=D0=BD?= =?UTF-8?q?=D0=B0=D0=BF=D1=88=D0=BE=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) 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)