deploy/ — compose-файлы по контейнерам
Правило: Git — источник истины. Файл из deploy/ctNNN/docker-compose.yml
копируется на контейнер в /opt/ctNNN/docker-compose.yml и оттуда запускается.
Ручной docker run больше не используется: иначе состояние контейнера и
репозиторий расходятся, и при следующем аудите находится «порт съехал»
(реальный случай: n8n 5678 в копии скрипта против живого 5680).
Секреты
В compose-файлах нет значений секретов — только переменные ${VAR}.
Значения лежат рядом в .env (права 600, в Git не попадает), образец —
env.example. Сами значения — в Vaultwarden, папка infra.
Применение
# на контейнере
cd /opt/ctNNN
docker compose up -d
Перед изменением состава контейнеров — снапшот: pct snapshot NNN <метка>.
Что уже переведено
| CT | Файл | Состав | Примечание |
|---|---|---|---|
| 140 | ct140/docker-compose.yml |
gitea, gitea-runner, promtail, beszel-agent | 28.10.2026: три контейнера были «руками», теперь все четыре под compose. Ловушка AppArmor — в ops/gitea/RUNNER-APPARMOR-2026-10-28.md |
Известные особенности CT140
security_opt: apparmor:unconfinedобязателен для каждого контейнера: внутри CT140 Docker не может загрузить профильdocker-default.- У
gitea-runnerдополнительноCONFIG_FILE=/data/config.yaml— без этой переменнойrun.shне передаёт--config, и опцияcontainer.options(нужная, чтобы job-контейнеры стартовали) молча игнорируется.
Ловушки, пойманные при переносе (28.10.2026)
- promtail без
-config.fileчитает встроенный конфиг образа — в нём нетclients, и контейнер падает:at least one client config must be provided. Поэтому в compose у promtail всегда естьcommand: ["-config.file=/etc/promtail/config.yml"]. - Позиции promtail нельзя держать в
/tmp: при пересоздании контейнера они теряются, promtail начинает перечитывать старые логи, а Loki отбрасывает их (timestamp too old) — поток ошибок в логе. Позиции вынесены на хост:/opt/promtail-positions:/var/lib/promtail. - Генератор читает живое состояние. Если в момент генерации в контейнере
висит временный контейнер (например, тестовый), он попадёт в файл. Поэтому
docker-to-compose.pyбез--forceне перезаписывает существующийdeploy/ctNNN/docker-compose.yml.
Снапшоты недоступны на 12 CT (важно для правила «сначала снапшот»)
Проверено 28.10.2026: pct snapshot возвращает snapshot feature is not available,
если у контейнера есть bind-монтирование (mpX). Такие CT:
103, 105, 109, 111, 117, 118, 120, 123, 125, 126, 155, 160
Например, CT103: mp0: /mnt/media,mp=/media.
Что делать вместо снапшота:
# 1. сохранить конфиг (секунды, обратимо руками)
cp /etc/pve/lxc/103.conf /root/lxc-conf-103-$(date +%Y%m%d-%H%M).bak
# 2. если меняется что-то серьёзное — полный дамп (дольше)
vzdump 103 --storage /mnt/archive/backups/dump --mode suspend --compress zstd
Для правок, которые касаются только контейнеров внутри CT (Docker в rootfs),
данные на /mnt/media не затрагиваются — но это надо осознанно принять,
а не считать, что снапшот есть.
Обязательное требование: плагин compose
Перед переносом проверять, что в CT есть плагин:
pct exec NNN -- docker compose version
28.10.2026 на CT124 и CT126 плагина не было: docker compose up молча упал,
а контейнеры к этому моменту уже были удалены — frigate (запись камер) и
jackett стояли около 3 минут. Восстановлены через docker run из
deploy/ctNNN/docker-compose.yml, затем плагин установлен:
mkdir -p /usr/local/lib/docker/cli-plugins
python3 -c "import urllib.request;urllib.request.urlretrieve('https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64','/usr/local/lib/docker/cli-plugins/docker-compose')"
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
Правило: сначала убедиться, что docker compose version работает,
и только потом удалять контейнеры.
CT113: compose несовместим с dockerd (28.10.2026)
docker compose в CT113 (клиент API 1.53) отказывается работать со старым
dockerd (максимум 1.41): client version 1.53 is too new. Поэтому loki там
запущен через docker run (аргумент -config.file=/etc/loki/local-config.yaml),
хотя описание лежит в deploy/ct113/docker-compose.yml. Привести к единому
виду можно двумя путями: обновить dockerd в CT113 либо поставить compose
версии, совместимой с API 1.41.