Ajouter 'services/infos.libre-service.eu.md'

services/infos.libre-service.eu.md

@@ -0,0 +1,78 @@
+# Service infos.libre-service.eu
+
+StatoolInfos est un outil et un protocole pour partager des informations sur une fédération de services.
+
+# Déploiement
+
+## Configuration de Java
+Java :
+```
+apt-get install openjdk-11-jre-headless
+```
+
+## Configuration d'Apache
+
+Création d'un fichier générique qui sera includé plus tard :
+```
+cat /etc/apache2/statoolinfos.conf 
+    Alias "/.well-known/statoolinfos/" "/srv/statoolinfos/well-known/statoolinfos/"
+    <Directory "/srv/statoolinfos/well-known/statoolinfos/">
+        Options +Indexes
+        Require all granted
+    </Directory>
+```
+
+## Configuration de Nginx
+Création d'un fichier générique qui sera includé plus tard :
+```
+cat /etc/nginx/statoolinfos.conf
+   location /.well-known/statoolinfos/ {
+       types {
+            text/plain    properties;
+       }
+
+       alias /srv/statoolinfos/well-known/;
+       autoindex on;
+   }
+```
+## Espace de travail
+Dossiers de travail :
+```
+mkdir -p /srv/statoolinfos/{conf,inputs,well-known}
+```
+
+## Ajout d'un service
+Configurer l'accès well-known en ajoutant à la fin de la configuration Apache du site :
+```
+    # StatoolInfos
+    Include statoolinfos.conf
+</VirtualHost>
+```
+Ou au début du fichier de la configuration Nginx du site :
+```
+    # StatoolInfos.
+    include /etc/nginx/statoolinfos.conf;
+```
+
+Puis ajouter :
+  * un fichier de configuration dans /srv/statoolinfos/conf/foo.libre-service.eu.conf ;
+  * un fichier de déclaration dans /srv/statoolinfos/intpus/foo.libre-service.eu.properties.
+
+Peupler le well-known :
+```
+cd /srv/statoolinfos/
+./bin/statoolinfos build conf/foo.libre-service.eu.conf
+```
+
+## Actualisation d'un service
+
+Sur la vm du service, éditer le fichier de déclaration du service ''/srv/statoolinfos/inputs/foo.libre-service.eu.properties''.
+
+Une documentation des propriétés est disponible là : https://framagit.org/chatons/chatonsinfos/-/blob/master/MODELES/service.properties
+
+Puis re-peupler le dossier well-known exposé sur le web :
+```
+cd /srv/statoolinfos/
+./bin/statoolinfos build conf/foo.libre-service.eu.conf
+```
+Puis vérifier dans https://infos.libre-service.eu/