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

# 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/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/