Переменные окружения официального Docker-образа MariaDB Server

При запуске образа %%IMAGE%% вы можете настроить инициализацию экземпляра MariaDB Server, передав одну или несколько переменных окружения в командной строке docker run. Обратите внимание, что ни одна из нижеперечисленных переменных не повлияет на запуск контейнера, если директория данных уже содержит базу данных: любая существующая база данных останется неизменной при запуске контейнера.

Начиная с тегов 10.2.38, 10.3.29, 10.4.19, 10.5.10 и всех тегов 10.6 и более поздних версий, предоставляются эквивалентные переменные MARIADB_*. Варианты MARIADB_* всегда будут использоваться вместо вариантов MYSQL_*.

Необходимо указать одну из переменных MARIADB_ROOT_PASSWORD_HASH, MARIADB_ROOT_PASSWORD, MARIADB_ALLOW_EMPTY_ROOT_PASSWORD или MARIADB_RANDOM_ROOT_PASSWORD (или их эквиваленты, включая *_FILE). Другие переменные окружения являются необязательными.

MARIADB_ROOT_PASSWORD_HASH / MARIADB_ROOT_PASSWORD / MYSQL_ROOT_PASSWORD

Указывает пароль, который будет задан для учетной записи суперпользователя MariaDB root.

MARIADB_ALLOW_EMPTY_ROOT_PASSWORD / MYSQL_ALLOW_EMPTY_PASSWORD

Присвойте ненулевое значение, например 1, чтобы разрешить запуск контейнера с пустым паролем для пользователя root. ПРИМЕЧАНИЕ: Не рекомендуется устанавливать эту переменную в значение «да», если вы не уверены в том, что делаете, поскольку это сделает ваш экземпляр MariaDB полностью незащищенным, позволяя любому получить полный доступ суперпользователя.

MARIADB_RANDOM_ROOT_PASSWORD / MYSQL_RANDOM_ROOT_PASSWORD

Присвойте ненулевое значение, например yes, чтобы сгенерировать случайный начальный пароль для пользователя root. Сгенерированный пароль root будет выведен в стандартный вывод (GENERATED ROOT PASSWORD: .....).

MARIADB_ROOT_HOST / MYSQL_ROOT_HOST

Это имя хоста созданного пользователя root. По умолчанию это %, однако его можно установить на любое допустимое значение MariaDB. Установка в значение localhost предотвратит доступ к любому пользователю root, кроме как через сокет Unix.

MARIADB_DATABASE / MYSQL_DATABASE

Эта переменная позволяет указать имя базы данных, которое будет создано при запуске образа.

MARIADB_USER / MYSQL_USER, MARIADB_PASSWORD_HASH / MARIADB_PASSWORD / MYSQL_PASSWORD

Для создания пользователя необходимы как переменные пользователя и пароля, так и база данных. Данному пользователю будет предоставлен полный доступ (соответствующий GRANT ALL) к базе данных MARIADB_DATABASE.

Не используйте этот механизм для создания суперпользователя root, этот пользователь создается по умолчанию с паролем, указанным в переменной MARIADB_ROOT_PASSWORD / MYSQL_ROOT_PASSWORD.

MARIADB_MYSQL_LOCALHOST_USER / MARIADB_MYSQL_LOCALHOST_GRANTS

Установите MARIADB_MYSQL_LOCALHOST_USER в ненулевое значение, чтобы создать пользователя базы данных mysql@locahost. Этот пользователь особенно полезен для различных проверок работоспособности и скриптов резервного копирования.

Пользователь mysql@localhost получает USAGE привилегии по умолчанию. Если требуется больший доступ, можно предоставить дополнительные глобальные привилегии в виде списка, разделенного запятыми. Если вы используете общий том, содержащий сокет Unix MariaDB (/var/run/mysqld по умолчанию), привилегии, выходящие за рамки USAGE, могут привести к рискам конфиденциальности, целостности и доступности, поэтому используйте минимальный набор. Также возможно использование для Mariadb-backup. Скрипт healthcheck.sh также содержит список требуемых привилегий для каждого теста проверки работоспособности.

MARIADB_HEALTHCHECK_GRANTS

Установите MARIADB_HEALTHCHECK_GRANTS в привилегии, которые должны быть предоставлены пользователям healtcheck@localhost, healtcheck@127.0.0.1, healtcheck@::1. Если не указано, то по умолчанию предоставляется USAGE.

Основное значение, используемое здесь, будет REPLICA MONITOR for the healthcheck --replication test.

MARIADB_INITDB_SKIP_TZINFO / MYSQL_INITDB_SKIP_TZINFO

По умолчанию скрипт entrypoint автоматически загружает данные часовых поясов, необходимые для функции CONVERT_TZ(). Если они не нужны, любое ненулевое значение отключит загрузку часовых поясов.

MARIADB_AUTO_UPGRADE / MARIADB_DISABLE_UPGRADE_BACKUP

Установите MARIADB_AUTO_UPGRADE в ненулевое значение, чтобы скрипт entrypoint проверял, требуется ли выполнить mariadb-upgrade, и, если да, выполнил обновление перед запуском сервера MariaDB.

Перед обновлением резервная копия базы данных системы создается в верхней части datadir с именем system_mysql_backup_*.sql.zst. Этот процесс резервного копирования можно отключить, установив MARIADB_DISABLE_UPGRADE_BACKUP в ненулевое значение.

MARIADB_MASTER_HOST

При указании этой переменной контейнер подключится к этому хосту и будет выполнять репликацию с него.

MARIADB_REPLICATION_USER / MARIADB_REPLICATION_PASSWORD_HASH / MARIADB_REPLICATION_PASSWORD

При указании MARIADB_MASTER_HOST, MARIADB_REPLICATION_USER и MARIADB_REPLICATION_PASSWORD будут использоваться для подключения к мастеру.

Если не указано, MARIADB_REPLICATION_USER будет создан с привилегиями REPLICATION REPLICA, необходимыми клиенту для начала репликации.