basforge

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

    EN
    КонфигDockerDocker Compose

    MariaDB в контейнере: compose с пояснениями

    Compose для небольшой базы под один-два сайта на маленьком сервере: памяти берёт немного, а настроек, которые ради скорости рискуют данными, в нём нет. Плюс дамп и смена пароля root без пароля в командной строке.

    Compose с пояснениями

    docker-compose.yaml
    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=2

    1 (по умолчанию) сбрасывает журнал на диск при каждом коммите. 2 пишет в ОС при коммите, а на диск — примерно раз в секунду: при падении сервера (питание, ядро) теряется до секунды транзакций, при падении самой базы — ничего. Для блога это приемлемо, для денег — нет.

          - --innodb-log-file-size=64M

    Размер журнала изменений: меньше — быстрее восстановление после сбоя, но чаще сброс страниц на диск. 64M — тоже пример с конкретного сервера.

          - --character-set-server=utf8mb4
          - --collation-server=utf8mb4_unicode_ci

    utf8mb4 — полный Юникод, включая эмодзи; 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, у WordPress WORDPRESS_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 применился