basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Удалили сервис из compose — контейнер остался: --remove-orphans

    Переименовали или удалили сервис в compose — его старый контейнер работает дальше и держит порт: compose управляет только тем, что есть в файле. docker compose up -d --remove-orphans убирает такие контейнеры.

    Откуда берутся осиротевшие контейнеры

    Свои контейнеры 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 его в файле не видит.