ansible-role-docker_loomio/README.md

4.0 KiB

Role : docker_loomio

Services fournis

Installation de loomio sur un serveur docker_host

Variables

Fournir les variables suivantes. Par exemple :

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