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

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

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

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

docker run --name mysql1 -d mysql/mysql-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 mysql/mysql-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 mysql/mysql-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 mysql/mysql-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 внутри контейнера имеет права записи в смонтированный файл хоста.

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

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

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