Роль Ansible для PostMaster

Это роль Ansible, которая разворачивает веб-приложение PostMaster, написанное StackFocus.

Требования

Эта роль требует версию 2.4.2 роли geerlingguy.mysql. Если вы устанавливаете эту роль через Ansible Galaxy, geerlingguy.mysql будет установлен автоматически. Обратите внимание, что роль geerlingguy.mysql используется только когда переменная postmaster_install_mysql установлена в True.

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

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

• postmaster_db_user - пользователь MySQL, под которым PostMaster будет подключаться.
• postmaster_db_password - пароль пользователя MySQL.
• postmaster_db_host - имя хоста или IP-адрес сервера MySQL. По умолчанию установлено localhost.
• postmaster_db_port - порт, на котором слушает сервер MySQL. По умолчанию установлено 3306.
• postmaster_db_name - имя базы данных MySQL. По умолчанию установлено servermail.
• postmaster_secret_key - секретный ключ Flask, который будет использоваться PostMaster (это должна быть случайная строка символов).
• postmaster_migrate_db - определяет, нужно ли мигрировать/обновлять базу данных PostMaster. По умолчанию установлено True.
• postmaster_install_mysql - определяет, нужно ли устанавливать MySQL с помощью роли geerlingguy.mysql. Прочитайте документацию этой роли, чтобы узнать, какие параметры конфигурации требуются для MySQL. По умолчанию установлено False.
• postmaster_apache_vhost_extra_settings - принимает многострочную строку с любыми настройками Apache, которые должны применяться к виртуальному хосту PostMaster. По умолчанию не установлено.
• postmaster_apache_port - порт, на котором слушает виртуальный хост PostMaster.
• postmaster_apache_ssl_cert - путь на целевом узле к SSL-сертификату, который будет использоваться на виртуальном хосте PostMaster. Если это не установлено, виртуальный хост не будет использовать SSL.
• postmaster_apache_ssl_key - путь на целевом узле к SSL-ключу, который будет использоваться на виртуальном хосте PostMaster. Если это не установлено, виртуальный хост не будет использовать SSL.
• postmaster_apache_ssl_chain - путь на целевом узле к цепочке SSL-сертификатов, которую будет использовать виртуальный хост PostMaster. Это не требуется при настройке SSL, но обязательно, если задан postmaster_apache_ssl_local_chain.
• postmaster_apache_ssl_local_cert - локальный путь к SSL-сертификату, который нужно скопировать на путь, указанный в postmaster_apache_ssl_cert. Это не обязательно.
• postmaster_apache_ssl_local_key - локальный путь к SSL-ключу, который нужно скопировать на путь, указанный в postmaster_apache_ssl_key. Это не обязательно.
• postmaster_apache_ssl_local_chain - локальный путь к цепочке SSL-сертификатов, которую нужно скопировать на путь, указанный в postmaster_apache_ssl_chain. Это не обязательно.
• postmaster_apache_ssl_cipher_suite - шифр SSL, который будет разрешен для виртуального хоста PostMaster. По умолчанию установлено AES256+EECDH:AES256+EDH.
• postmaster_apache_ssl_protocol - протоколы SSL, которые будут разрешены для виртуального хоста PostMaster. По умолчанию установлено Все -SSLv2 -SSLv3.
• postmaster_clean_virtualenv - удалить и заново создать виртуальное окружение PostMaster. Это полезно между обновлениями для удаления старых и больше не используемых зависимостей Python. По умолчанию установлено False.

Пример playbook:

- name: Развернуть PostMaster
  hosts: mailserver
  become: yes

  vars:
  - postmaster_db_user: postmaster_user
  - postmaster_db_password: DbUserPassword
  - postmaster_db_host: localhost
  - postmaster_db_name: servermail
  - postmaster_migrate_db: True
  - postmaster_secret_key: SuperSecretKey
  - postmaster_apache_port: 8443
  - postmaster_apache_ssl_cert: /local/path/to/postmaster.crt
  - postmaster_apache_ssl_key: /local/path/to/postmaster.key
  - postmaster_install_mysql: True
  - mysql_root_password: MySqlRootPassword
  - mysql_enabled_on_startup: yes
  - mysql_databases:
    - name: "{{ postmaster_db_name }}"
  - mysql_users:
    - name: "{{ postmaster_db_user }}"
      password: "{{ postmaster_db_password }}"
      host: localhost
      priv: "{{ postmaster_db_name }}.*:ALL"

  roles:
   - postmaster