Files
buryan-infra/deploy
2026-10-28 13:48:53 +03:00
..

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.

Правило: сверять до удаления

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 и живым контейнером. Ненулевой код возврата = расхождения есть, удалять контейнеры нельзя.