proxysql

---

В настоящее время эта роль совместима с ProxySQL >= v2.0.1, если вы используете RHEL 8. Если вы хотите установить серию ProxySQL 1.4.x, вам понадобится использовать RHEL 7 или ниже.

Эта роль совместима только с Ansible 2.7.9 или выше из-за ошибки в миграции с MySQLdb на PyMySQL (#40123) в модуле MySQL.

Релиз 0.3.0 совместим с Ansible 2.7.0 или ниже.

---

Эта роль устанавливает и настраивает ProxySQL - высокопроизводительный, высокодоступный прокси-сервер с учетом протоколов для MySQL.

Начиная с версии 2.3.0, Ansible предоставляет модуль для настройки ProxySQL самостоятельно. Эта роль Ansible использует эту функциональность и добавляет некоторые (надеемся полезные) функции:

• Автоматическая установка для различных операционных систем
• (Пред)генерация proxysql.cnf
• Управление ProxySQL-Cluster (с помощью кастомного модуля который добавляет функциональность для настройки серверов ProxySQL)
• Различение между динамическими и статическими global_variables - перезапуск ProxySQL, если это необходимо

Пожалуйста, также ознакомьтесь с разделом "Известные проблемы или: Полезно знать" в документе.

Требования

Эта роль требует Ansible 2.5.0 или выше.

Вы можете просто использовать pip для установки (и определения) стабильной версии:

pip install ansible==2.7.9

Все требования к платформе перечислены в файле метаданных.

Установка

ansible-galaxy install vdzhorov.proxysql

Переменные роли

Переменные, которые можно передать этой роли. Для всех переменных обратите внимание на defaults/main.yml.

# Включить / отключить ProxySQL как сервис.
# Тип: Bool
proxysql_service_enabled: True

# Перезапустить ProxySQL, если статические переменные изменятся. Для списка статических
# переменных посмотрите `proxysql_non_dynamic_variables` в `vars/main.yml`.
# Тип: Bool
proxysql_restart_on_static_variables_change: True

# Репозиторий

# Если оба, `proxysql_use_official_repo` и `proxysql_use_percona_repo`, установлены
# в `False`, модуль автоматически загрузит определенную
# `proxysql_version` как пакет с Github и установит его.

# Использовать официальный репозиторий ProxySQL.
# Тип: Bool
proxysql_use_official_repo: True

# Использовать репозиторий Percona.
# Тип: Bool
proxysql_use_percona_repo: False

# Определите версию репозитория для репозитория Percona.
# Тип: Str
proxysql_percona_release: latest

# Версия ProxySQL, которая должна быть установлена, если не используется репозиторий ProxySQL.
# Тип: Int
proxysql_version: 1.4.15

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

# Путь, где ProxySQL должен сохранять свою базу данных и логи.
# Тип: Str
proxysql_datadir: /var/lib/proxysql

# Определите шаблон proxysql.cnf
# Тип: Str
proxysql_proxysql_cnf_template: proxysql.cnf.j2

# Определите шаблон proxysql-admin.cnf
# Тип: Str
proxysql_proxysql_admin_cnf_template: proxysql-admin.cnf.j2

# Переменные входа для настройки самого ProxySQL. Они просто
# используются внутри файла `main.yml` и здесь для упрощения конфигурации.
# Тип: Str
proxysql_login_admin_host: 127.0.0.1
proxysql_login_admin_password: admin
proxysql_login_admin_port: 6032
proxysql_login_admin_user: admin

# Глобальные переменные
# `admin_variables` в `proxysql_global_variables_kv`: содержит глобальные
# переменные, которые контролируют функциональность администраторского интерфейса.
# `admin_variables` имеют префикс `admin-`.
# `mysql_variables`: в `proxysql_global_variables_kv` содержат глобальные
# переменные, которые контролируют функциональность для обработки входящего
# MySQL-трафика.
# `mysql_variables` имеют префикс `mysql-`.

# Переменные должны быть либо строкой, либо целым числом. Вы должны отметить
# логическое значение как строку, например, "True" или "False".

# Для полного справочника посмотрите на:
# https://github.com/sysown/proxysql/wiki/Global-variables

# Формат:
# Тип: Dict
# proxysql_global_variables:
#   load_to_runtime: "True"
#   save_to_disk: "True"
#   login_host: "{{ proxysql_login_admin_host }}"
#   login_password: "{{ proxysql_login_admin_password }}"
#   login_port: "{{ proxysql_login_admin_port }}"
#   login_user: "{{ proxysql_login_admin_user }}"
proxysql_global_variables:
  login_host: "{{ proxysql_login_admin_host }}"
  login_password: "{{ proxysql_login_admin_password }}"
  login_port: "{{ proxysql_login_admin_port }}"
  login_user: "{{ proxysql_login_admin_user }}"
# Формат:
# Тип: Dict
# proxysql_global_variables_kv:
#   key: value
# например:
# proxysql_global_variables_kv:
#   admin-admin_credentials: "{{ proxysql_login_admin_user }}:{{ proxysql_login_admin_password }}"
#   admin-mysql_ifaces: "{{ proxysql_login_admin_host }}:{{ proxysql_login_admin_port }}"
#   mysql-interfaces: 0.0.0.0:6033
#   mysql-commands_stats: "True"
#   mysql-threads: 4
proxysql_global_variables_kv: {}

# Серверы бэкенда
# `proxysql_backend_servers`: содержит строки для таблицы mysql_servers из
# администраторского интерфейса. В основном, они определяют серверы бэкенда, к которым
# будет направлен входящий MySQL-трафик.

# Для полного справочника смотрите на:
# https://docs.ansible.com/ansible/latest/modules/proxysql_backend_servers_module.html
# Важно: этот модуль использует `hostgroup` (что является правильным названием в базе
# данных) вместо `hostgroup_id` (что является значением по умолчанию в модуле Ansible)!

# Формат:
# Тип: Dict
# proxysql_backend_servers:
#   mysql-srv1-hg1:
#     comment: mysql-srv1-hg1
#     hostgroup: 1
#     hostname: 172.16.77.101
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     max_connections: 1000
#     max_replication_lag: 0
#     status: ONLINE
#     weight: 1
#   mysql-srv1-hg2:
#     comment: mysql-srv1-hg2
#     hostgroup: 2
#     hostname: 172.16.77.101
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     max_connections: 1000
#     max_replication_lag: 0
#     status: ONLINE
#     weight: 1
proxysql_backend_servers: {}

# Сервера ProxySQL
# `proxysql_proxysql_servers`: содержит строки для таблицы proxysql_servers
# из администраторского интерфейса. В основном, они определяют серверы ProxySQL,
# которые используются для кластеризации.

# Для полного справочника смотрите на:
# `library/proxysql_proxysql_servers.py`, поскольку это не является частью
# официального пакета Ansible.

# Формат:
# Тип: Dict
# proxysql_proxysql_servers:
#   proxysql-srv-1:
#     comment: proxysql-srv-1
#     hostname: 172.16.77.201
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     weight: 0
#   proxysql-srv-2:
#     comment: proxysql-srv-2
#     hostname: 172.16.77.202
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     weight: 0
proxysql_proxysql_servers: {}

# Группы репликации
# `proxysql_replication_hostgroups`: представляют пару writer_hostgroup
# и reader_hostgroup. ProxySQL будет отслеживать значение read_only для всех
# серверов в указанных группах, и на основе значения read_only будет назначать сервер в группы writer или reader.

# Для полного справочника смотрите на:
# https://docs.ansible.com/ansible/latest/modules/proxysql_replication_hostgroups_module.html

# Формат:
# Тип: Dict
# proxysql_replication_hostgroups:
#   Cluster:
#     comment: Cluster
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     reader_hostgroup: 2
#     writer_hostgroup: 1
proxysql_replication_hostgroups: {}

# Пользователи
# `proxysql_mysql_users`: содержит строки для таблицы mysql_users из
# администраторского интерфейса. В основном, они определяют пользователей, которые могут подключаться к прокси,
# и пользователей, с которыми прокси может подключаться к серверам бэкенда.

# Для полного справочника смотрите на:
# http://docs.ansible.com/ansible/latest/proxysql_mysql_users_module.html

# Формат:
# Тип: Dict
# proxysql_mysql_users:
#   user1:
#     active: 1
#     backend: 1
#     default_hostgroup: 1
#     fast_forward: 0
#     frontend: 1
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     max_connections: 10000
#     password: Passw0rd
#     transaction_persistent: 1
#     username: user1
#   user2:
#     active: 1
#     backend: 1
#     default_hostgroup: 2
#     fast_forward: 0
#     frontend: 1
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     max_connections: 1000
#     password: dr0wssaP
#     transaction_persistent: 1
#     username: user2
proxysql_mysql_users: {}

# Правила запросов
# `proxysql_query_rules` содержит строки для таблицы mysql_query_rules из
# администраторского интерфейса. В основном, они определяют правила, используемые для классификации и
# маршрутизации входящего MySQL-трафика в соответствии с различными критериями (соответствующие шаблоны,
# пользователь, выполняющий запрос и т.д.).

# Для полного справочника смотрите на:
# http://docs.ansible.com/ansible/latest/proxysql_query_rules_module.html

# Формат:
# Тип: Dict
# proxysql_query_rules:
#   catchall:
#     active: 1
#     apply: 1
#     destination_hostgroup: 1
#     flagIN: 0
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     match_pattern: .*@.*
#     negate_match_pattern: 0
#     rule_id: 1
#   selectforupdate:
#     active: 1
#     apply: 1
#     destination_hostgroup: 1
#     flagIN: 0
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     match_pattern: ^SELECT.*FOR UPDATE
#     negate_match_pattern: 0
#     rule_id: 2
#   select:
#     active: 1
#     apply: 0
#     destination_hostgroup: 2
#     flagIN: 0
#     login_host: "{{ proxysql_login_admin_host }}"
#     login_password: "{{ proxysql_login_admin_password }}"
#     login_port: "{{ proxysql_login_admin_port }}"
#     login_user: "{{ proxysql_login_admin_user }}"
#     match_pattern: ^SELECT.*
#     negate_match_pattern: 0
#     rule_id: 3
proxysql_query_rules: {}

# Инструмент администрации Percona ProxySQL
# Решение ProxySQL Admin (proxysql-admin) настраивает узлы кластера Percona
# XtraDB в ProxySQL.

# Для полного справочника смотрите на:
# https://github.com/percona/proxysql-admin-tool

# Формат:
# Тип: Dict
# proxysql_percona_admin_tool:
#   PROXYSQL_DATADIR: "{{ proxysql_datadir }}"
#   PROXYSQL_USERNAME: "{{ proxysql_login_admin_user }}"
#   PROXYSQL_PASSWORD: "{{ proxysql_login_admin_password }}"
#   PROXYSQL_HOSTNAME: "{{ proxysql_login_admin_host }}"
#   PROXYSQL_PORT: "{{ proxysql_login_admin_port }}"
#   CLUSTER_USERNAME: admin
#   CLUSTER_PASSWORD: admin
#   CLUSTER_HOSTNAME: localhost
#   CLUSTER_PORT: 3306
#   MONITOR_USERNAME: monitor
#   MONITOR_PASSWORD: monit0r
#   CLUSTER_APP_USERNAME: proxysql_user
#   CLUSTER_APP_PASSWORD: passw0rd
#   WRITE_HOSTGROUP_ID: 10
#   READ_HOSTGROUP_ID: 11
#   MODE: singlewrite
proxysql_percona_admin_tool:
  PROXYSQL_DATADIR: "{{ proxysql_datadir }}"
  PROXYSQL_USERNAME: "{{ proxysql_login_admin_user }}"
  PROXYSQL_PASSWORD: "{{ proxysql_login_admin_password }}"
  PROXYSQL_HOSTNAME: "{{ proxysql_login_admin_host }}"
  PROXYSQL_PORT: "{{ proxysql_login_admin_port }}"

Примеры

1) Полный пример конфигурации

