Оптимизированная установка MySQL для Docker

Docker образы для MySQL оптимизированы по размеру кода, что означает, что они содержат только необходимые компоненты, которые, как ожидается, будут актуальны для большинства пользователей, запускающих экземпляры MySQL в контейнерах Docker. Установка MySQL Docker отличается от обычной, не-Docker установки в следующих аспектах:

Настройка сервера MySQL

При запуске контейнера MySQL Docker вы можете передать параметры конфигурации серверу через команду docker run. Например:

docker run --name mysql1 -d container-registry.oracle.com/mysql/community-server:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_col

Команда запускает сервер MySQL с utf8mb4 в качестве набора символов по умолчанию и utf8mb4_col как сортировки по умолчанию для баз данных.

Другой способ настройки сервера MySQL — подготовить файл конфигурации и смонтировать его в местоположение файла конфигурации сервера внутри контейнера. Подробности см. в разделе Сохранение данных и изменений конфигурации.

Сохранение данных и изменений конфигурации

Контейнеры Docker, по сути, временные, и все данные или конфигурации, как ожидается, будут потеряны, если контейнер будет удален или поврежден (см. обсуждение здесь). Docker тома предоставляют механизм сохранения данных, созданных внутри Docker контейнера. При инициализации контейнер сервера MySQL создаёт Docker том для каталога данных сервера. Вывод JSON команды docker inspect по контейнеру включает ключ Mount, значение которого предоставляет информацию о томе каталога данных:

$> docker inspect mysql1
...
 "Mounts": [
            {
                "Type": "volume",
                "Name": "4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652",
                "Source": "/var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data",
                "Destination": "/var/lib/mysql",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ],
...

Вывод показывает, что исходный каталог /var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data, в котором данные сохраняются на хосте, смонтирован в /var/lib/mysql, каталог данных сервера внутри контейнера.

Другой способ сохранения данных — смонтировать каталог хоста с помощью опции --mount при создании контейнера. Этот же метод можно использовать для сохранения конфигурации сервера. Следующая команда создаёт контейнер сервера MySQL и монтирует каталог данных и файл конфигурации сервера:

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/my.cnf,dst=/etc/my.cnf \
--mount type=bind,src=/path-on-host-machine/datadir,dst=/var/lib/mysql \
-d container-registry.oracle.com/mysql/community-server:tag 

Команда монтирует path-on-host-machine/my.cnf в /etc/my.cnf (файл конфигурации сервера внутри контейнера) и path-on-host-machine/datadir в /var/lib/mysql (каталог данных внутри контейнера). Для работы монтирования необходимо соблюдать следующие условия:

Запуск дополнительных скриптов инициализации

Если есть скрипты .sh или .sql, которые вы хотите запустить на базе данных сразу после ее создания, поместите их в каталог хоста, а затем смонтируйте каталог в /docker-entrypoint-initdb.d/ внутри контейнера. Например:

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/scripts/,dst=/docker-entrypoint-initdb.d/ \
-d container-registry.oracle.com/mysql/community-server:tag

Подключение к MySQL из приложения в другом контейнере Docker

С помощью Docker сети вы можете разрешить множественным Docker контейнерам взаимодействовать друг с другом, так что клиентское приложение в другом Docker контейнере может получить доступ к серверу MySQL в контейнере сервера. Сначала создайте Docker сеть:

docker network create my-custom-net

Затем, при создании и запуске контейнеров сервера и клиента, используйте опцию --network, чтобы поместить их в созданную сеть. Например:

docker run --name=mysql1 --network=my-custom-net -d container-registry.oracle.com/mysql/community-server

docker run --name=myapp1 --network=my-custom-net -d myapp

Контейнер myapp1 сможет подключиться к контейнеру mysql1 с именем хоста mysql1 и наоборот, так как Docker автоматически настраивает DNS для заданных имён контейнеров. В приведенном примере мы запускаем клиент mysql внутри контейнера myapp1, чтобы подключиться к хосту mysql1 в собственном контейнере:

docker exec -it myapp1 mysql --host=mysql1 --user=myuser --password

Для других сетевых методов для контейнеров см. раздел сети Docker контейнеров в документации Docker.

Журнал ошибок сервера

При первом запуске сервера MySQL с контейнером сервера, журнал ошибок сервера журнала ошибок сервера НЕ генерируется, если выполняется одно из следующих условий:

Чтобы заставить MySQL Server генерировать журнал ошибок, когда выполняется хотя бы одно из двух условий, используйте опцию --log-error, чтобы настроить сервер на генерацию журнала ошибок в определенном месте внутри контейнера. Чтобы сохранить журнал ошибок, смонтируйте файл хоста в местоположение журнала ошибок внутри контейнера, как описано в Разделе о сохранении данных и конфигурации. Однако необходимо убедиться, что ваш MySQL Server внутри контейнера имеет права записи в смонтированный файл хоста.

Использование MySQL Enterprise Backup с Docker

MySQL Enterprise Backup — это коммерческий инструмент резервного копирования для MySQL Server, доступный с MySQL Enterprise Edition. MySQL Enterprise Backup включён в Docker-установку MySQL Enterprise Edition.

В следующем примере предполагается, что у вас уже запущен MySQL Server в Docker-контейнере (см. раздел 2.5.6.1, «Основные шаги развертывания MySQL Server с Docker» о том, как запустить экземпляр MySQL Server с Docker). Для того чтобы MySQL Enterprise Backup смог выполнить резервное копирование MySQL Server, он должен иметь доступ к каталогу данных сервера. Это можно сделать, например, связывая каталог хоста с каталогом данных MySQL Server при запуске сервера:

docker run --name=mysqlserver \
--mount type=bind,src=/path-on-host-machine/datadir/,dst=/var/lib/mysql \
-d mysql/enterprise-server:8.4

С помощью этой команды MySQL Server запускается с Docker-изображением MySQL Enterprise Edition, а каталог хоста /path-on-host-machine/datadir/ был смонтирован на каталог данных сервера (/var/lib/mysql) внутри контейнера сервера. Мы также предполагаем, что после запуска сервера необходимые привилегии также были настроены для MySQL Enterprise Backup для доступа к серверу (см. , для получения подробностей). Используйте следующие шаги для резервного копирования и восстановления экземпляра MySQL Server.

Чтобы выполнить резервное копирование экземпляра MySQL Server, запущенного в Docker-контейнере, с помощью MySQL Enterprise Backup с Docker, следуйте указанным ниже шагам:

Чтобы восстановить экземпляр MySQL Server в Docker-контейнере с помощью MySQL Enterprise Backup с Docker, следуйте этим шагам:

Использование mysqldump с Docker

Помимо использования MySQL Enterprise Backup для резервного копирования MySQL Server, запущенного в Docker-контейнере, вы можете выполнить логическое резервное копирование сервера, используя утилиту mysqldump, запущенную внутри Docker-контейнера.

Следующие инструкции предполагают, что у вас уже запущен MySQL Server в Docker-контейнере и при первом запуске контейнера каталог хоста /path-on-host-machine/datadir/ был смонтирован на каталог данных сервера /var/lib/mysql (см. раздел о связывании каталога хоста с каталогом данных MySQL Server для подробностей), который содержит файл сокета Unix, с помощью которого mysqldump и mysql могут подключиться к серверу. Мы также предполагаем, что после запуска сервера был создан пользователь с соответствующими привилегиями (admin в этом примере), с помощью которого mysqldump может получить доступ к серверу. Используйте следующие шаги для резервного копирования и восстановления данных MySQL Server.

Резервное копирование данных MySQL Server с помощью mysqldump с Docker:

Восстановление данных MySQL Server с помощью mysqldump с Docker:

Известные проблемы

Переменные окружения Docker

При создании контейнера MySQL Server вы можете настроить экземпляр MySQL, используя опцию --env (сокращенная форма -e) и указание одной или нескольких переменных окружения. Инициализация сервера не выполняется, если смонтированный каталог данных не пуст, в этом случае установка любой из этих переменных не имеет эффекта (см. Сохранение данных и конфигурационных изменений), и при запуске контейнера существующее содержимое каталога, включая настройки сервера, не изменяется.

Переменные окружения, которые можно использовать для настройки экземпляра MySQL, перечислены здесь: