[DOCS] AGENTS.md: инфраструктура под Git, сверка перед удалением, ограничения снапшотов
lint / hygiene (push) Successful in 12s

This commit is contained in:
root committed 2026-10-28 14:04:59 +03:00
1 parent 8aa98b6163
commit 66251e4a89
1 file changed
+21
+21
View File
@@ -281,6 +281,27 @@ Cron-скрипты (бэкапы) должны пушить в Uptime Kuma по
- Проверять длину, а не значение: `echo "length: ${#VAR}"`. - Проверять длину, а не значение: `echo "length: ${#VAR}"`.
- Если нужно передать — через файл с chmod 600. - Если нужно передать — через файл с 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) # Matrix БД (в контейнере нет sqlite3, использовать python3)