153 lines
8.8 KiB
Markdown
153 lines
8.8 KiB
Markdown
# 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`.
|
||
|
||
## Применение
|
||
|
||
```bash
|
||
# на контейнере
|
||
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`.
|
||
|
||
Что делать вместо снапшота:
|
||
|
||
```bash
|
||
# 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 есть плагин:
|
||
|
||
```bash
|
||
pct exec NNN -- docker compose version
|
||
```
|
||
|
||
28.10.2026 на CT124 и CT126 плагина не было: `docker compose up` молча упал,
|
||
а контейнеры к этому моменту уже были удалены — frigate (запись камер) и
|
||
jackett стояли около 3 минут. Восстановлены через `docker run` из
|
||
`deploy/ctNNN/docker-compose.yml`, затем плагин установлен:
|
||
|
||
```bash
|
||
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
|
||
(он приоритетнее пакетного):
|
||
|
||
```bash
|
||
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 минут.
|
||
|
||
Перед удалением контейнеров запускать сверку:
|
||
|
||
```bash
|
||
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` проверять не только «контейнер запущен», но и что он в списке.
|