infra_mariadb

Обзор Версии Аналитика
Логотип MariaDB

Ansible Роль - База Данных MariaDB - Мульти-Инстанс

Ansible роль для развертывания одного или нескольких инстансов MariaDB на сервере Linux.

Купи мне кофе

Статус теста Molecule Статус теста YamlLint Статус теста PyLint Статус теста Ansible-Lint Ansible Galaxy

Логи Molecule: Короткие, Полные

Проверено на:

  • Debian 11

Установка

# последняя версия
ansible-galaxy role install git+https://github.com/ansibleguy/infra_mariadb

# из galaxy
ansible-galaxy install ansibleguy.infra_mariadb

# или в кастомный путь для ролей
ansible-galaxy install ansibleguy.infra_mariadb --roles-path ./roles

# установка зависимостей
ansible-galaxy install -r requirements.yml

Использование

Хотите простой интерфейс Ansible? Посмотрите мой Ansible WebUI

Конфигурация

Вам нужно определить ваши инстансы, настроив словарь 'mariadb'!

mariadb:
  service:
    SyslogIdentifier: 'mariadb_ag_%I'  # %I = Ключ инстанса
    
  instances:
    api:
      root_pwd: !vault |
        $ANSIBLE_VAULT;1.1;AES256
        64373031333937633163366236663237623464336461613334343739323763373330393930666331
        3333663262346337636536383539303834373733326631310a393865653831663238383937626238
        35396531316338373030353530663465343838373635363633613035356338353366373231343264
        3437356663383466630a666161363163346533333139656566386466383733646134616166376638
        35313765356134396130333439663461353336313230366338646165376666313232

      dbs:
        api:
          encoding: 'utf8mb4'

        templates:
        deprecated:
          state: 'absent'
      
      users:
        app:
          priv: 'api.*:ALL'
          pwd: !vault ...
        guy:
          priv: 'api.*:SELECT,SHOW VIEW'
          state: 'absent'
          pwd: !vault ...

      settings:
        # порт: 3306
        innodb_log_file_size: 5G
        max_connections: 2000

      backup:
        enabled: true
        dbs: ['api']
        time: '*-*-* 01:00'
        creds:
          create: true

    test:
      ansible_user: 'not_root'
      ansible_pwd: !vault ...
      dbs:
        test:

      users:
        dummy:
          priv: 'test.*:ALL'
          pwd: !vault ...
          update_pwd: 'always'

      settings:
        port: 3307
        log_warnings: 4
        long_query_time: 2
        max_allowed_packet: 2G

    old_instance:
      state: 'absent'

Вы можете использовать 'ansible-vault' для шифрования ваших паролей:

ansible-vault encrypt_string

Выполнение

Запустите плейбук:

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml --ask-vault-pass

Также доступны некоторые полезные теги:

  • base => только базовая настройка; инстансы не будут затронуты
  • instances
  • config => конфигурация (base и instances)
  • dbs
  • backup => задания резервного копирования инстанса
  • users

Для отладки ошибок вы можете установить переменную 'debug' во время выполнения:

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml -e debug=yes

Функциональность

  • Установка пакетов

    • Зависимости Ansible (минимальные)
    • MariaDB

  • Конфигурация

    • Несколько инстансов MariaDB

    • Создание/удаление баз данных и пользователей

    • Скрипт проверки запуска, поддерживающий несколько инстансов

    • По умолчанию включено:

      • Выполнение задач безопасной установки
      • Уменьшение swappiness
      • Увеличение предела открытых файлов (sysctl, service, db)

    • По умолчанию исключено:

      • Задания резервного копирования БД

    • Конфигурации по умолчанию:

      • Директория инстанса: "/var/lib/mysql/instance_${KEY}/"
      • Конфигурация инстанса: "/etc/mysql/instance.conf.d/server_${KEY}.cnf"
      • Перезапуск службы при сбое
      • Логирование в syslog
      • Привязка только к localhost
      • SSL ВЫКЛ.
      • Журнал медленных запросов
      • InnoDB для каждой таблицы
      • Отключены DNS-запросы БД

