diff --git a/infra/infos.libre-service.eu b/infra/infos.libre-service.eu deleted file mode 100644 index b76ec78..0000000 --- a/infra/infos.libre-service.eu +++ /dev/null @@ -1,3 +0,0 @@ -# infos.libre-service.eu - -TODO \ No newline at end of file diff --git a/infra/infos.libre-service.eu.md b/infra/infos.libre-service.eu.md new file mode 100644 index 0000000..aa57378 --- /dev/null +++ b/infra/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/" + + Options +Indexes + Require all granted + +``` + +## 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 + +``` +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/