systemli.prosody

Überblick Versionen Einblicke

ansible-roll-prosody

Installiere und verwalte Prosody aus dem offiziellen Repository mit Ansible. Getestet mit Molecule, Docker und Vagrant.

Anforderungen

Debian 11. Andere Versionen von Debian/Ubuntu könnten ebenfalls unterstützt werden, sind aber nicht getestet.

Rollenvariablen

Siehe defaults/main.yml

Abhängigkeiten

systemli.apt_repositories

Download

Lade die neueste Version mit ansible-galaxy herunter

ansible-galaxy install systemli.prosody

Beispiel-Playbook

- hosts: server
  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]"]

Du benötigst einen konfigurierten Tor-Onion-Dienst dafür. Siehe systemli.onion.

Du kannst es auch mit systemli.letsencrypt kombinieren, um Zertifikate automatisch zu konfigurieren.

- hosts: server
  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/"

Tests

Führe lokale Tests mit

molecule test

Benötigt, dass Molecule, Vagrant und python-vagrant installiert sind.

Um Variablen in Tests zu aktualisieren, führe folgenden Befehl aus

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():
    """ Zusätzliche Parameter für die Jinja2-Umgebung """
    # Jinja2-Umgebungs-Konfiguration
    # http://jinja.pocoo.org/docs/2.10/api/#jinja2.Environment
    return dict(
        # Leerzeichen um Blöcke herum entfernen
        trim_blocks=True,
    )