Информация

  • ВНИМАНИЕ: Эта роль предполагает, что стандартный инстанс mariadb/mysql на целевой системе не используется и не будет использоваться!
    Сокет и порт изменяются при запуске этой роли!

  • ВНИМАНИЕ: Если вы запускаете серверы БД в конфигурации active-active, НИКОГДА не запускайте роль на обоих узлах одновременно!
    В противном случае задачи создания пользователей/БД могут нарушить вашу синхронизацию!

  • Примечание: эта роль в настоящее время поддерживает только системы на базе Debian.

  • Примечание: Большинство функций роли можно включить или выключить.

    Для всех доступных опций смотрите конфигурацию по умолчанию в главном файле с настройками!

  • Примечание: Мы используем официальные модули сообщества для настройки баз данных и пользователей. Поддержка репликации может быть добавлена позже.

  • Примечание: Управление сертификатами может быть добавлено позже в эту роль.
    Пока вам нужно предоставить сертификаты вручную (размещенные в /etc/mysql/ssl/{INSTANCE_KEY}/[ca|cert|key].pem)

  • Примечание: Вы должны предоставить привилегии mysql-user ТОЧНО так, как они возвращаются командой SHOW GRANT!

  • Совет: Если вы явно монтируете datadir - вам следует установить некоторые параметры монтирования для оптимизации производительности:

    • noatime,nodiratime

  • Внимание: Подключения по TCP/IP к localhost/127.0.0.1 не будут работать по умолчанию, когда включен 'skip-name-resolve'!

    Это вызовет ошибку: Host '127.0.0.1' не имеет разрешения подключаться к этому серверу MariaDB

Пример

Конфигурация

mariadb:
  instances:
    guydb:
      root_pwd: !vault ...

      dbs:
        nice:
        memes:

      users:
        django:
          priv: 'backup.creds.defaults_file is not nonmemes.*:ALL'
          pwd: !vault ...
        backup:
          priv: '*.*:SELECT,RELOAD,PROCESS,LOCK TABLES,BINLOG MONITOR,SHOW VIEW,EVENT,TRIGGER'
          pwd: !vault ...

Результат:

# конфигурационные директории
guy@ansible:~# tree /etc/mysql
> /etc/mysql/
> ├── conf.d
> │   ├── mysql.cnf
> │   └── mysqldump.cnf
> ├── debian.cnf
> ├── debian-start  # скрипт запуска по умолчанию
> ├── debian-start-instance.sh  # скрипт запуска мульти-инстанс
> ├── instance.conf.d  # конфигурации инстансов
> │   ├── client_guydb_startup-checks.cnf  # данные для входа в сервис-пользователя проверки старта
> │   └── server_guydb.cnf  # конфигурация сервера инстанса
> ├── mariadb.cnf  # конфигурация инстанса по умолчанию
> ├── mariadb.conf.d
> ├── my.cnf -> /etc/alternatives/my.cnf
> └── my.cnf.fallback

# директории данных
guy@ansible:~# tree /var/lib/mysql
> /var/lib/mysql/
> ├── default
> │  └── ...  # инстанс по умолчанию
> │
> ├── instance_guydb
> │  └── ...  # настроенный инстанс
> │
> └── ...  # файлы по умолчанию => не очищаются автоматически

# конфигурационный файл инстанса
guy@ansible:~# cat /etc/mysql/instance.conf.d/server_guydb.cnf 
> # Управляется Ansible
> [mysqld]
> datadir = /var/lib/mysql/instance_guydb
> basedir = /usr
> pid-file = /run/mysqld/mysqld_guydb.pid
> socket = /run/mysqld/mysqld_guydb.sock
> lc_messages_dir = /usr/share/mysql
> 
> # настройки
> user = mysql
> group = mysql
> bind_address = 127.0.0.1
> port = 3306
> log_warnings = 2
> character-set-server = utf8mb4
> collation-server = utf8mb4_general_ci
> innodb_file_per_table = 1
> innodb_buffer_pool_size = 512M
> innodb_log_file_size = 1GB
> max_allowed_packet = 512M
> max_connections = 500
> query_cache_size = 64M
> tmp_table_size = 64M
> max_heap_table_size = 64M
> slow-query-log = 1
> slow-query-log-file = slow-queries.log
> long_query_time = 1
> wait_timeout = 60
> symbolic-links = 0
> local-infile = 0
> open_files_limit = 1048576

