Rola Ansible PostMaster

To jest rola Ansible, która wdraża aplikację webową PostMaster napisaną przez StackFocus.

Wymagania

Ta rola wymaga wersji 2.4.2 roli Ansible geerlingguy.mysql. Jeśli instalujesz tę rolę przez Ansible Galaxy, geerlingguy.mysql powinno zainstalować się automatycznie. Zauważ, że rola geerlingguy.mysql jest używana tylko wtedy, gdy zmienna postmaster_install_mysql jest ustawiona na True.

Ta rola musi być uruchamiana z uprawnieniami sudo lub jako root, w przeciwnym razie rola zakończy się niepowodzeniem.

Zmienne roli:

• postmaster_db_user - użytkownik MySQL, z którym PostMaster ma się łączyć.
• postmaster_db_password - hasło użytkownika MySQL.
• postmaster_db_host - nazwa hosta lub adres IP serwera MySQL. Domyślnie to localhost.
• postmaster_db_port - port, na którym nasłuchuje serwer MySQL. Domyślnie to 3306.
• postmaster_db_name - nazwa bazy danych MySQL. Domyślnie to servermail.
• postmaster_secret_key - klucz sekretu Flask, który będzie używany przez PostMaster (powinien to być losowy ciąg znaków).
• postmaster_migrate_db - decyduje, czy migrować/aktualizować bazę danych PostMaster. Domyślnie to True.
• postmaster_install_mysql - decyduje, czy zainstalować MySQL za pomocą roli geerlingguy.mysql. Przeczytaj dokumentację tej roli, aby znaleźć potrzebne opcje konfiguracyjne dla MySQL. Domyślnie to False.
• postmaster_apache_vhost_extra_settings - przyjmuje wieloliniowy ciąg zawierający dodatkowe ustawienia Apache, które powinny mieć zastosowanie do VirtualHost PostMaster. Nie jest ustawione domyślnie.
• postmaster_apache_port - port, na którym nasłuchuje VirtualHost PostMaster.
• postmaster_apache_ssl_cert - ścieżka na docelowym węźle do certyfikatu SSL, który ma być używany w VirtualHost PostMaster. Jeśli nie jest ustawione, VirtualHost nie będzie używał SSL.
• postmaster_apache_ssl_key - ścieżka na docelowym węźle do klucza SSL, który ma być używany w VirtualHost PostMaster. Jeśli nie jest ustawione, VirtualHost nie będzie używał SSL.
• postmaster_apache_ssl_chain - ścieżka na docelowym węźle do łańcucha certyfikatów SSL, który ma być używany w VirtualHost PostMaster. Nie jest wymagane podczas konfigurowania SSL, ale jest wymagane, jeśli zdefiniowano postmaster_apache_ssl_local_chain.
• postmaster_apache_ssl_local_cert - lokalna ścieżka do certyfikatu SSL, który ma być skopiowany do ścieżki zdefiniowanej w postmaster_apache_ssl_cert. Nie jest wymagane.
• postmaster_apache_ssl_local_key - lokalna ścieżka do klucza SSL, który ma być skopiowany do ścieżki zdefiniowanej w postmaster_apache_ssl_key. Nie jest wymagane.
• postmaster_apache_ssl_local_chain - lokalna ścieżka do łańcucha certyfikatów SSL, który ma być skopiowany do ścieżki zdefiniowanej w postmaster_apache_ssl_chain. Nie jest wymagane.
• postmaster_apache_ssl_cipher_suite - zestaw szyfrów SSL, które VirtualHost PostMaster będzie akceptował. Domyślnie to AES256+EECDH:AES256+EDH.
• postmaster_apache_ssl_protocol - protokoły SSL, które VirtualHost PostMaster będzie akceptował. Domyślnie to All -SSLv2 -SSLv3.
• postmaster_clean_virtualenv - usuwa i tworzy na nowo środowisko wirtualne PostMaster. Jest to przydatne między aktualizacjami do usunięcia starych, nieużywanych zależności Pythona. Domyślnie to False.

Przykład Playbooka:

- name: Wdróż 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