6.8.1 Deploying Sandbox Instances — MySQL Shell 8.4

6.8.1 Развёртывание экземпляров песочницы

Вместо использования производственной настройки, где каждый экземпляр работает на отдельном хосте, AdminAPI предоставляет операцию dba.deploySandboxInstance(port_number). Аргумент port_number — это номер TCP-порта, на котором экземпляр MySQL Server слушает подключения. Для развертывания нового экземпляра песочницы, привязанного к порту 3310, выполните команду:

mysql-js> dba.deploySandboxInstance(3310)

По умолчанию песочница создаётся в каталоге с именем $HOME/mysql-sandboxes/port на системах Unix. Для систем Microsoft Windows каталог — %userprofile%\MySQL\mysql-sandboxes\port. Каждый экземпляр песочницы хранится в каталоге, названном в соответствии с port_number.

От вас запросят пароль пользователя root.

Важно

Каждый экземпляр песочницы использует пользователя root и пароль, и они должны быть одинаковыми для всех экземпляров песочницы, которые должны работать вместе. Это не рекомендуется в производственной среде.

Для развертывания другого экземпляра сервера песочницы повторите шаги, выполненные для экземпляра песочницы на порту 3310, выбирая разные номера портов для каждого экземпляра.

Чтобы изменить каталог, в котором хранятся песочницы, например, для запуска нескольких песочниц на одном хосте в тестовых целях, используйте параметр MySQL Shell sandboxDir. Например, чтобы использовать песочницу в каталоге /home/user/sandbox1, выполните команду:

mysql-js> shell.options.sandboxDir='/home/user/sandbox1'

Все последующие операции, связанные с песочницей, будут выполняться с экземплярами, находящимися по адресу /home/user/sandbox1.

При развертывании песочниц MySQL Shell ищет бинарный файл mysqld, который затем используется для создания экземпляра песочницы. Вы можете настроить местоположение поиска MySQL Shell для бинарного файла mysqld, настроив переменную среды PATH. Это может быть полезно для тестирования новой версии MySQL локально перед её развертыванием в производство. Например, чтобы использовать бинарный файл mysqld по пути /home/user/mysql-latest/bin/, выполните:

PATH=/home/user/mysql-latest/bin/:$PATH

Затем запустите MySQL Shell из терминала, где установлена переменная среды PATH. Все развертываемые песочницы будут использовать бинарный файл mysqld, найденный по заданному пути.

Следующие параметры поддерживаются операцией dba.deploySandboxInstance():

allowRootFrom настраивает хост, с которого пользователь root может подключаться. По умолчанию — root@%.
ignoreSslError настраивает защищённые подключения к экземпляру песочницы. Когда ignoreSslError имеет значение true (по умолчанию), при отсутствии поддержки SSL во время операции не выдаётся ошибка, и экземпляр сервера развертывается без SSL. Когда ignoreSslError установлено в значение false, экземпляр песочницы развертывается с поддержкой SSL, и при невозможности её настроить выдаётся ошибка.
mysqldOptions настраивает дополнительные параметры экземпляра песочницы. По умолчанию пустая строка, и принимает список строк, определяющих параметры и значения. Например, mysqldOptions: ["lower_case_table_names=1", "report_host="10.1.2.3"]}. Указанные параметры записываются в файл параметров экземпляра песочницы.
portX настраивает порт, используемый для подключений X Protocol. По умолчанию рассчитывается, умножая значение на 10. Значение — целое число от 1024 до 65535.