« Trace install tas - MediaWiki » : différence entre les versions
Phase 2 : enrichissement documentation |
Documentation conteneurs enrichie: runtime, paramètres, ports, volumes, relance et diagnostic |
||
| (3 versions intermédiaires par 2 utilisateurs non affichées) | |||
| Ligne 12 : | Ligne 12 : | ||
== Exécution / runtime == | == Exécution / runtime == | ||
Stack compose dans /home/loic/mediawiki ; conteneurs mediawiki-app et mediawiki-db | Stack compose dans /home/loic/mediawiki ; 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 == | == Chemins de configuration == | ||
| Ligne 19 : | Ligne 24 : | ||
* /home/loic/mediawiki/app/LocalSettings.php | * /home/loic/mediawiki/app/LocalSettings.php | ||
* /home/loic/mediawiki/docs/README.md | * /home/loic/mediawiki/docs/README.md | ||
== Paramètres clés à documenter dans le compose == | |||
Cette page suppose que le compose local est la source de vérité. Pour rester exploitable en maintenance, il faut considérer ces éléments comme prioritaires : | |||
* image de `mediawiki-app` | |||
* image de `mediawiki-db` | |||
* variables injectées via `.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 == | == Volumes / persistance == | ||
* ./app -> /var/www/html | * ./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 | * ./db -> /var/lib/mysql | ||
* contient les données MariaDB du wiki | |||
== Dépendances == | == Dépendances == | ||
* MariaDB dédiée (mediawiki-db) | * MariaDB dédiée (mediawiki-db) | ||
* Caddy 25698 -> 8098 | * Caddy 25698 -> 8098 | ||
== Procédure de relance / diagnostic == | |||
Relance standard : | |||
* depuis /home/loic/mediawiki, relancer la stack compose selon la méthode utilisée sur l'hôte | |||
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 | |||
Comme la commande exacte de compose n'est pas recopiée ici, la règle documentaire est : documenter explicitement la commande réelle utilisée dès qu'une modification est faite sur cette stack. | |||
== Remarques == | == Remarques == | ||
Le wiki héberge la documentation d'installation, la trace logicielle et les intégrations Mermaid / PlantUML / BPMN JS. | Le wiki héberge la documentation d'installation, la trace logicielle et les intégrations Mermaid / PlantUML / BPMN JS. | ||
== 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 la stack compose 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 == | == Maintenance documentaire == | ||
Lors d'un ajout d'extensions, d'un changement de compose, de variables .env, de Caddy ou de structure documentaire, mettre à jour cette page et les pages de documentation associées. | Lors d'un ajout d'extensions, d'un changement de compose, 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 == | == Trace documentaire == | ||
Cette page fait partie de [[Trace install tas]]. | Cette page fait partie de [[Trace install tas]]. | ||
Dernière version du 12 avril 2026 à 18:57
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
Stack compose dans /home/loic/mediawiki ; 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/mediawiki/compose.yaml
- /home/loic/mediawiki/.env
- /home/loic/mediawiki/app/LocalSettings.php
- /home/loic/mediawiki/docs/README.md
Paramètres clés à documenter dans le compose
Cette page suppose que le compose local est la source de vérité. Pour rester exploitable en maintenance, il faut considérer ces éléments comme prioritaires :
- image de `mediawiki-app`
- image de `mediawiki-db`
- variables injectées via `.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 :
- depuis /home/loic/mediawiki, relancer la stack compose selon la méthode utilisée sur l'hôte
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
Comme la commande exacte de compose n'est pas recopiée ici, la règle documentaire est : documenter explicitement la commande réelle utilisée dès qu'une modification est faite sur cette stack.
Remarques
Le wiki héberge la documentation d'installation, la trace logicielle et les intégrations Mermaid / PlantUML / BPMN JS.
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 la stack compose 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 compose, 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.