docker compose —remove-orphans удалил мне базы данных: как работает имя проекта в Compose

—

от автора

docker compose -f app.yml down --remove-orphans удаляет контейнеры из соседнего infra.yml, если оба файла лежат в одной папке. Причина — имя проекта: по умолчанию это имя папки, а не файла, поэтому два файла в одной директории — это один проект.

У меня было так: инфраструктура (MongoDB, Redis, RabbitMQ, nginx, туннель) в infra.yml, приложение — в app.yml, обе в одной папке. Разделили, чтобы перезапускать приложение, не трогая базы. Захотел почистить старые контейнеры приложения через down --remove-orphans — и лёг весь стек. Данные уцелели только потому, что лежали в именованных томах. Ниже — как Compose определяет проект и «сирот», минимальное воспроизведение и способы защиты.

Как Compose вычисляет имя проекта

Имя проекта берётся из первого сработавшего источника, по убыванию приоритета:

  1. Флаг -p / --project-name.

  2. Переменная COMPOSE_PROJECT_NAME (из окружения или из .env в папке проекта).

  3. Ключ верхнего уровня name: в compose-файле.

  4. Имя папки, в которой лежит первый файл из -f.

  5. Имя текущей папки, если файл не указан.

Имя файла в этом списке не участвует никак. infra.yml и app.yml из папки demo/ без name: и -p дают один и тот же проект demo. Имя приводится к нижнему регистру, лишние символы выбрасываются, так что My.App и myapp тоже могут совпасть. Имя проекта — это префикс для всего, что создаёт Compose: контейнеры demo-redis-1, сеть demo_default, том demo_redis_data.

Как Compose находит «сирот»

Compose не хранит состояние в файлах: всё, что он знает о запущенном проекте, он читает из меток контейнеров. Каждый контейнер получает метки:

• com.docker.compose.project — имя проекта;

• com.docker.compose.service — имя сервиса;

• com.docker.compose.project.config_files — файлы, из которых его подняли.

При up и down Compose запрашивает у Docker все контейнеры с com.docker.compose.project=<имя> и сравнивает их сервисы со списком сервисов из переданных -f. Всё, чего нет в этих файлах, — сирота. Метку config_files при этом никто не проверяет: то, что redis поднят из infra.yml, записано, но не учитывается. Без --remove-orphans Compose сирот не трогает, только пишет предупреждение Found orphan containers ([demo-redis-1]) for this project. С флагом — останавливает и удаляет. То же самое делает up --remove-orphans и переменная COMPOSE_REMOVE_ORPHANS=true, а COMPOSE_IGNORE_ORPHANS=true просто глушит предупреждение — то есть прячет единственный сигнал о проблеме.

Воспроизведение

Папка demo/, два файла. infra.yml:

  redis:    image: redis:7-alpine    volumes:      - redis_data:/datavolumes:  redis_data:

app.yml:

  web:    image: nginx:alpine    ports:      - "8080:80"

Поднимаем оба и смотрим метки:

cd demodocker compose -f infra.yml up -ddocker compose -f app.yml up -ddocker ps --format "table {{.Names}}\t{{.Label \"com.docker.compose.project\"}}"
NAMES          PROJECTdemo-web-1     demodemo-redis-1   demo

Оба контейнера — в проекте demo. Уже второй up пишет Found orphan containers ([demo-redis-1]) — это первый звоночек, его легко пропустить.

Теперь «чистим» приложение:

docker compose -f app.yml down --remove-orphansdocker ps

Redis пропал вместе с nginx. Для Compose сервиса redis нет в app.yml, значит он сирота проекта demo. Про соседний infra.yml он не знает и не обязан знать.

docker volume ls
DRIVER    VOLUME NAMElocal     demo_redis_data

Том на месте. Восстановление — обычный docker compose -f infra.yml up -d: имя тома то же, новый контейнер подхватит старые данные.

Почему данные выжили и когда не выживут

down без -v удаляет контейнеры и сети, но не тома. Именно поэтому у меня уцелели MongoDB, Redis и RabbitMQ. Риск растёт в трёх случаях: • Нет тома вообще. Данные в слое контейнера уничтожаются вместе с контейнером, без вариантов. • Анонимный том. Образы mongo, redis, postgres объявляют VOLUME в Dockerfile. Если в compose-файле том не описан, данные лежат в томе с именем-хешем. После down он остаётся висеть бесхозным, новый контейнер его не подхватит, а первый же docker volume prune его удалит. • **down -v --remove-orphans**. -v удаляет именованные тома из секции volumes: и анонимные тома контейнеров. Комбинация с чужими «сиротами» — самый короткий путь к потере данных.

