2.2 Installing MySQL Router with Docker — MySQL Router 8.4

2.2 Установка MySQL Router с Docker

Фреймворк Docker поддерживает лёгкую установку и настройку MySQL Router. Этот раздел описывает, как использовать образ MySQL Router Docker.

Вам необходимо иметь Docker, установленный на вашей системе, прежде чем использовать образ MySQL Router Docker. См. Установка Docker для инструкций.

Важно

Вам необходимо либо выполнить команды docker с помощью sudo, либо создать группу пользователей docker и добавить в неё всех пользователей, которые хотят запускать команды docker. См. подробности здесь. Поскольку контейнеры Docker всегда запускаются с правами root, вы должны понимать поверхность атаки демона Docker и должным образом смягчать связанные с ней риски.

Основные шаги для развертывания MySQL Router с Docker

Предупреждение

Образы MySQL Docker, поддерживаемые командой MySQL, разработаны специально для платформ Linux. Другие платформы не поддерживаются, и пользователи, использующие эти образы MySQL Docker на них, делают это на свой страх и риск.

Загрузка образа MySQL Router Docker

Загрузка образа сервера в отдельном шаге не строго необходима; однако, выполнение этого шага до создания вашего контейнера Docker гарантирует, что ваш локальный образ обновлён. Чтобы загрузить образ MySQL Community Edition, выполните эту команду:

$> docker pull container-registry.oracle.com/mysql/community-router:tag

tag — метка версии образа, которую вы хотите получить (например, 8.0). Если :tag опущено, используется метка latest, и загружается образ последней версии MySQL Community Router GA. Обратитесь к Oracle Container Registry и перейдите к образу MySQL Router в репозитории MySQL для получения полного списка меток доступных версий.

Таблица 2.1 Переменные

Таблица 2.1 Переменные
Переменная	Описание
`MYSQL_HOST`	Обязательно. Хост MySQL для подключения.
`MYSQL_PORT`	Обязательно. Порт прослушивания MySQL-сервера.
`MYSQL_USER`	Обязательно. Пользователь MySQL для подключения.
`MYSQL_PASSWORD`	Обязательно. Строка. Пароль пользователя MySQL.
`MYSQL_INNODB_CLUSTER_MEMBERS`	Необязательно. Целое число. Дождаться, пока будет онлайн заданное количество экземпляров кластера.
`MYSQL_CREATE_ROUTER_USER`	Необязательно. Булево. Создать новую учётную запись для использования MySQL Router при запуске. Значение по умолчанию включено (1). Установите 0 (ноль), чтобы отключить.
`MYSQL_ROUTER_BOOTSTRAP_EXTRA_OPTIONS`	Необязательно. Список дополнительных параметров командной строки, которые необходимо применить при загрузке.

Запуск в контейнере требует работоспособного кластера InnoDB. При условии наличия входных данных, скрипт запуска ожидает запуска хоста mysql, кластера InnoDB с количеством членов, определённым параметром MYSQL_INNODB_CLUSTER_MEMBERS, а затем использует предоставленный хост для загрузки. См. Раздел 3.1, «Загрузка MySQL Router».

Например:

$> docker run \
  -e MYSQL_HOST=localhost \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=mysql \
  -e MYSQL_PASSWORD=mysql \
  -e MYSQL_INNODB_CLUSTER_MEMBERS=3 \
  -e MYSQL_ROUTER_BOOTSTRAP_EXTRA_OPTIONS="--conf-use-socket --conf-use-gr-notification" \
  -ti container-registry.oracle.com/mysql/community-router

Чтобы использовать определённую версию MySQL Router, добавьте метку к значению -ti. Например: -ti container-registry.oracle.com/mysql/community-router:8.4.1 для MySQL Router 8.4.1. Чтобы использовать последнюю версию, не добавляйте метку.

Проверка статуса:

$> docker ps

Для получения дополнительной информации см. Oracle Container Registry и перейдите к образу MySQL Router в репозитории MySQL.