docker compose -f app.yml down --remove-orphans удаляет контейнеры из соседнего infra.yml, если оба файла лежат в одной папке. Причина — имя проекта: по умолчанию это имя папки, а не файла, поэтому два файла в одной директории — это один проект.
У меня было так: инфраструктура (MongoDB, Redis, RabbitMQ, nginx, туннель) в infra.yml, приложение — в app.yml, обе в одной папке. Разделили, чтобы перезапускать приложение, не трогая базы. Захотел почистить старые контейнеры приложения через down --remove-orphans — и лёг весь стек. Данные уцелели только потому, что лежали в именованных томах. Ниже — как Compose определяет проект и «сирот», минимальное воспроизведение и способы защиты.
Как Compose вычисляет имя проекта
Имя проекта берётся из первого сработавшего источника, по убыванию приоритета:
-
Флаг
-p/--project-name. -
Переменная
COMPOSE_PROJECT_NAME(из окружения или из.envв папке проекта). -
Ключ верхнего уровня
name:в compose-файле. -
Имя папки, в которой лежит первый файл из
-f. -
Имя текущей папки, если файл не указан.
Имя файла в этом списке не участвует никак. 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 --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 попадались вам? Пишите в комментариях.
Источник: habr.com