Chapril DokuWiki

Outils pour utilisateurs

Outils du site

Vous êtes ici : start » services » bd.chapril.org
services:bd.chapril.org

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
services:bd.chapril.org [2026/04/11 17:40] – supprimée - modification externe (Date inconnue) 127.0.0.1services:bd.chapril.org [2026/04/11 17:40] (Version actuelle) – ↷ Page déplacée de admin:services:bd.chapril.org à services:bd.chapril.org pitchum
Ligne 1: Ligne 1:
 +====== 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.org-bd|Chapril/bd.chapril.org-bd]].
 +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.org-bd.git'
 +cd bd.chapril.org-bd/
 +</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.