Service bd.chapril.org

Cette page est à compléter par l’administrateur système à l’origine de l’installation de la VM en service.

Introduction

Cette documentation explique comment installer un service, en l’occurrence BD Chapril, sur une nouvelle machine virtuelle de l’infrastructure du Chapril. Une partie de sa mise en place est donc similaire aux autres services. Même si l’ensemble de la procédure est traitée, c'est la partie plus spécifique à ce service qui sera la plus détaillée. Par exemple, la création d'une machine virtuelle renvoie sur une autre page et n'est pas détaillée ici. Cette documentation est technique mais se veut accessible avec de bonnes connaissances notamment en ce qui concerne la ligne de commande.

Ce service est une bifurcation d’un ancien projet : Comic Gen. Il permet la création rapide d’une trame de bande dessinée. L’application est développée en JavaScript avec pour seule dépendance externe JQuery.

Retrouvez la page de présentation du service sur le site www.chapril.org : www.chapril.org/-services-.html.

Le code source est disponible depuis le dépôt Chapril/bd-chapril. La page principale du service est sur bd.chapril.org.

Mise à jour du site

L’animateur système souhaitant mettre à jour le service peut passer par les outils Git, SCP et ImageMagick. Le dépôt peut être cloné depuis la version VERSION¹⁾. Dans GNU/Linux Debian ces trois outils sont installables depuis le gestionnaire de paquet.

git clone --branch="$VERSION"  'https://forge.april.org/Chapril/bd-chapril.git'
cd bd-chapril/

Depuis la racine du dépôt on exécute trois scripts.

./tools/mkmini.sh
./tools/mkdata.sh
./tools/mkdist.sh

D’abord les images miniatures sont créées dans toons/ puis des données sont générées dans data/. Enfin un répertoire dist/ est créé et contient la charge utile à téléverser dans la VM.

La suite suppose que l’animateur système est ajouté à la VM.

En partant du fichier de configuration ci-dessous deux commandes suffisent à téléverser le site statique. Cette configuration nécessite le nom USER_NAME et l’adresse courriel USER_EMAIL de l’utilisateur.

~/.ssh/config

Host bd.chapril.org
  Hostname bd.cluster.chapril.org
  User root
  ProxyJump april@fip.chapril.org
  SetEnv GIT_AUTHOR_NAME="$USER_NAME" GIT_AUTHOR_EMAIL="$USER_EMAIL"

ssh bd.chapril.org '( cd /srv/www/bd.chapril.org/; rm -rf *)'
scp -r dist/* bd.chapril.org:/srv/www/bd.chapril.org/

Reste à attendre le rechargement du contenu par le serveur Web.

¹⁾

La version est au format x.y.z où x, y et z sont des entiers décimaux.