Откуда берутся осиротевшие контейнеры
Свои контейнеры compose находит по метке проекта, а каким сервисам они соответствуют — по файлу. Сервис shop
переименовали в web: для compose это новый сервис, а контейнер shop-shop-1 остался без описания. Такой
контейнер compose называет осиротевшим (orphan). up -d его не трогает, только предупреждает:
Found orphan containers (shop-shop-1) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up.
Если у старого и нового сервиса один порт, новый не стартует:
Bind for 0.0.0.0:8081 failed: port is already allocated
Без общего порта ошибки нет вовсе: обе копии работают, старая — со старыми настройками. В
docker compose ps она видна, в compose-файле её нет.
Что делаем
docker compose up -d --remove-orphans
Compose останавливает и удаляет осиротевшие контейнеры, потом поднимает новое. Тот же флаг есть у down.
Чтобы не вспоминать о нём, в .env стека пишем COMPOSE_REMOVE_ORPHANS=true — compose читает его оттуда и
убирает их при каждом up.
Перед удалением смотрим, не держит ли старый контейнер данных вне тома: docker diff shop-shop-1, строки с
A и C —
то, что пропадёт вместе с контейнером («Docker», «Что контейнер записал к себе»).
Если не работает
docker compose down прошёл без ошибки, а контейнер работает и сеть не удалилась: Resource is still in use
- Причина
- Это осиротевший контейнер:
downбез флага останавливает только сервисы из файла, а сеть занята оставшимся контейнером. Код выхода при этом 0. - Делаем
docker compose down --remove-orphans.
Новый сервис не стартует: port is already allocated, а предупреждения про осиротевшие контейнеры нет
- Причина
- В
.envили окружении стоитCOMPOSE_IGNORE_ORPHANS=true: он прячет предупреждение, но порт по-прежнему держит старый контейнер. - Делаем
- Старый контейнер виден в
docker compose ps. Убираем его —up -d --remove-orphans— и удаляем переменную.
Как проверить
Сервисы, у которых есть контейнеры, но нет описания в файле:
docker compose ps -a --format '{{.Service}}' | sort -u | grep -vxF -f <(docker compose --profile '*' config --services)
# shop
Пустой вывод — осиротевших контейнеров нет. --profile '*' нужен, чтобы запущенный сервис из профиля («Профили compose»)
не попал в список: без флага compose его в файле не видит.