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 en détail dans le readme.

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

• pullez les modifications : git pull.
• Installez avec bundle install
• Relancez le service systemctl restart gollum

Pour la configuration du service, voir les détails sur l'article Wiki.

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.