Зачем
Панель базы, бэкап, миграция нужны иногда, а работают с тем же стеком: та же сеть, та же база. Описанные
обычными сервисами, они поднимаются на каждом 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
Служебных сервисов в первом списке быть не должно.