Rôle Ansible PostMaster

C'est un rôle Ansible qui déploie l'application web PostMaster écrite par StackFocus.

Exigences

Ce rôle nécessite la version 2.4.2 du rôle Ansible geerlingguy.mysql. Si vous installez ce rôle via Ansible Galaxy, geerlingguy.mysql devrait être installé automatiquement pour vous. Notez que le rôle geerlingguy.mysql n'est utilisé que lorsque la variable postmaster_install_mysql est définie sur True.

Ce rôle doit être exécuté avec sudo ou en tant que root, sinon il échouera.

Variables du Rôle :

• postmaster_db_user - l'utilisateur MySQL que PostMaster utilisera pour se connecter.
• postmaster_db_password - le mot de passe de l'utilisateur MySQL.
• postmaster_db_host - le nom d'hôte ou l'adresse IP du serveur MySQL. Par défaut, il s'agit de localhost.
• postmaster_db_port - le port sur lequel le serveur MySQL écoute. Par défaut, c'est 3306.
• postmaster_db_name - le nom de la base de données MySQL. Par défaut, c'est servermail.
• postmaster_secret_key - la clé secrète Flask que PostMaster utilisera (cela doit être une chaîne de caractères aléatoire).
• postmaster_migrate_db - détermine s'il faut migrer/mettre à jour la base de données PostMaster. Par défaut, c'est True.
• postmaster_install_mysql - détermine s'il faut installer MySQL en utilisant le rôle geerlingguy.mysql. Lisez la documentation de ce rôle pour découvrir les options de configuration nécessaires pour MySQL. Par défaut, c'est False.
• postmaster_apache_vhost_extra_settings - cela accepte une chaîne multi-lignes contenant des configurations Apache qui doivent s'appliquer à l'hôte virtuel PostMaster. Cela n'est pas défini par défaut.
• postmaster_apache_port - le port sur lequel l'hôte virtuel PostMaster écoute.
• postmaster_apache_ssl_cert - le chemin sur le nœud cible vers le certificat SSL à utiliser sur l'hôte virtuel PostMaster. Si cela n'est pas défini, l'hôte virtuel n'utilisera pas SSL.
• postmaster_apache_ssl_key - le chemin sur le nœud cible vers la clé SSL à utiliser sur l'hôte virtuel PostMaster. Si cela n'est pas défini, l'hôte virtuel n'utilisera pas SSL.
• postmaster_apache_ssl_chain - le chemin sur le nœud cible vers la chaîne de certificats SSL à utiliser sur l'hôte virtuel PostMaster. Cela n'est pas requis lors de la configuration de SSL, mais c'est nécessaire si postmaster_apache_ssl_local_chain est défini.
• postmaster_apache_ssl_local_cert - le chemin local vers le certificat SSL à copier vers le chemin défini dans postmaster_apache_ssl_cert. Cela n'est pas requis.
• postmaster_apache_ssl_local_key - le chemin local vers la clé SSL à copier vers le chemin défini dans postmaster_apache_ssl_key. Cela n'est pas requis.
• postmaster_apache_ssl_local_chain - le chemin local vers la chaîne de certificats SSL à copier vers le chemin défini dans postmaster_apache_ssl_chain. Cela n'est pas requis.
• postmaster_apache_ssl_cipher_suite - la suite de chiffrement SSL que l'hôte virtuel PostMaster autorisera. Par défaut, c'est AES256+EECDH:AES256+EDH.
• postmaster_apache_ssl_protocol - les protocoles SSL que l'hôte virtuel PostMaster autorisera. Par défaut, c'est All -SSLv2 -SSLv3.
• postmaster_clean_virtualenv - supprimer et recréer l'environnement virtuel PostMaster. Ceci est utile entre les mises à jour pour supprimer les anciennes dépendances Python inutilisées. Par défaut, c'est False.

Exemple de Playbook :

- name: Déployer 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