ansible-role-docker_loomio/README.md

63 lines
4.0 KiB
Markdown

# Role : docker_loomio
## Services fournis
Installation de loomio sur un serveur docker_host
## Variables
Fournir les variables suivantes. Par exemple :
```yaml
docker_loomio_fqdn: loomio.example.com
docker_loomio_name: My Loomio Site
docker_loomio_version: v2.15.3
docker_loomio_data_dir: /data1
docker_loomio_service_id: loomio
docker_loomio_reply_to: nepasrepondre-loomio@example.com
docker_loomio_smtp_server: smtp.example.com
docker_loomio_db_name: loomio
docker_loomio_db_user: loomiodbuser
docker_loomio_db_password: mdp_de_loomiodbuser
docker_loomio_devise_secret: ici_le_devise_secret
docker_loomio_secret_cookie_token: ici_le_secret_cookie_token
```
| Option | Valeur par défaut | Description |
|---------------------------------------------|-------------------|-------------------------------------------------------------------------------------------|
| docker_loomio_fqdn | | Le nom de domaine pour lequel le service loomio répond |
| docker_loomio_name | | Le nom affiché par le service loomio |
| docker_loomio_version | | La version de l'image docker loomio |
| docker_loomio_data_dir | | L'emplacement dans lequel se trouvent les volumes de donnees docker pour le service |
| docker_loomio_service_id | | Le nom de service souhaité : conditionne le nommage des volumes et le routage par traefik |
| docker_loomio_reply_to | | L'adresse d'expéditeur des courriels envoyés par le service |
| docker_loomio_smtp_server | | L'adresse du serveur smtp par lequel le service envoie les courriels |
| docker_loomio_db_name | | Nom de la base de données postgres pour loomio |
| docker_loomio_db_user | | Nom du user postgres propriétaire de la base de données |
| docker_loomio_db_password | | Mot du passe du user postgres |
| docker_loomio_devise_secret | | s'obtient avec openssl rand -base64 48 |
| docker_loomio_secret_cookie_token | | s'obtient avec openssl rand -base64 48 |
| docker_loomio_features_disable_create_user | false | Si true, désactive la possibilité de créer un utilisateur sans invitation |
| docker_loomio_features_disable_create_group | false | Si true, désactive la possibilité pour les utilisateurs de créer des groupes |
## Point d'attention
Le fonctionnement de loomio nécessite deux urls dont il faut tenir compte (DNS notamment) :
* une décrite dans docker_loomio_fqdn
* une seconde qui correspond à channels.{{ docker_loomio_fqdn }}
## Première installation dans loomio
A la première exécution du playbook, la base de données est initialisée et des valeurs sont proposées pour docker_loomio_devise_secret et docker_loomio_secret_cookie_token qu'il suffit de reporter dans les variables ansible. Relancer ensuite le playbook après avoir renseigné ces variables.
Se connecter à loomio et enregistrer un premier utilisateur, pui promouvoir celui-ci en administrateur de l'instance loomio par :
```
docker-compose run app rails c
User.last.update(is_admin: true)
```
La console d'administration répond à https://docker_loomio_fqdn/admin