Здесь вы можете увидеть полный пример конфигурации ProxySQL. В этом случае роль загрузит пакет 1.4.15 напрямую и не будет использовать репозиторий (proxysql_use_official_repo установлен в False).

Это в основном (с небольшими изменениями) файл test.yml, который используется для тестирования.

- hosts: proxysql
  gather_facts: True
  vars:
    proxysql_version: 1.4.15
    proxysql_service_enabled: True
    proxysql_use_official_repo: True
    proxysql_login_admin_host: 127.0.0.1
    proxysql_login_admin_password: admin
    proxysql_login_admin_port: 6032
    proxysql_login_admin_user: admin
    proxysql_global_variables:
      login_host: "{{ proxysql_login_admin_host }}"
      login_password: "{{ proxysql_login_admin_password }}"
      login_port: "{{ proxysql_login_admin_port }}"
      login_user: "{{ proxysql_login_admin_user }}"
    proxysql_global_variables_kv:
      admin-admin_credentials: "{{ proxysql_login_admin_user }}:{{ proxysql_login_admin_password }}"
      admin-mysql_ifaces: "{{ proxysql_login_admin_host }}:{{ proxysql_login_admin_port }}"
      mysql-commands_stats: "True"
      mysql-connect_retries_on_failure: 10
      mysql-connect_timeout_server: 3000
      mysql-default_charset: utf8
      mysql-default_query_delay: 0
      mysql-default_query_timeout: 300000
      mysql-default_schema: information_schema
      mysql-interfaces: 127.0.0.1:6033
      mysql-max_connections: 8192
      mysql-monitor_read_only_interval: 1500
      mysql-monitor_read_only_timeout: 500
      mysql-ping_timeout_server: 500
      mysql-poll_timeout: 2000
      mysql-query_retries_on_failure: 1
      mysql-sessions_sort: "True"
      mysql-threads: 4
    proxysql_backend_servers:
      mysql-srv1-hg1:
        comment: mysql-srv1-hg1
        hostgroup: 1
        hostname: 172.16.77.101
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 1000
        max_replication_lag: 0
        status: ONLINE
        weight: 1
      mysql-srv1-hg2:
        comment: mysql-srv1-hg2
        hostgroup: 2
        hostname: 172.16.77.101
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 1000
        max_replication_lag: 0
        status: ONLINE
        weight: 1
      mysql-srv2-hg2:
        comment: mysql-srv2-hg2
        hostgroup: 2
        hostname: 172.16.77.102
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 2000
        max_replication_lag: 5
        status: ONLINE
        weight: 1
      mysql-srv3-hg2:
        comment: mysql-srv3-hg2
        hostgroup: 2
        hostname: 172.16.77.103
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 2000
        max_replication_lag: 5
        status: OFFLINE_HARD
        weight: 1
    proxysql_proxysql_servers:
      proxysql-srv-1:
        comment: proxysql-srv-1
        hostname: 172.16.77.201
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        port: 6032
        weight: 0
      proxysql-srv-2:
        comment: proxysql-srv-2
        hostname: 172.16.77.202
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        port: 6032
        weight: 0
    proxysql_replication_hostgroups:
      Cluster:
        comment: Cluster
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        reader_hostgroup: 2
        writer_hostgroup: 1
    proxysql_mysql_users:
      user1:
        active: 1
        backend: 1
        default_hostgroup: 1
        fast_forward: 0
        frontend: 1
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 10000
        password: Passw0rd
        transaction_persistent: 1
        username: user1
      user2:
        active: 1
        backend: 1
        default_hostgroup: 1
        fast_forward: 0
        frontend: 1
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        max_connections: 1000
        password: dr0wssaP
        transaction_persistent: 1
        username: user2
    proxysql_query_rules:
      catchall:
        active: 1
        apply: 1
        destination_hostgroup: 1
        flagIN: 0
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        match_pattern: .*@.*
        negate_match_pattern: 0
        rule_id: 1
      selectforupdate:
        active: 1
        apply: 1
        destination_hostgroup: 1
        flagIN: 0
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        match_pattern: ^SELECT.*FOR UPDATE
        negate_match_pattern: 0
        rule_id: 2
      select:
        active: 1
        apply: 0
        destination_hostgroup: 2
        flagIN: 0
        login_host: "{{ proxysql_login_admin_host }}"
        login_password: "{{ proxysql_login_admin_password }}"
        login_port: "{{ proxysql_login_admin_port }}"
        login_user: "{{ proxysql_login_admin_user }}"
        match_pattern: ^SELECT.*
        negate_match_pattern: 0
        rule_id: 3
  roles:
    - timorunge.proxysql

