ansible-role-etherpad

Rol para instalar, configurar y mantener Etherpad Lite. Puedes usar este rol para configurar Etherpad con estas soluciones de almacenamiento: MySQL (o MariaDB), Redis y PostgreSQL.

Actualmente, solo MySQL permite crear el usuario y la base de datos. Para PostgreSQL, esas operaciones deben hacerse por tu cuenta (Si quieres o necesitas automatizar estas tareas, probablemente puedes usar este rol: geerlingguy.postgresql).

Este playbook también permite instalar algunos plugins para Etherpad:

• ep_delete_after_delay (Para eliminar algunos pads inactivos después de un retraso)
• ep_headerauth (Para autenticar a los usuarios a través de la cabecera HTTP - Por ejemplo, útil al usar un portal SSO como LemonLDAP::NG)

Variables del Rol

El playbook requiere una configuración especial. ¡Debes establecer etherpad_api_key!

etherpad_db_type: dirty

Esta variable permite definir qué tipo de almacenamiento queremos usar para Etherpad (el valor predeterminado es dirty, por favor, no uses este valor en un entorno de producción). Esta variable debe establecerse en uno de estos valores: dirty, mysql, redis o 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"

Estas variables permiten configurar Etherpad con PostgreSQL. Para poder usarlas, debes establecer la variable etherpad_db_type en postgres.

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

Valores de configuración para el plugin ep_headerauth (autenticación con cabecera http). Si deseas usar este plugin, etherpad_trust_proxy y etherpad_require_authentication deben establecerse en True.

Para más información sobre las variables disponibles (y sus valores predeterminados): consulta defaults/main.yml

Ejemplo de Playbook

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

Pruebas y Desarrollo

Pruebas

Para desarrollar y probar el rol, usamos Github Actions, Molecule y Vagrant. En el entorno local, puedes probar fácilmente el rol con:

Ejecuta pruebas locales con:

```bash
molecule test
```

Requiere que Molecule, Vagrant y python-vagrant estén instalados.

Licencia

GPLv3

Información del Autor

https://www.systemli.org