Rola Ansible - Proxmox Mail Gateway

Rola do wdrożenia Proxmox Mail Gateway na serwerze linuxowym.

Testowane:

• Debian 11

Instalacja

# najnowsza wersja
ansible-galaxy role install git+https://github.com/ansibleguy/sw_proxmox_mail_gw

# z galaxy
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw

# lub do własnej ścieżki ról
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw --roles-path ./roles

# zainstaluj zależności
ansible-galaxy install -r requirements.yml

Wymagania wstępne

Zobacz: Wymagania wstępne

Użycie

Chcesz prosty interfejs Ansible? Sprawdź moje Ansible WebUI

Konfiguracja

Zdefiniuj konfigurację według potrzeb:

pmg:
  fqdn: 'pmg.template.ansibleguy.net'  # poprawna, publiczna nazwa DNS twojego serwera

  manage:
    webserver: true  # ustaw na false, aby wyłączyć komponent nginx

  nginx:  # skonfiguruj ustawienia serwera www => zobacz: https://github.com/ansibleguy/infra_nginx
    aliases: ['mail-gw.ansibleguy.net']  # dodatkowe domeny do dodania do certyfikatu
    ssl:
      mode: 'letsencrypt'  # lub selfsigned/ca
      #  jeśli używasz 'selfsigned' lub 'ca':
      #    cert:
      #      cn: 'Proxmox Mail Gateway'
      #      org: 'AnsibleGuy'
      #      email: '[email protected]'
    letsencrypt:
      email: '[email protected]'

Minimalny przykład:

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

Przykład użycia wbudowanego ACME PMG:

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

  nginx:
    aliases: ['mail-gw.ansibleguy.net']
    plain_site: false  # nginx nie będzie działać na porcie 80
    letsencrypt:
      email: '[email protected]'

Przykład - jeśli chcesz ręcznie skonfigurować postgreSQL:

pmg:
  fqdn: 'pmg.template.ansibleguy.net'

  manage:
    database: false

Możesz użyć 'ansible-vault', aby zaszyfrować swoje hasła:

ansible-vault encrypt_string

Wykonanie

Uruchom skrypt:

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml

Aby debugować błędy - możesz ustawić zmienną 'debug' podczas uruchamiania:

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml -e debug=yes

Funkcjonalność

• Instalacja pakietów

  • Zależności Ansible (minimalne)
  • Systemd
  • Proxmox Mail Gateway
  • Zależności PMG
    • postgreSQL
    • Postfix

• Konfiguracja

  • domyślna instalacja postgreSQL

  • Domyślne opcje włączone:

    • Nginx => używając TEJ roli

  • Domyślne opcje wyłączone:

    • Enterprise apt-repository (wymagana subskrypcja)

Informacje

• Ostrzeżenie: JEŚLI UŻYWASZ DEDYKOWANEJ VM DO TEGO USTAWIENIA:

  Lepiej użyć procesu instalacji ISO.

  Może być lepiej wspierane!

• Uwaga: ta rola obecnie wspiera tylko systemy oparte na debianie

• Uwaga: Większość funkcji roli można włączać lub wyłączać.

  Wszystkie dostępne opcje - zobacz domyślną konfigurację w głównym pliku domyślnym!

• Ostrzeżenie: Nie wszystkie ustawienia/zmienne, które podasz, będą sprawdzane pod kątem poprawności. Zła konfiguracja może uszkodzić rolę!

• Ostrzeżenie: Jeśli zdecydujesz się zainstalować serwer WWW nginx (domyślnie) i chcesz korzystać z wbudowanego zarządzania certyfikatami ACME - musisz skonfigurować 'nginx.plain_site' na 'false'.

  Ponieważ ta integracja 'ACME standalone' wymaga, aby port 80 nie był używany!

• Uwaga: Sprawdź fajną dokumentację dostarczoną przez Proxmox!

• Ostrzeżenie: Kontenery Docker NIE SĄ WSPARTE.

• Informacja: Domyślne logowanie do interfejsu WWW PMG odbywa się za pomocą użytkowników PAM/System.

  Zazwyczaj, na początku, przez 'root'.