2) Установка из официального репозитория

Используйте репозиторий ProxySQL (proxysql_use_official_repo установлен в True). ProxySQL сам не предоставляет пакеты в репозитории для Ubuntu > 16.04.

Просто установите proxysql_use_official_repo в False для более новых версий Ubuntu или используйте репозиторий Percona.

Обратите внимание на раздел тестирования для покрытия официального репозитория.

- hosts: proxysql
  vars:
    proxysql_use_official_repo: True
    proxysql_use_percona_repo: False
    proxysql_login_admin_host: 127.0.0.1
    proxysql_login_admin_password: admin
    proxysql_login_admin_port: 6032
    proxysql_login_admin_user: admin
    ...

3) Установка из репозитория Percona

Используйте репозиторий ProxySQL (proxysql_use_percona_repo установлен в True).

Обратите внимание на раздел тестирования для покрытия репозитория Percona.

- hosts: proxysql
  vars:
    proxysql_use_official_repo: False
    proxysql_use_percona_repo: True
    proxysql_login_admin_host: 127.0.0.1
    proxysql_login_admin_password: admin
    proxysql_login_admin_port: 6032
    proxysql_login_admin_user: admin
    ...

4) Установка из пакета deb или rpm

Вы можете установить ProxySQL напрямую из релиза на GitHub. Просто определите proxysql_version. Установите proxysql_use_official_repo и proxysql_use_percona_repo в False.