# конфигурация службы
guy@ansible:~# cat /etc/systemd/system/[email protected]/override.conf 
> # Управляется Ansible
> 
> [Unit]
> ConditionPathExists=/etc/mysql/instance.conf.d/server_%I.cnf
> ConditionPathExists=/etc/mysql/debian-start-instance.sh
> ConditionPathExists=/etc/mysql/instance.conf.d/client_%I_startup-checks.cnf
> Documentation=https://github.com/ansibleguy/infra_mariadb
> 
> [Service]
> Environment='MYSQLD_MULTI_INSTANCE=--defaults-file=/etc/mysql/instance.conf.d/server_%I.cnf --defaults-group-suffix=.%I'
> ExecStartPost=
> ExecStartPost=/etc/mysql/debian-start-instance.sh %I
> 
> LimitNOFILE=1048576
> StandardOutput=journal
> StandardError=journal
> SyslogIdentifier=mariadb_%I
> TimeoutStartSec=900
> TimeoutStopSec=900
> Restart=on-abort
> RestartSec=5s
> OOMScoreAdjust=-600
> BlockIOWeight=1000

# статус службы
guy@ansible:~# systemctl status [email protected] 
> ● [email protected] - Сервер базы данных MariaDB 10.5.12 (мульти-инстанс guydb)
>      Loaded: loaded (/lib/systemd/system/[email protected]; enabled; vendor preset: enabled)
>     Drop-In: /etc/systemd/system/[email protected]
>              └─override.conf
>      Active: active (running)
>        Docs: man:mariadbd(8)
>              https://mariadb.com/kb/en/library/systemd/
>              https://github.com/ansibleguy/infra_mariadb
>     Process: 134872 ExecStartPre=/usr/bin/mysql_install_db $MYSQLD_MULTI_INSTANCE (code=exited, status=0/SUCCESS)
>     Process: 134910 ExecStartPost=/etc/mysql/debian-start-instance.sh guydb (code=exited, status=0/SUCCESS)
>      Status: "Теперь принимаю SQL-запросы..."
>      CGroup: /system.slice/system-mariadb.slice/[email protected]
>              └─134898 /usr/sbin/mariadbd --defaults-file=/etc/mysql/instance.conf.d/server_guydb.cnf --defaults-group-suffix=.guydb

# базы данных
guy@ansible:~# mysql --socket=/run/mysql/mysqld_guydb.sock -p -e "show databases;"
> +--------------------+
> | База данных        |
> +--------------------+
> | nice               |
> | memes              |
> | information_schema |
> | mysql              |
> | performance_schema |
> +--------------------+

# пользователи mysql
guy@ansible:~# mysql --socket=/run/mysql/mysqld_guydb.sock -p -e "select user, host from mysql.user;"
> +------------------------+-----------+
> | Пользователь           | Хост      |
> +------------------------+-----------+
> | backup                 | localhost |
> | django                 | localhost |
> | mariadb.sys            | localhost |
> | mariadb_startup_checks | localhost |  # необходимый сервис-пользователь для скрипта запуска
> | mysql                  | localhost |
> | root                   | localhost |
> +------------------------+-----------+

# привилегии mysql
guy@ansible:~# mysql --socket=/run/mysql/mysqld_guydb.sock -p -e "show grants for django@localhost;"
> +---------------------------------------------------------------------------+
> | Привилегии для django@localhost                                           |
> +---------------------------------------------------------------------------+
> | GRANT USAGE ON *.* TO `django`@`localhost` IDENTIFIED BY PASSWORD 'XXXX'  |
> | GRANT ALL PRIVILEGES ON `memes`.* TO `django`@`localhost`                 |
> +---------------------------------------------------------------------------+

guy@ansible:~# mysql --socket=/run/mysql/mysqld_guydb.sock -p -e "show grants for backup@localhost;"
> +------------------------------------------------------------------------------------------------+
> | Привилегии для backup@localhost                                                                  |
> +------------------------------------------------------------------------------------------------+
> | GRANT SELECT, RELOAD, PROCESS, LOCK TABLES, BINLOG MONITOR, SHOW VIEW, EVENT, TRIGGER ON *.*   |
> | TO `backup`@`localhost` IDENTIFIED BY PASSWORD 'XXXX'                                          |
> +------------------------------------------------------------------------------------------------+
О проекте

Role to deploy one or multiple MariaDB instances on a linux server

role mariadb sql database
Установить
ansible-galaxy install ansibleguy/infra_mariadb
GitHub репозиторий
2 звезд(ы)
0 форк(ов)
0 открытых задач
Лицензия
other
Загрузки
4201
Владелец
AnsibleGuy
[email protected] | GPG: https://badges.ansibleguy.net/public.gpg