PostMaster Ansible Rolle

Dies ist eine Ansible Rolle, die die Webanwendung PostMaster bereitstellt, die von StackFocus entwickelt wurde.

Voraussetzungen

Diese Rolle benötigt die Version 2.4.2 der Ansible Rolle geerlingguy.mysql. Wenn Sie diese Rolle über Ansible Galaxy installieren, wird geerlingguy.mysql automatisch für Sie installiert. Beachten Sie, dass die Rolle geerlingguy.mysql nur verwendet wird, wenn die Variable postmaster_install_mysql auf True gesetzt ist.

Diese Rolle muss mit sudo oder als root ausgeführt werden, andernfalls wird die Rolle fehlschlagen.

Rollenvariablen:

• postmaster_db_user - der MySQL-Benutzer, mit dem sich PostMaster verbindet.
• postmaster_db_password - das Passwort des MySQL-Benutzers.
• postmaster_db_host - der Hostname oder die IP-Adresse des MySQL-Servers. Standardmäßig ist dies localhost.
• postmaster_db_port - der Port, auf dem der MySQL-Server lauscht. Standardmäßig ist dies 3306.
• postmaster_db_name - der Name der MySQL-Datenbank. Standardmäßig ist dies servermail.
• postmaster_secret_key - der Flask-Geheimschlüssel, den PostMaster verwenden wird (dies sollte eine zufällige Zeichenkette sein).
• postmaster_migrate_db - bestimmt, ob die PostMaster-Datenbank migriert/aktualisiert werden soll. Standardmäßig ist dies True.
• postmaster_install_mysql - bestimmt, ob MySQL mit der Rolle geerlingguy.mysql installiert werden soll. Lesen Sie die Dokumentation dieser Rolle, um die benötigten Konfigurationsoptionen für MySQL zu erfahren. Standardmäßig ist dies False.
• postmaster_apache_vhost_extra_settings - hier kann eine mehrzeilige Zeichenkette eingegeben werden, die alle Apache-Einstellungen enthält, die für den PostMaster VirtualHost gelten sollen. Standardmäßig nicht gesetzt.
• postmaster_apache_port - der Port, auf dem der PostMaster-VirtualHost lauscht.
• postmaster_apache_ssl_cert - der Pfad auf dem Zielknoten zum SSL-Zertifikat, das für den PostMaster-VirtualHost verwendet werden soll. Wenn dies nicht gesetzt ist, wird der VirtualHost kein SSL verwenden.
• postmaster_apache_ssl_key - der Pfad auf dem Zielknoten zum SSL-Schlüssel, der für den PostMaster-VirtualHost verwendet werden soll. Wenn dies nicht gesetzt ist, wird der VirtualHost kein SSL verwenden.
• postmaster_apache_ssl_chain - der Pfad auf dem Zielknoten zur SSL-Zertifikatkette, die für den PostMaster-VirtualHost verwendet werden soll. Dies ist nicht erforderlich, wenn SSL konfiguriert wird, aber erforderlich, wenn postmaster_apache_ssl_local_chain definiert ist.
• postmaster_apache_ssl_local_cert - der lokale Pfad zum SSL-Zertifikat, das an den in postmaster_apache_ssl_cert definierten Pfad kopiert werden soll. Dies ist nicht erforderlich.
• postmaster_apache_ssl_local_key - der lokale Pfad zum SSL-Schlüssel, der an den in postmaster_apache_ssl_key definierten Pfad kopiert werden soll. Dies ist nicht erforderlich.
• postmaster_apache_ssl_local_chain - der lokale Pfad zur SSL-Zertifikatkette, die an den in postmaster_apache_ssl_chain definierten Pfad kopiert werden soll. Dies ist nicht erforderlich.
• postmaster_apache_ssl_cipher_suite - die SSL-Verschlüsselungssuite, die der PostMaster-VirtualHost zulassen wird. Standardmäßig ist dies AES256+EECDH:AES256+EDH.
• postmaster_apache_ssl_protocol - die SSL-Protokolle, die der PostMaster-VirtualHost zulassen wird. Standardmäßig ist dies All -SSLv2 -SSLv3.
• postmaster_clean_virtualenv - löscht und erstellt die PostMaster-virtualenv neu. Dies ist nützlich zwischen Upgrades, um alte und nicht mehr verwendete Python-Abhängigkeiten zu löschen. Standardmäßig ist dies False.

Beispiel-Playbook:

- name: PostMaster bereitstellen
  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