- hosts: proxysql
  vars:
    proxysql_version: 1.4.15
    proxysql_use_official_repo: False
    proxysql_use_percona_repo: False
    proxysql_login_admin_host: 127.0.0.1
    proxysql_login_admin_password: admin
    proxysql_login_admin_port: 6032
    proxysql_login_admin_user: admin
    ...

5) Не перезапускайте ProxySQL после изменения статической переменной

Если вы хотите перезапустить ProxySQL самостоятельно после изменения конфигурации статических переменных, вы должны установить proxysql_restart_on_static_variables_change в False.

В этом случае вы столкнетесь с известной проблемой, что не является большой проблемой. В этом случае тесты на идемпотентность потерпят неудачу.

После ручного перезапуска вам не нужно снова применять Ansible.

- hosts: proxysql
  vars:
    proxysql_use_official_repo: False
    proxysql_restart_on_static_variables_change: False
    proxysql_login_admin_host: 127.0.0.1
    proxysql_login_admin_password: admin
    proxysql_login_admin_port: 6032
    proxysql_login_admin_user: admin
    ...

Известные проблемы или: Полезно знать

1) ProxySQL > 1.4.7 на Ubuntu 16.04 (исправлено)

На Ubuntu 16.04 Ansible (версия не имеет значения) / ProxySQL > 1.4.7, похоже, имеет проблемы с корректным взаимодействием через mysql-python / python-mysqldb.

