documentation/infra/infos.libre-service.eu.md

2.1 KiB

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 cat /etc/apache2/statoolinfos.conf qui sera includé plus tard :

    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 cat /etc/nginx/statoolinfos.conf qui sera includé plus tard :

   location /.well-known/statoolinfos/ 
   {
       types 
       {
            text/plain    properties;
       }

       alias /srv/statoolinfos/well-known/statoolinfos/;
       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/