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

This commit is contained in:
Christian P. MOMON 2021-10-22 15:56:42 +02:00
parent e1ed2f9dac
commit 72d0411080

View file

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