Wiki d'AliENS

Mise à jour du wiki

Voici les étapes spécifiques à la mise à jour de l'instance MediaWiki d'AliENS. Dans cette section, on suppose que la mise à jour du flake du système a provoqué un changement de version de MediaWiki.

0. Prendre les précautions habituelles lors d'une mise à jour : effectuez une sauvegarde des données, ...

1. Identifier la version de MediaWiki cible de la mise à jour.

   Par exemple, il est possible d'obtenir la version du package mediawiki sur search.nixos.org.

2. Il est nécessaire de mettre à jour les extensions MediaWiki utilisées.

   Les extensions MediaWiki directement inclues dans la source de MediaWiki seront automatiquement mises à jour.

   Dans les autres cas, une action manuelle est requise. Les extensions sont déclarées dans notre infrastructure via l'utilitaire mkExtension. Pour chaque extension :

   1. Identifier la dernière version de l'extension compatible avec la version cible de MediaWiki et la dernière révision correspondante ;

   2. Il arrive parfois que certaines extensions n'étant auparavant pas inclues dans la distribution de MediaWiki le deviennent au fil du temps. Dans ce cas, il suffit de remplacer l'appel à mkExtension dans la définition de l'extension par null. Pensez aussi à supprimer le lockfile correspondant, s'il y a un !

   3. Mettre à jour les valeurs version et rev dans le code Nix ;

   4. Remplacer hash par lib.fakeHash afin de laisser Nix le calculer lors du rebuild.

   5. Si la définition contient composerLock, il est peut-être nécessaire de le mettre à jour. Pour faire cela, commentez la ligne en question et rebuildez. Nix génère alors un lockfile qui peut être copié pour remplacer l'ancien.

      [!note]

      S'il n'existe pas déja, définissez temporairement l'attribut vendorHash avec pour valeur lib.fakeHash. Cela permet à la dérivation d'accèder à Internet, ce qui est nécessaire pour génerer composer.lock. Supprimez-le après.

   6. S'il existe, remplacer vendorHash par lib.fakeHash afin de laisser Nix le calculer lors du rebuild.

   Actuellement une extension (OAuthNames) est écrite par AliENS, il sera peut-être nécessaire de la mettre à jour sur son dépôt directement !

3. Tester !