Найти осиротевший анонимный том можно так:

docker volume ls -f dangling=truedocker volume inspect <hash> --format '{{.CreatedAt}} {{.Mountpoint}}'

Правило простое: у любой базы — именованный том или bind mount, объявленные явно.

Как защититься

Суть одна: либо у каждого файла свой проект, либо проект один и в каждую команду идут все файлы.

Вариант 1 — name: внутри файла. Самый надёжный: имя путешествует вместе с файлом и не зависит от того, кто и откуда запускает.

# infra.ymlname: myapp-infraservices:  ...
# app.ymlname: myapp-appservices:  ...

Вариант 2 — -p в команде. Работает, пока все помнят про флаг. Забыли один раз — получили третий проект demo с дублями контейнеров и конфликтом портов. Лучше зашить в Makefile или скрипт.

docker compose -p myapp-infra -f infra.yml up -ddocker compose -p myapp-app -f app.yml up -d

Вариант 3 — один проект, всегда все файлы. Тогда --remove-orphans снова безопасен и удаляет только реально удалённые сервисы.

docker compose -f infra.yml -f app.yml up -d --remove-orphans

Чтобы не перечислять файлы каждый раз, пропишите их в .env: COMPOSE_FILE=infra.yml:app.yml (разделитель : на Linux/macOS, ; на Windows). Другой вариант — главный compose.yml с include: (Compose 2.20+). А перезапуск только приложения делается адресно: docker compose up -d --no-deps web.

Общая сеть при разделении проектов

После разделения web перестанет видеть redis по имени: у каждого проекта своя сеть <проект>_default. Нужна общая внешняя сеть в обоих файлах:

networks:  default:    name: myapp-net    external: true
docker network create myapp-net

external: true заодно защищает сеть: down не будет пытаться её удалить.

Проверка

docker compose ls
NAME          STATUS      CONFIG FILESmyapp-app     running(1)  /srv/demo/app.ymlmyapp-infra   running(1)  /srv/demo/infra.yml

Если в колонке CONFIG FILES у одного проекта через запятую видны файлы, которые вы запускаете по отдельности, — они делят один проект, и --remove-orphans опасен.

Ловушка при смене имени проекта

Если просто дописать name: myapp-infra в живой infra.yml, базы поднимутся пустыми. Том redis_data теперь вычисляется как myapp-infra_redis_data, Compose создаст новый, а старый demo_redis_data останется нетронутым. Данные не потеряны, но приложение их не видит. Плюс старые контейнеры demo-* продолжат работать и держать порты. Безопасная миграция — зафиксировать имя тома явно, чтобы оно не зависело от проекта:

name: myapp-infraservices:  redis:    image: redis:7-alpine    volumes:      - redis_data:/datavolumes:  redis_data:    name: demo_redis_data   # старое имя, без префикса проекта

Порядок переезда:

# 1. остановить старый проект целиком, без -vdocker compose -p demo -f infra.yml -f app.yml down# 2. поднять новые проектыdocker network create myapp-netdocker compose -f infra.yml up -ddocker compose -f app.yml up -d# 3. убедиться, что смонтирован старый томdocker inspect myapp-infra-redis-1 --format '{{range .Mounts}}{{.Name}}{{end}}'

После шага 1 старая сеть demo_default удалится, тома останутся. Для томов, которые должны пережить любой down -v, есть external: true: Compose их не создаёт и не удаляет.

Чек-лист

• У каждого compose-файла, который запускается отдельно, есть name:.

• У каждой базы — именованный том, для критичных — с явным name: или external: true.

• Предупреждение Found orphan containers — повод остановиться и прочитать список, а не добавить --remove-orphans.

• COMPOSE_IGNORE_ORPHANS и COMPOSE_REMOVE_ORPHANS не ставим глобально.

• Перед чисткой — docker compose ls: сразу видно, какие файлы делят один проект.

• down -v — только когда действительно нужно снести данные.

А какие неочевидные грабли Compose попадались вам? Пишите в комментариях.

ссылка на оригинал статьи https://habr.com/ru/articles/1110618/