====== Service bd.chapril.org ======

===== 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 [[admin:procedures:creation_machine_virtuelle|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 : [[https://github.com/willianpc/comicgen|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 [[https://jquery.com/|JQuery]].

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

Le code source est disponible depuis le dépôt [[https://forge.april.org/Chapril/bd-chapril|Chapril/bd-chapril]].
La page principale du service est sur [[https://bd.chapril.org/|bd.chapril.org]].

===== Mise à jour du site =====

L’animateur système souhaitant mettre à jour le service peut passer par les outils Git, SCP et [[https://imagemagick.org/index.php|ImageMagick]].
Le dépôt peut être cloné depuis la version //VERSION//((La version est au format //x.y.z// où //x//, //y// et //z// sont des entiers décimaux.)).
Dans GNU/Linux Debian ces trois outils sont installables depuis le gestionnaire de paquet.

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

Depuis la racine du dépôt on exécute trois //scripts//.
<code bash>
./tools/mkmini.sh
./tools/mkdata.sh
./tools/mkdist.sh
</code>

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 [[admin:procedures:ajouter-animateur-service|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.

<file sshconfig ~/.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"
</file>

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

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