Trace install tas - MediaWiki

Trace install tas - MediaWiki

Rôle

Wiki collaboratif et base documentaire.

Accès

• Local : http://10.8.0.1:8098
• Public : https://lololand.hopto.org:25698

Ports

8098 local, 25698 public via Caddy

Exécution / runtime

Quadlets rootless systemd user ; conteneurs mediawiki-app et mediawiki-db.

Principe :

• `mediawiki-app` sert l'application wiki en HTTP sur le port local 8098
• `mediawiki-db` fournit la base MariaDB dédiée
• Caddy publie ensuite le service local vers le port public 25698

Chemins de configuration

• /home/loic/.config/containers/systemd/mediawiki-app.container
• /home/loic/.config/containers/systemd/mediawiki-db.container
• /home/loic/mediawiki/.env
• /home/loic/mediawiki/app/LocalSettings.php
• /home/loic/mediawiki/docs/README.md
• /home/loic/mediawiki/compose.yaml (référence de reconstitution / rollback)

Paramètres clés à documenter

Les quadlets sont la source de vérité de lancement. Pour rester exploitable en maintenance, il faut considérer ces éléments comme prioritaires :

• image de `mediawiki-app`
• image de `mediawiki-db`
• variables d'environnement des quadlets et/ou de `.env`
• ports publiés localement
• bind mounts ou volumes de l'application et de la base
• éventuelles extensions ou personnalisations chargées par `LocalSettings.php`

Volumes / persistance

• ./app -> /var/www/html

 * contient le code applicatif local, les extensions, `LocalSettings.php` et les données nécessaires côté MediaWiki

• ./db -> /var/lib/mysql

 * contient les données MariaDB du wiki

Dépendances

• MariaDB dédiée (mediawiki-db)
• Caddy 25698 -> 8098

Procédure de relance / diagnostic

Relance standard :

• `systemctl --user restart mediawiki-db.service mediawiki-app.service`
• `systemctl --user daemon-reload` après modification d'un quadlet

Vérifications utiles :

• vérifier que `mediawiki-app` écoute bien sur 8098 local
• vérifier que `mediawiki-db` est sain avant de conclure à une panne applicative
• tester l'accès local avant l'accès public
• revalider `LocalSettings.php` après toute restauration

Le fichier `compose.yaml` reste utile comme référence, mais il ne faut plus le présenter comme méthode d'exploitation primaire tant que les quadlets restent le runtime actif.

Remarques

Le wiki héberge la documentation d'installation, la trace logicielle et les intégrations Mermaid / PlantUML / BPMN JS. Beszel n'est pas une dépendance applicative de MediaWiki. L'impact côté MediaWiki est documentaire : mise à jour de la trace serveur et des pages concernées.

Données / emplacements à sauvegarder

• Données wiki : /home/loic/mediawiki/app
• Base : /home/loic/mediawiki/db
• Variables : /home/loic/mediawiki/.env
• Documentation locale : /home/loic/mediawiki/docs

Sauvegarde

• Sauvegarder /home/loic/mediawiki/app, /home/loic/mediawiki/.env et /home/loic/mediawiki/docs.
• Sauvegarder la base MariaDB via dump ou en copiant /home/loic/mediawiki/db après arrêt propre.
• Si une extension ou un réglage Caddy change, inclure aussi les fichiers de configuration modifiés dans la sauvegarde documentaire.

Restauration

• Restaurer /home/loic/mediawiki/app, /home/loic/mediawiki/.env et /home/loic/mediawiki/db.
• Relancer d'abord `mediawiki-db.service`, puis `mediawiki-app.service`, puis vérifier `LocalSettings.php`, la connexion à la base et l'accès wiki local/public.
• Après restauration, revalider les extensions chargées et les éventuels chemins personnalisés.

Maintenance documentaire

Lors d'un ajout d'extensions, d'un changement de quadlet, de variables .env, d'images, de ports, de Caddy ou de structure documentaire, mettre à jour cette page et les pages de documentation associées.

Trace documentaire

Cette page fait partie de Trace install tas.