Пример ошибки:

"unable to modify server.. (1045, 'unrecognized token: \"\\'\\n  AND compression = 0\\n  AND weight = 1\\n  AND use_ssl = 0\\n  AND max_connections = 2000\\n  AND max_latency_ms = 0\\n  AND max_replication_lag = 5\"')"

Примечание:

Я провел небольшое исследование, установив mysql-python через pip на Ubuntu 16.04. Не волнуйтесь, это также не работает с python-mysqldb.

---

В библиотеке python MySQLdb метод execute (класс BaseCursor) генерирует запрос следующим образом:

query = query % tuple([db.literal(item) for item in args])

db.literal является частью класса Connection и возвращает одиночные объекты как строку, а множественные объекты как последовательность, конвертируя каждую последовательность тоже.

def literal(self, o):
  # ...
  return self.escape(o, self.encoders)

self.escape должен экранировать все специальные символы в данном объекте и использует словарь сопоставлений для предоставления функций кавычек для каждого типа. Это self.encoders, который - по умолчанию и если не установлено по-другому - использует MySQLdb.converters.

Сопоставление для строки: StringType: Thing2Literal. Таким образом, строка будет экранирована с помощью метода Thing2Literal.

def Thing2Literal(o, d):
  # ...
  return string_literal(o, d)

string_literal должен конвертировать наш строковый объект в SQL строковый литерал. Это означает, что любые специальные SQL символы экранируются, и он помещается в одинарные кавычки. Другими словами, это выполняет:

"'%s'" % escape_string(str(obj))

При экранировании строки строковые объекты удаляются и возвращают только одну кавычку (').

Поскольку в тестах не изменялось ничего, кроме версии ProxySQL, я предполагаю, что изменение в ProxySQL (разница 1.4.7 против 1.4.8) вызывает сбой Ansible. Потому что сам ProxySQL - если не вызывать через Ansible - работает идеально.

---

Наконец, но не в последнюю очередь...

Эта проблема решается установкой mysqlclient - который является форком MySQLdb - через pip.

2) Пакеты для Ubuntu > 16.04 (исправлено)

ProxySQL сам не предоставляет "актуальные" пакеты для Ubuntu > 16.04. Эта роль Ansible обходит это, скачивая релиз 16.04 для Ubuntu > 16.04 и устанавливая его (это поведение может измениться в будущем).

Существует зависимость пакета для libcrypto++6 и libssl1.0.0 начиная с Ubuntu >= 18.04 (что решается автоматически).

3) Нединые глобальные переменные

