ansible-role-etherpad

Rola do instalacji, konfiguracji i utrzymania Etherpad Lite. Możesz użyć tej roli, aby skonfigurować Etherpad z następującymi rozwiązaniami pamięci masowej: MySQL (lub MariaDB), Redis i PostgreSQL.

Obecnie tylko MySQL pozwala na tworzenie użytkownika i bazy danych. W przypadku PostgreSQL te operacje musisz wykonać samodzielnie (jeśli chcesz lub musisz zautomatyzować te zadania, możesz użyć tej roli: geerlingguy.postgresql).

Ten playbook umożliwia również instalację kilku wtyczek dla Etherpad:

• ep_delete_after_delay (Aby usunąć nieaktywny pad po pewnym czasie)
• ep_headerauth (Aby uwierzytelniać użytkowników przez nagłówek HTTP - np. przydatne przy korzystaniu z portalu SSO, takiego jak LemonLDAP::NG)

Zmienne roli

Playbook wymaga specjalnej konfiguracji. Musisz ustawić etherpad_api_key!

etherpad_db_type: dirty

Ta zmienna pozwala określić, jakiego rodzaju pamięci masowej chcemy użyć dla Etherpad (domyślnie to dirty, proszę nie używać tej wartości w środowisku produkcyjnym). Zmienna ta musi być ustawiona na jedną z następujących wartości: dirty, mysql, redis lub postgres.

etherpad_postgres_database_host: localhost
etherpad_postgres_database_name: etherpad
etherpad_postgres_database_user: etherpad
etherpad_postgres_database_password:
etherpad_postgres_database_port: 5432
etherpad_postgres_database_ssl_policy: "disabled"

Te zmienne pozwalają skonfigurować Etherpad z PostgreSQL. Aby móc ich użyć, musisz ustawić zmienną etherpad_db_type na postgres.

etherpad_headerauth_username_header: x-authenticated-user
etherpad_headerauth_displayname_header: x-authenticated-name

Wartości konfiguracyjne dla wtyczki ep_headerauth (uwierzytelnianie za pomocą nagłówka http). Jeśli chcesz użyć tej wtyczki, etherpad_trust_proxy i etherpad_require_authentication muszą być ustawione na True.

Więcej informacji o dostępnych zmiennych (i ich domyślnych wartościach): zobacz defaults/main.yml

Przykładowy playbook

- hosts: servers
  roles:
     - { role: systemli.etherpad }

Testowanie i rozwój

Testy

Do rozwijania i testowania roli używamy Github Actions, Molecule i Vagrant. W lokalnym środowisku możesz łatwo przetestować rolę, uruchamiając:

Uruchom lokalne testy:

```bash
molecule test
```

Wymaga zainstalowania Molecule, Vagrant oraz python-vagrant.

Licencja

GPLv3

Informacje o autorze

https://www.systemli.org