Mise à jour de paste

Ceci est une nouvelle procédure, pas encore totalement éprouvée. Elle a été rédigée à partir de ce qui a été fait manuellement pour la v1.5.1.

La mise à jour se passe en 2 temps :

générer un tarball de la nouvelle version, sur le poste de travail de l'animsys
déployer ce tarball sur le serveur

Générer le "livrable"

Cette étape se déroule de préférence sur le poste de travail de l'animsys, pas sur le serveur.

La première fois

mkdir -p ~/code/chapril/paste-chapril
cd ~/code/chapril/paste-chapril/
git clone https://forge.april.org/Chapril/paste.chapril.org-privatebin.git . # ne pas oublier le "." ici
git remote add upstream https://github.com/PrivateBin/PrivateBin.git
git fetch --all

Les fois suivantes

cd ~/code/chapril/paste-chapril

Trouver le tag de la verion qui nous intéresse. C'est probablement le dernier qui nous intéresse, donc on peut l'obtenir avec cette commande :

git tag --sort=v:refname | tail -n 1

Stockons le numéro de version qui nous intéresse dans une variable, ici la version 1.5.1 pour l'exemple :

export VERSION=1.5.1

cd ~/code/chapril/paste-chapril
git checkout chapril-trunk 
git rebase ${VERSION?}

Et maintenant, il faut résoudre les éventuels conflits.

TODO : décrire grossièrement la procédure de résolution des conflits (edit/git add/git rebase –continue)

Une fois les conflits résolus, on créé un tag, puis une archive tar.gz à partir de ce tag :

git tag chapril-paste-${VERSION?}
git archive -o /tmp/chapril-paste-${VERSION?}.tar.gz chapril-paste-${VERSION?}
git push --tags origin # Pousser le tag côté forge April

Déployer

Ceci est une nouvelle procédure, pas encore totalement éprouvée. Elle a été rédigée à partir de ce qui a été fait manuellement pour la v1.5.1.

Transférer le tarball précédemment créé sur la VM lamp, dans le dossier /tmp/.

Stockons une fois de plus le numéro de version qui nous intéresse dans une variable, ici la version 1.5.1 pour l'exemple :

export VERSION=1.5.1

On extrait alors dans un dossier dédié, dans lequel on doit recopier le fichier conf.php spécifique de Chapril (on ne le copie pas, on créé plutôt un lien symbolique parce qu'on aime créer du lien :) )

cd /var/www/paste.chapril.org/
mkdir chapril-paste-${VERSION?}
chmod -R www-data: chapril-paste-${VERSION?}
cd chapril-paste-${VERSION?}/cfg/
ln -s /etc/paste-chapril.conf conf.php

Et si tout s'est bien passé, on peut faire la bascule, tout simplement en remplaçant le lien symbolique public_html pour qu'il pointe vers le nouveau dossier :

rm -f public_html ; ln -s chapril-paste-${VERSION?} public_html

On vérifie que l'appli fonctionne toujours en visitant https://paste.chapril.org/.

Si besoin, on peut rapidement faire un retour arrière à la version précédente (version 1.4.0 ici) avec la commande suivante :

rm -f public_html ; ln -s chapril-paste-1.4.0 public_html