Ansible ロール - Proxmox Mail Gateway

LinuxサーバーにProxmox Mail Gatewayをデプロイするためのロールです。

テスト済み:

• Debian 11

インストール

# 最新版
ansible-galaxy role install git+https://github.com/ansibleguy/sw_proxmox_mail_gw

# galaxyから
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw

# またはカスタムロールパスにインストール
ansible-galaxy install ansibleguy.sw_proxmox_mail_gw --roles-path ./roles

# 依存関係のインストール
ansible-galaxy install -r requirements.yml

前提条件

詳細は: 前提条件

使用方法

シンプルなAnsible GUIをお探しですか？私のAnsible WebUIをチェックしてください。

設定

必要に応じて設定を定義します：

pmg:
  fqdn: 'pmg.template.ansibleguy.net'  # 有効な公開DNSホスト名

  manage:
    webserver: true  # nginxコンポーネントを無効にする場合はfalseに設定

  nginx:  # ウェブサーバーの設定を行います => 詳細は: https://github.com/ansibleguy/infra_nginx
    aliases: ['mail-gw.ansibleguy.net']  # 証明書に追加するドメイン
    ssl:
      mode: 'letsencrypt'  # またはselfsigned/ca
      # 'selfsigned'または'ca'を使用する場合：
      #    cert:
      #      cn: 'Proxmox Mail Gateway'
      #      org: 'AnsibleGuy'
      #      email: '[email protected]'
    letsencrypt:
      email: '[email protected]'

最小限の例：

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

PMGの組み込みACMEを使用する例：

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

  nginx:
    aliases: ['mail-gw.ansibleguy.net']
    plain_site: false  # nginxはポート80にバインドしません
    letsencrypt:
      email: '[email protected]'

手動でpostgreSQLをセットアップする場合の例：

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

  manage:
    database: false

パスワードを暗号化するには'ansible-vault'を使用することをお勧めします：

ansible-vault encrypt_string

実行

プレイブックを実行します：

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

エラーのデバッグを行うには、実行時に'debug'変数を設定できます：

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

機能

• パッケージのインストール

  • Ansibleの依存関係 (最小限)
  • Systemd
  • Proxmox Mail Gateway
  • PMGの依存関係
    • postgreSQL
    • Postfix

• 設定

  • デフォルトのpostgreSQLインストール

  • デフォルトのオプトイン:

    • Nginx => このロールを使用

  • デフォルトのオプトアウト:

    • エンタープライズaptリポジトリ (サブスクリプションが必要)

インフォメーション

• 警告: 専用VMでこのセットアップを使用している場合:

  ISOインストールプロセスを使用することをお勧めします。

  サポートがより良いかもしれません！

• 注意: このロールは現在、Debianベースのシステムのみをサポートしています。

• 注意: ロールのほとんどの機能はオプトインまたはオプトアウトが可能です。

  利用可能なオプションについては、メインデフォルトファイルにあるデフォルト設定を参照してください！

• 警告: 提供されたすべての設定/変数が有効性をチェックされるわけではありません。不正な設定はロールを壊す可能性があります！

• 警告: Nginxウェブサーバーをインストールすることを選択した場合 (デフォルト)、組み込みのACME証明書管理を使用するには、'nginx.plain_site'を'false'に設定する必要があります。

  この「ACMEスタンドアロン統合」はポート80を使用しないと動作しません！

• 注意: Proxmoxが提供する優れたドキュメントをチェックしてください！

• 警告: Dockerコンテナはサポートされていません。

• 情報: PMGのウェブインターフェースのデフォルトログインはPAM/システムユーザーを通じて行われます。

  通常、最初は'root'を通して行われます。