Description

Smeagol est une VM dans le pool du I11. Elle héberge le Wiki (Gollum).

Services hebergés

Gollum

Installation/Update

Le wiki est installé avec Gollum, sur l'utilisateur wiki. Gollum est installé via ses sources depuis notre dépôt et clôné dans ~wiki/gollum-forks.

La procédure d'installation est décrite dans le readme.

Pour intégrer des mises à jour depuis le dépôt :

• pullez les modifications : git pull.
• Installez avec bundle install

Gestion du processus

Gollum est un programme compilé, tournant en tant que daemon, et géré par systemd avec la commande systemctl <cmd> gollum.

L'unit-file est copié depuis le dépôt dans /etc/systemd/system/gollum.service.

Synchronisation du Wiki

Le wiki est disponible sur le dépôt ResEl/general.wiki et clôné dans ~wiki/general.wiki. Il est au moyen d'un compte wiki créé sur Gitlab, dont la clé ssh est dans .ssh/id_rsa.

Le dépôt est configuré avec comme upstream ssh://git@versio.adm.resel.fr:43000/resel/general.wiki.git le temps que l'issue soit résolue, (cf issue #84 et #94).

Il y a un script de synchronisation; copié depuis le dépôt, lancé régulièrement avec une tâche cron :

*/1 *  *    *   * cd ~wiki/ && sync.sh > /dev/null 2>&1

Si ce script rencontre une erreur il l'écrit dans le fichier SYNC_ERROR qu'il crée. Il le supprimme si aucune erreur.

Monitorage de la synchro

La synchronisation est monitorée via Icinga. Pour ça, il y a un wrapper icinga, copié le dépôt dans ~wiki/icinga-wrapper.sh. Ce wrapper va simplement vérifier la présence de SYNC_ERROR et récuperer l'erreur le cas échéant.

Ce script est lancé par ssh depuis Icinga sur Eris.

Configuration/Customisation

TODO parler de custom.js custom.css et le fichier de custom.