Оптимизированная установка 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, каталог данных сервера внутри контейнера.

Ещё один способ сохранения данных — использовать bind-mount каталог хоста, используя опцию --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 (каталог данных внутри контейнера). Для работы bind-mounting необходимо выполнить следующие условия:

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

Если есть какие-либо .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:9.2

С помощью этой команды 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, перечислены здесь: