70 lines
2.9 KiB
Plaintext
70 lines
2.9 KiB
Plaintext
Fonctionnement des scripts de mise-à-jour d'AlternC
|
|
===================================================
|
|
|
|
/!\ ATTENTION /!\
|
|
Votre script DOIT etre numéroté sur trois chiffres, pas plus, pas moins.
|
|
Donc :
|
|
1.0.1.sql -> OK
|
|
1.0.2~1.sql -> OK
|
|
1.0.2~a.sql -> OK
|
|
1.0.2.5.sql -> PAS OK
|
|
1.0.sql -> PAS OK
|
|
|
|
Sinon, ca sera dans n'importe quel ordre.
|
|
|
|
|
|
Il a été décidé que des mises-à-jour pourront être "accrochées" à
|
|
certaines versions en les mettant dans le dossier upgrades. Lors de
|
|
l'installation d'un paquet, un script (upggrade_check.sh) examine ce
|
|
dossier et applique les mises-à-jour nécessaires, en se basant sur les
|
|
numéros de version. Les scripts considérés sont ceux terminés par
|
|
.sql, .sh ou .php, et sont interprétés avec mysql, /bin/sh ou php
|
|
respectivement, et dans cet ordre.
|
|
|
|
Pour être considéré, le script doit donc avoir un nom conforme,
|
|
c'est-à-dire sous la forme \d(\.\d+)* (en expression régulière), par
|
|
exemple: 0.9.1.sh, 1.0.php, etc. De plus, le fichier est considéré
|
|
seulement si la version avec laquelle il est nommé tombe entre la
|
|
version de départ et d'arrivée du package.
|
|
Afin de forcer les scripts d'une même version a ce lancer dans un ordre précis,
|
|
on peut rajouter ~x avant l'extension du script où x est un charctère alphanumérique
|
|
([0-9][a-z]). Par exemple pour forcer un script d'upgrade php a s'executer avant
|
|
un autre, il suffit de le rennomer X.X.X~1.php et X.X.X~2.php
|
|
|
|
Voir ci-bas pour des exemples.
|
|
|
|
Description formelle du fonctionnement de upgrade_check.sh
|
|
----------------------------------------------------------
|
|
|
|
Soit un upgrade d'une version X à une version Y. Les fichiers du
|
|
dossier d'upgrade sont examinés un à un. Pour chaque fichier dont le
|
|
nom N.php, N.sh ou N.sql est X >= N <= Y, le fichier est exécuté ou
|
|
passé à mysql, selon le cas approprié. Les versions sont comparées
|
|
avec dpkg --compare-versions. Les scripts sont exécutés dans cet
|
|
ordre: *.sql *.sh *.php.
|
|
|
|
Il est donc capital de nommer correctement ce fichier.
|
|
|
|
Ces scripts devront être idempotents, car ils peuvent être exécutés à
|
|
plusieurs reprises, comme tous les scripts postinst et config.
|
|
|
|
(Note: en réalité, on ne vérifie pas la condition N <= Y. On assume que
|
|
si le script est disponible, il est applicable à cette version. Ceci
|
|
signifie qu'il ne faut pas "packager" un script d'upgrade N dans un
|
|
package Y si N > Y. Exemple: ne pas inclure un script 1.0 dans un
|
|
package 0.9, car il sera exécuté, même si la version installée est 1.0.)
|
|
|
|
Pour plus de détails, consultez directement le script
|
|
../upgrade_check.sh, qui gère ces upgrades.
|
|
|
|
Mise en situation
|
|
-----------------
|
|
|
|
Exemple: 0.9.1 sera exécuté lors d'une mise à jour de 0.9 à 0.9.1 (ou
|
|
1.0), mais pas d'une mise à jour de 0.9.1 à 1.0.
|
|
|
|
Autre exemple: on procède à une mise à jour de alternc-0.9-20031009 vers
|
|
alternc-0.9.1. On trouve le script upgrades/0.9.1.sh. Celui-ci est
|
|
exécuté car 0.9-20031009 >= 0.9.1 <= 0.9.1. Il serait aussi exécuté pour
|
|
une mise à jour vers 0.9.2, 1.0, etc.
|