Service stats.chatons.org

StatoolInfos est un outil et un protocole pour partager des informations sur une fédération de services. Une instance du service est hébergée sur le site chatons.org.

Déploiement

Configuration de Java

Java :

=(^-^)=root@grof:~# apt-get install openjdk-11-jre-headless
[…]
Souhaitez-vous continuer ? [O/n] o
[…]
=(^-^)=root@grof:~# java -version
openjdk version "11.0.9" 2020-10-20
OpenJDK Runtime Environment (build 11.0.9+11-post-Debian-1deb10u1)
OpenJDK 64-Bit Server VM (build 11.0.9+11-post-Debian-1deb10u1, mixed mode, sharing)

Configuration d'Apache

Création d'un fichier générique qui sera includé plus tard :

=(^-^)=root@grof:/srv/chaprilinfos# cat /etc/apache2/chaprilinfos.conf 
    Alias "/.well-known/chaprilinfos/" "/srv/chaprilinfos/well-known/chaprilinfos/"
    <Directory "/srv/chaprilinfos/well-known/chaprilinfos/">
        Options +Indexes
        Require all granted
    </Directory>

Configuration de Nginx

Création d'un fichier générique qui sera includé plus tard :

=(^-^)=root@allo:/etc/nginx#  cat /etc/nginx/chaprilinfos.conf
   location /.well-known/chaprilinfos/ {
       types {
            text/plain    properties;
       }

       alias /srv/chaprilinfos/well-known/;
       autoindex on;
   }

Espace de travail

Dossiers de travail :

mkdir -p /srv/chaprilinfos/{conf,inputs,well-known}

Ajout d'un service dans ChaprilInfos

Configurer l'accès well-known en ajoutant à la fin de la configuration Apache du site :

    # ChaprilInfos
    Include chaprilinfos.conf
</VirtualHost>

Ou au début du fichier de la configuration Nginx du site :

    # ChaprilInfos.
    include /etc/nginx/chaprilinfos.conf;

Puis ajouter :

un fichier de configuration dans /srv/chaprilinfos/conf/<service>chaprilorg.conf ;
un fichier de déclaration dans /srv/chaprilinfos/well-known/<service>chaprilorg.properties.

Peupler le well-known :

cd /srv/chaprilinfos/
./bin/statoolinfos build conf/foochaprilorg.conf

Actualiser un service ChaprilInfos

Sur la vm du service, éditer le fichier de déclaration du service /srv/chaprilinfos/inputs/foochaprilorg.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/chaprilinfos/
./bin/statoolinfos build conf/foochaprilorg.conf

Puis vérifier dans https://stats.chatons.org/chapril.xhtml