systemli.prosody

Przegląd Wersje Wgląd

ansible-role-prosody

Instaluj i utrzymuj Prosody z oficjalnego repozytorium przy użyciu Ansible. Testowane z Molecule, Docker i Vagrant.

Wymagania

Debian 11. Inne wersje Debiana/Ubuntu mogą być wspierane, ale nie były testowane.

Zmienne roli

zobacz defaults/main.yml

Zależności

systemli.apt_repositories

Pobieranie

Pobierz najnowszą wersję za pomocą ansible-galaxy

ansible-galaxy install systemli.prosody

Przykładowy Playbook

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

Będziesz potrzebować skonfigurowanej usługi Tor onion dla tego. Zobacz systemli.onion.

Możesz również połączyć to z systemli.letsencrypt, aby automatycznie konfigurować certyfikaty.

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

Testy

Uruchom testy lokalne za pomocą

molecule test

Wymaga zainstalowanego Molecule, Vagrant i python-vagrant.

Aby zaktualizować zmienne w testach, uruchom

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():
    """ Dodatkowe parametry dla środowiska Jinja2 """
    # Konfiguracja środowiska Jinja2
    # http://jinja.pocoo.org/docs/2.10/api/#jinja2.Environment
    return dict(
        # Usuń białe znaki wokół bloków
        trim_blocks=True,
    )