ProxySQL имеет некоторые global_variables, которые нельзя изменить во время выполнения (см. proxysql_non_dynamic_variables в vars/main.yml). Сказав это, это само по себе не является проблемой, поскольку данная роль ProxySQL заботится об этом (генерируя proxysql.cnf) и предоставляет возможность автоматически перезагружаться, если такая переменная изменится (установите proxysql_restart_on_static_variables_change в True).

Эта роль также устанавливает это значение в самой базе данных ProxySQL, и вот здесь возникает проблема:

Если вы измените больше одной статической переменной, технически, всё будет в порядке. ProxySQL перезапускается и берет новое значение из proxysql.cnf. Но только первое значение изменяется в самой базе данных.

Это не является "серьезной проблемой", поскольку реальное значение берется корректно из конфигурационного файла, но вы увидите набор изменений в следующем запуске Ansible, который будет:

• Перезапустить ProxySQL еще раз
• Тесты на идемпотентность потерпят неудачу (если вы не перезапускаете всё с нуля)

Потенциальное решение может заключаться в том, чтобы не устанавливать proxysql_non_dynamic_variables в базе данных ProxySQL.

4) Кластеризация ProxySQL

Кластеризация ProxySQL все еще экспериментальная. Цитата из документации по кластеризации: "поскольку эта функция все еще экспериментальная, таблица не загружается автоматически с диска".

Для инициализации из proxysql.cnf важно, чтобы hostname (очевидно) и port (он не принимает значение по умолчанию) были определены.

5) ProxySQL и репозиторий Percona на CentOS...

...не работают из-за проблем с зависимостями.

Технически нам нужны следующие пакеты, чтобы правильно применить Ansible:

proxysql_dependency_pkgs:
  - MySQL-python
  - mysql

С включенным репозиторием Percona зависимости пакетов для MySQL-python и mysql конфликтуют.

yum install MySQL-python
...
============================================================================================
 Пакет                     Архитектура   Версия                     Репозиторий                Размер
============================================================================================
 Установка:
  MySQL-python             x86_64        1.2.5-1.el7               base                      90 k
 Установка для зависимостей:
  Percona-Server-shared-56 x86_64        5.6.43-rel84.3.el7        percona-release-x86_64   619 k

Сводка транзакции
============================================================================================
Установить  1 Пакет (+1 Зависимый пакет)

yum install mysql
...

============================================================================================
 Пакет                               Архитектура  Версия                Репозиторий                Размер
============================================================================================
 Установка:
  Percona-Server-client-57            x86_64       5.7.24-27.1.el7      percona-release-x86_64  6.8 M
 Установка для зависимостей:
  Percona-Server-shared-57            x86_64       5.7.24-27.1.el7      percona-release-x86_64  748 k
  Percona-Server-shared-compat-57     x86_64       5.7.24-27.1.el7      percona-release-x86_64  1.2 M

Сводка транзакции
============================================================================================
Установить  1 Пакет (+2 Зависимые пакеты)

Как видите, MySQL-python зависит от Percona-Server-shared-56, в то время как mysql зависит от Percona-Server-shared-57.

Тестирование

Тесты проводятся с использованием Docker и docker_test_runner, который запускает следующие контейнеры с различными настройками окружения:

• CentOS 7
• Debian 9 (Stretch)
• Ubuntu 16.04 (Xenial Xerus)
• Ubuntu 18.04 (Bionic Beaver)

Ansible 2.7.9 установлен на всех контейнерах и используется тестовый плейбук.

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

Дистрибутив	Версия	Официальный репозиторий	Репозиторий Percona	Пакет
CentOS	7	да	нет	1.4.15
Debian	9	да	да	1.4.15
Ubuntu	16.04	да	да	1.4.15
Ubuntu	18.04	нет	да	1.4.15

# Тестирование локально:
curl https://raw.githubusercontent.com/timorunge/docker-test-runner/master/install.sh | sh
./docker_test_runner.py -f tests/docker_test_runner.yml

Поскольку время сборки на Travis ограничено для публичных репозиториев, автоматизированные тесты ограничены:

• CentOS 7
• Debian 8 (Jessie)
• Debian 9 (Stretch)
• Ubuntu 16.04 (Xenial Xerus)
• Ubuntu 18.04 (Bionic Beaver)

Зависимости

• proxysql_proxysql_servers.py который добавляется в библиотечную папку этой роли.

Лицензия

Лицензия BSD 3-Clause "New" или "Revised"

Информация об авторе

• Тимо Рунге