8.8 KiB
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)
В CT113 dockerd 20.10 (API 1.41), а пакетный docker-compose-plugin 5.1 требует
более новый API: client version 1.53 is too new. Обновлять dockerd на CT с
Loki/Grafana рискованно, поэтому поставлен совместимый compose в /usr/local
(он приоритетнее пакетного):
mkdir -p /usr/local/lib/docker/cli-plugins
python3 -c "import urllib.request;urllib.request.urlretrieve('https://github.com/docker/compose/releases/download/v2.24.7/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 # v2.24.7
После этого все четыре сервиса CT113 (loki, promtail, oauth2-proxy-backup,
beszel-agent) запускаются из compose. loki /ready → 200.
Ещё одна ловушка того же дня: если часть контейнеров создана docker run,
compose up упирается в Conflict. The container name is already in use.
Правильно — удалить все контейнеры сервисов по одному, затем compose up -d.
Правило: сверять до удаления
28.10.2026 генератор терял аргументы запуска (поле Cmd, а не Command):
loki, alertmanager, четыре exportarr и webhook поднялись без нужных флагов.
Итог — observability лежала около 20 минут.
Перед удалением контейнеров запускать сверку:
python3 ops/scripts/check-compose-parity.py 134
# CT134: сервисов 8, расхождений 0
Скрипт сравнивает image, entrypoint, command, ключи env, монтирования и порты
между deploy/ctNNN/docker-compose.yml и живым контейнером. Ненулевой код
возврата = расхождения есть, удалять контейнеры нельзя.
Итог перевода: 26 из 26 CT (28.10.2026)
Все контейнеры, созданные docker run, описаны в deploy/ctNNN/docker-compose.yml.
Исключение — loki в CT113: там compose несовместим с dockerd, контейнер
запускается docker run (см. раздел про CT113).
Ещё одна пойманная ловушка
docker rm -f a b c прерывается на первом отсутствующем имени и остальные
не удаляет. Из-за этого в CT155 при переносе остался старый promtail, новый
compose up упал на конфликте имени, а matrix-synapse и matrix-coturn при
этом не создались — Matrix лежал около 5 минут, пока не удалил контейнер
вручную и не поднял всё чисто.
Правило: удалять контейнеры по одному (docker rm -f NAME в цикле с || true)
и после up проверять не только «контейнер запущен», но и что он в списке.