basforge

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

    EN

    Служебные сервисы стека — в profiles: up -d их не поднимает

    Adminer, разовый бэкап, миграцию держим в том же compose, что и сайт, но с profiles: [tools]. Обычный up -d их пропускает, а запускаем их по имени, когда нужны.

    Зачем

    Панель базы, бэкап, миграция нужны иногда, а работают с тем же стеком: та же сеть, та же база. Описанные обычными сервисами, они поднимаются на каждом up -d: панель с доступом ко всей базе открыта круглые сутки, бэкап запускается при каждом обновлении. Профиль оставляет их в файле, но выключенными.

    Как пишем

    services:
      db:
        image: mariadb:11.8
        # …
      adminer:
        image: adminer:5
        profiles: [tools]
        ports: ["127.0.0.1:8082:8080"]
      backup:
        image: mariadb:11.8
        profiles: [tools]
        # command: дамп базы — ссылка ниже

    Сервис без profiles поднимается всегда, с profiles — только когда профиль включён или сервис назван по имени:

    Команда Что делает
    docker compose up -d поднимает всё, кроме профилей
    docker compose up -d adminer поднимает adminer: раз сервис назван, профиль включается сам
    docker compose run --rm backup разовый запуск сервиса; контейнер удаляется после выхода
    docker compose --profile tools up -d поднимает всё вместе с профилем tools
    docker compose stop adminer останавливает только adminer
    docker compose --profile '*' down останавливает и удаляет всё, профили тоже

    run --rm — для разовых задач: бэкап, миграция, проверка. Контейнер получает сети, тома и переменные стека, печатает вывод в консоль и удаляется. Команда дампа MariaDB — в «MariaDB в контейнере».

    Если на этом сервере профиль нужен всегда — например, тестовая машина с adminer, — пишем в .env COMPOSE_PROFILES=tools: compose включает его без флага.

    Если не работает

    docker compose down прошёл, а adminer работает; в выводе — Resource is still in use

    Причина
    down без профиля не трогает сервисы профилей. --remove-orphans тоже: эти сервисы есть в файле, осиротевшими они не считаются.
    Делаем
    docker compose --profile '*' down — всё, включая профили; или docker compose stop adminer, если остальное нужно.

    up -d: service "app" depends on undefined service "adminer": invalid compose project

    Причина
    Сервис без профиля зависит от сервиса из профиля. Пока профиль не включён, второго сервиса для compose нет.
    Делаем
    Убираем depends_on на служебный сервис: основной стек не должен от него зависеть.

    Как проверить

    Что поднимет обычный up -d и какие профили есть в файле:

    docker compose config --services
    # db
    docker compose config --profiles
    # tools

    Служебных сервисов в первом списке быть не должно.