systemli.prosody

概要バージョン洞察

ansible-role-prosody

Ansibleを使って公式リポジトリからProsodyをインストールし、管理します。 Molecule、Docker、Vagrantでテスト済みです。

要件

Debian 11。他のバージョンのDebian/Ubuntuもサポートされる可能性がありますが、テストは行われていません。

ロール変数

defaults/main.ymlを参照してください。

依存関係

systemli.apt_repositories

ダウンロード

最新のリリースをansible-galaxyでダウンロードします。

ansible-galaxy install systemli.prosody

例のプレイブック

- hosts: servers
  roles:
    - systemli.prosody
  vars:
    prosody_virtual_hosts:
      - name: example.net
        key: |
          -----BEGIN PRIVATE KEY-----
            ...
          -----END PRIVATE KEY-----
        cert: |
            -----BEGIN CERTIFICATE-----
              ...
            -----END CERTIFICATE-----
      - name: x5tno6mwkncu4m2h.onion
        admins: ["[email protected]"]

この設定には、構成されたTorオニオンサービスが必要です。 systemli.onionを参照してください。

自動的に証明書を設定するために、systemli.letsencryptと組み合わせることもできます。

- hosts: servers
  roles:
    - systemli.letsencrypt
    - systemli.prosody
  vars:
    prosody_vhost: example.net
    letsencrypt_cert:
      name: example.net
      domains:
        - example.net
        - conference.example.net
        - proxy.example.net
        - pubsub.example.net
      challenge: dns
      renew_hook: "/usr/bin/prosodyctl --root cert import /etc/letsencrypt/live/"

テスト

ローカルテストを実行するには、次のコマンドを使用します。

molecule test

Molecule、Vagrant、python-vagrantがインストールされている必要があります。

テストの変数を更新するには、次のコマンドを実行します。

j2 --customize ~/custom-j2.py templates/test_prosody.yml.j2 defaults/main.yml > molecule/default/tests/test_default.yml

# ~/custom-j2.py

def j2_environment_params():
    """ Jinja2環境のための追加パラメータ """
    # Jinja2環境の設定
    # http://jinja.pocoo.org/docs/2.10/api/#jinja2.Environment
    return dict(
        # ブロック周りの空白を削除
        trim_blocks=True,
    )