[critical/mail/services] Ajout de mail.md

ROADMAP.md

@@ -21,7 +21,7 @@
 │   │   ├── postfix.md [shirenn]
 │   │   ├── roundcube.md
 │   │   └── services
-│   │       └── mail.md [shirenn]
+│   │       └── mail.md [DONE]
 │   ├── moinmoin.md
 │   ├── monitoring
 │   │   ├── grafana.md
@@ -36,7 +36,7 @@
 │   │   ├── nftables.md
 │   │   ├── radvd.md [DONE]
 │   │   └── services
-│   │       ├── dhcp.md [shirenn]
+│   │       ├── dhcp.md [DONE]
 │   │       ├── firewall.md
 │   │       └── prefix-delegation.md
 │   └── owncloud.md

critical/mail/services/mail.md

@@ -0,0 +1,38 @@
+# Services Mail
+Le script de services mails permet de générer des fichiers d'alias et virtual 
+pour [/critical/mail/postfix](postfix) à partir de la base de données des 
+adhérents du crans. Actuellement celle ci est gérée par re2o donc on fait des 
+requêtes à l'API de re2o pour récupérer la liste des adresses, alias et 
+redirections mails.
+
+## Installation
+Pour installer le logiciel, il faut cloner le répertoire git 
+`https://gitlab.crans.org/nounous/mail.git` . Actuellement la convention veut 
+que les services soient placé sous le chemin `/var/local/services/` mais rien ne 
+l'impose. Pour tourner  le script a besoin du paquet `python3-jinja2`. Il faut 
+aussi crééer le dossier `generated` à la racine du dépot dans lequel seront 
+stocker les fichiers de bails générer. Il est aussi nécessaire de récupérer les 
+fichier `aliases` et `virtual` du dépot git 
+`https://gitlab.crans.org/nounous/mail_aliases.git` et de venir les mettre à la 
+racine du dépot sous les noms `aliases_local` et `virtual_local`.
+
+## Configuration
+### Re2o
+Pour récupérer la liste des adresses mails, le script a besoin de pouvoir parler 
+à l'API re2o. Pour ça on fournit au script les informations de connexions dans le 
+fichier de configuration `re2o-config.ini` à la racine du dépot :
+```
+[Re2o]
+hostname = 172.16.10.156
+username = services
+password = ynerant_aime_le_php
+```
+
+### mail.json
+Dans le fichier de configuration `mail.json` aussi présent à la racine, on 
+réalise le reste de la configuration du logiciel. Actuellement le script ne 
+prends pas d'options, on peut donc se contenter de lui passer le dictionnaire 
+vide en guise de configuration.
+```json
+{}
+```