Compose с пояснениями
services:
db:
image: mariadb:12.3
container_name: dbВерсию пишем явно. С latest (или с тегом из .env, где стоит latest) база обновится при первом же pull — в том числе на версию, где убраны параметры из command.
mem_limit: 512MПредел памяти контейнера: буфер InnoDB плюс соединения и служебное.
stop_grace_period: 2mСколько Docker ждёт при остановке. По умолчанию — 10 с, затем SIGKILL: под нагрузкой база не успевает дописать, и при следующем старте её ждёт crash recovery. При выключении сервера время ограничивает ещё и systemd: у docker.service своего TimeoutStopSec нет, действует общий — 90 с, меньше двух минут. Даём запас: sudo systemctl edit docker, в нём [Service] и TimeoutStopSec=3min.
command:
- --disable-log-binДвоичный журнал нужен для репликации и восстановления на момент времени. Одиночной базе с ежедневными дампами он только занимает диск. Цена: восстановить можно только на момент дампа.
- --innodb-buffer-pool-size=96MБуфер InnoDB — главный потребитель памяти. Маленькой базе хватает размера «горячих» данных. 96M — значение с конкретного сервера, своё подбираем под свои данные.
- --innodb-flush-log-at-trx-commit=21 (по умолчанию) сбрасывает журнал на диск при каждом коммите. 2 пишет в ОС при коммите, а на диск — примерно раз в секунду: при падении сервера (питание, ядро) теряется до секунды транзакций, при падении самой базы — ничего. Для блога это приемлемо, для денег — нет.
- --innodb-log-file-size=64MРазмер журнала изменений: меньше — быстрее восстановление после сбоя, но чаще сброс страниц на диск. 64M — тоже пример с конкретного сервера.
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ciutf8mb4 — полный Юникод, включая эмодзи; utf8 в MySQL и MariaDB — урезанный.
restart: unless-stopped
networks: [backend]Сеть только для приложений. Порт наружу не публикуется: ports: у базы нет.
volumes:
- db_data:/var/lib/mysqlДанные — в именованном томе. Его имя — с префиксом проекта (<проект>_db_data), поэтому каталог стека без name: не переименовываем («Имя проекта compose»).
tmpfs:
- /tmp:size=128MВременные таблицы (сортировки, GROUP BY) живут в памяти, а не на диске.
environment:
MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
MARIADB_DATABASE: wordpress
MARIADB_USER: wp
MARIADB_PASSWORD: ${MARIADB_PASSWORD}Работают только при первом запуске: создают базу и пользователей, когда каталог данных пуст. Потом их смена пароль не меняет — для этого ALTER USER (ниже). Образ понимает и старые имена MYSQL_*. Значения — в .env (600) или через *_FILE и Docker secret («Секреты в Docker-стеках»).
volumes:
db_data:Чего в command нет и почему
| Параметр | Что делает | Почему убран |
|---|---|---|
--innodb-doublewrite=0 |
отключает двойную запись страниц | двойная запись защищает от «порванных» страниц при сбое посреди записи. На SSD почти ничего не стоит; выключать — только на медленном HDD и понимая риск |
--innodb-use-native-aio=OFF |
выключает асинхронный ввод-вывод ОС | помогал на перегруженном HDD; на SSD остаётся по умолчанию (включено) |
--innodb-flush-method=O_DIRECT |
запись мимо кэша ОС | устарел в MariaDB 11+; O_DIRECT и так по умолчанию с 10.6 |
--innodb-file-per-table=1 |
файл на таблицу | устарел в MariaDB 11+; и так включено по умолчанию |
Устаревшие параметры дают в логе Warning: … is deprecated and will be removed in a future release. Убираем
их до обновления образа: в версии, где их удалят, база с ними не запустится.
Дамп, смена пароля, ожидание готовности
Дамп — без пароля в командной строке, пароль берётся из окружения контейнера:
docker exec db sh -c 'exec mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction wordpress' | gzip > wordpress_$(date +%F).sql.gz
--single-transaction даёт согласованный снимок InnoDB без блокировки таблиц.
Смена пароля root без вывода на экран:
cd /opt/db
new=$(openssl rand -hex 20)
docker exec -e NEW="$new" db sh -c 'mariadb -u root -p"$MARIADB_ROOT_PASSWORD" -e "ALTER USER IF EXISTS root@localhost IDENTIFIED BY \"$NEW\"; ALTER USER IF EXISTS root@\"%\" IDENTIFIED BY \"$NEW\";"' \
&& sed -i "s/^MARIADB_ROOT_PASSWORD=.*/MARIADB_ROOT_PASSWORD='$new'/" .env && echo "пароль сменён, .env обновлён"
unset new
docker compose up -d # пересоздаём, чтобы в контейнере был новый пароль
&& здесь затем, чтобы .env менялся, только если база приняла новый пароль: иначе они разойдутся.
Ждём готовности после перезапуска:
for i in $(seq 1 30); do
docker exec db sh -c 'mariadb -u root -p"$MARIADB_ROOT_PASSWORD" -e "SELECT 1"' >/dev/null 2>&1 && { echo "база готова"; break; }
sleep 5
done
docker logs db --since 2m 2>&1 | grep -iE 'warn|error|recovery|ready'
Под другое железо и другие задачи
| Ситуация | Что меняем |
|---|---|
| медленный HDD, база тормозит | пробуем --innodb-use-native-aio=OFF и меньший innodb-log-file-size; doublewrite=0 — только осознанно, с бэкапами |
| SSD, памяти мало | конфиг выше как есть |
| база с деньгами или заказами | --innodb-flush-log-at-trx-commit=1 и двоичный журнал — для восстановления на момент времени |
| несколько приложений | отдельный пользователь и база на каждое; root — только для обслуживания |
Если не работает
ERROR 2002 … Can't connect to local server through socket сразу после up -d
- Причина
- База ещё стартует.
- Делаем
- Ждём — цикл в разделе «Дамп, смена пароля, ожидание готовности» — и смотрим
ready for connectionsв логе.
ERROR 1045 Access denied после смены пароля
- Причина
- Пароль в базе и в
.envразошёлся. - Делаем
- Больше ничего не трогаем: выясняем, на каком шаге разошлось — сменился ли пароль в базе, — и возвращаем совпадение.
В логе после перезапуска — crash recovery
- Причина
- Прошлая остановка не была чистой: база не уложилась в тайм-аут, и Docker её убил.
- Делаем
- Ставим
stop_grace_periodи проверяем целостность:mariadb-check.
В логе — deprecated
- Причина
- В
commandпараметр, который уберут в одной из следующих версий. - Делаем
- Убираем его до обновления образа: в версии, где его удалят, база с ним не запустится.
Сменили пароль пользователя приложения — сайт не подключается к базе
- Причина
- Пароль записан в двух
.env: у базыMARIADB_PASSWORD, у WordPressWORDPRESS_DB_PASSWORD. - Делаем
- Меняем оба и делаем
ALTER USERдля этого пользователя.
В command остались настройки от другого железа
- Причина
- Стек переехал с HDD на SSD, а «спасательные» параметры для HDD остались. Комментарии в файле про переезд не знают.
- Делаем
- Сверяемся с тем, где база работает сейчас, — таблица «Под другое железо и другие задачи».
Пароль root попал в историю оболочки или в чат
- Причина
- Значение видели все, у кого есть доступ к истории или к переписке.
- Делаем
- Меняем без вывода на экран — команда в разделе «Дамп, смена пароля, ожидание готовности».
Как проверить
docker logs db 2>&1 | grep -iE 'deprecated|recovery' # пусто
docker inspect db --format '{{.Config.StopTimeout}}' # 120 — stop_grace_period применился