Rol de Ansible PostMaster

Esta es una rol de Ansible que despliega la aplicación web PostMaster escrita por StackFocus.

Requisitos

Este rol requiere la versión 2.4.2 del rol de Ansible geerlingguy.mysql.
Si estás instalando este rol a través de Ansible Galaxy, geerlingguy.mysql se instalará automáticamente para ti.
Ten en cuenta que el rol geerlingguy.mysql solo se utiliza cuando la variable postmaster_install_mysql está configurada como True.

Este rol debe ejecutarse con sudo o como root, de lo contrario, fallará.

Variables del Rol:

• postmaster_db_user - el usuario de MySQL con el que PostMaster se conectará.
• postmaster_db_password - la contraseña del usuario de MySQL.
• postmaster_db_host - el nombre del host o la dirección IP del servidor MySQL. Por defecto es localhost.
• postmaster_db_port - el puerto en el que escucha el servidor MySQL. Por defecto es 3306.
• postmaster_db_name - el nombre de la base de datos de MySQL. Por defecto es servermail.
• postmaster_secret_key - la clave secreta de Flask que usará PostMaster (debe ser una cadena aleatoria de caracteres).
• postmaster_migrate_db - determina si se debe migrar/actualizar la base de datos de PostMaster. Por defecto es True.
• postmaster_install_mysql - determina si se debe instalar MySQL utilizando el rol geerlingguy.mysql.
  Lee la documentación de ese rol para conocer las opciones de configuración necesarias para MySQL. Por defecto es False.
• postmaster_apache_vhost_extra_settings - acepta una cadena de múltiples líneas que contiene cualquier configuración de Apache que deba aplicarse al VirtualHost de PostMaster. No está configurado por defecto.
• postmaster_apache_port - el puerto en el que escucha el VirtualHost de PostMaster.
• postmaster_apache_ssl_cert - la ruta en el nodo de destino al certificado SSL que se utilizará en el VirtualHost de PostMaster.
  Si no está configurado, el VirtualHost no usará SSL.
• postmaster_apache_ssl_key - la ruta en el nodo de destino a la clave SSL que se utilizará en el VirtualHost de PostMaster.
  Si no está configurado, el VirtualHost no usará SSL.
• postmaster_apache_ssl_chain - la ruta en el nodo de destino a la cadena de certificados SSL que se utilizará en el VirtualHost de PostMaster.
  No es obligatorio al configurar SSL, pero es necesario si se define postmaster_apache_ssl_local_chain.
• postmaster_apache_ssl_local_cert - la ruta local al certificado SSL que se copiará a la ruta definida en postmaster_apache_ssl_cert.
  No es necesario.
• postmaster_apache_ssl_local_key - la ruta local a la clave SSL que se copiará a la ruta definida en postmaster_apache_ssl_key.
  No es necesario.
• postmaster_apache_ssl_local_chain - la ruta local a la cadena de certificados SSL que se copiará a la ruta definida en postmaster_apache_ssl_chain.
  No es necesario.
• postmaster_apache_ssl_cipher_suite - la suite de cifrado SSL que el VirtualHost de PostMaster permitirá. Por defecto es AES256+EECDH:AES256+EDH.
• postmaster_apache_ssl_protocol - los protocolos SSL que el VirtualHost de PostMaster permitirá. Por defecto es All -SSLv2 -SSLv3.
• postmaster_clean_virtualenv - eliminar y recrear el virtualenv de PostMaster. Esto es útil entre actualizaciones para eliminar dependencias de Python antiguas y que ya no se utilizan.
  Por defecto es False.

Ejemplo de Playbook:

- name: Desplegar 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