0 Votes

Code source wiki de Xwiki

Version 1.1 par john le 2026/09/18 22:30

Afficher les derniers auteurs
1 Le wiki qui héberge cette documentation.
2
3 == Architecture ==
4
5 |=Conteneur|=Rôle
6 |xwiki-mariadb-tomcat-web|XWiki (version LTS) sur Tomcat
7 |xwiki-mariadb-db|Base MariaDB
8
9 == Stack ==
10
11 {{code language="yaml"}}
12 networks:
13 xwiki:
14 driver: bridge
15 proxy:
16 external: true
17 services:
18 db:
19 image: mariadb:10.5
20 container_name: xwiki-mariadb-db
21 restart: unless-stopped
22 environment:
23 - MYSQL_ROOT_PASSWORD=<MOT_DE_PASSE_ROOT>
24 - MYSQL_DATABASE=<BASE>
25 - MYSQL_USER=<UTILISATEUR>
26 - MYSQL_PASSWORD=<MOT_DE_PASSE>
27 volumes:
28 - <APPDATA>/xwiki/xwiki.cnf:/etc/mysql/conf.d/xwiki.cnf
29 - <APPDATA>/xwiki/mariadb:/var/lib/mysql
30 - ./init.sql:/docker-entrypoint-initdb.d/init.sql
31 networks:
32 - xwiki
33 web:
34 image: xwiki:lts-mariadb-tomcat
35 container_name: xwiki-mariadb-tomcat-web
36 depends_on:
37 - db
38 restart: unless-stopped
39 environment:
40 - DB_USER=<UTILISATEUR>
41 - DB_PASSWORD=<MOT_DE_PASSE>
42 - DB_HOST=xwiki-mariadb-db
43 - JAVA_OPTS=-Xmx1024m -Denvironment.permanentDirectory=/usr/local/xwiki -Dxwiki.data.dir=/usr/local/xwiki -Dxwiki.store.attachment.hint=file -Dxwiki.store.attachment.versioning.hint=file
44 volumes:
45 - <APPDATA>/xwiki/data:/usr/local/xwiki
46 - <APPDATA>/xwiki/xwiki.cfg:/usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.cfg
47 - <APPDATA>/xwiki/server.xml:/usr/local/tomcat/conf/server.xml
48 ports:
49 - "8080:8080"
50 networks:
51 - xwiki
52 - proxy
53 {{/code}}
54
55 == Fichiers de configuration ==
56
57 |=Fichier|=Rôle
58 |##xwiki.cnf##|Réglages MariaDB propres à XWiki
59 |##init.sql##|Initialisation de la base, au premier démarrage uniquement (chemin relatif au dossier de la stack Portainer)
60 |##xwiki.cfg##|Configuration de XWiki
61 |##server.xml##|Configuration de Tomcat
62
63 {{warning}}
64 ##xwiki.cfg## et ##server.xml## remplacent ceux de l'image. Après une montée de version de XWiki ou de Tomcat, vérifier dans les notes de version s'ils ont changé ; un fichier ancien peut empêcher le démarrage.
65 {{/warning}}
66
67 == Données ==
68
69 * Répertoire permanent : ##<APPDATA>/xwiki/data##, monté sur ##/usr/local/xwiki##. Les données de XWiki sont dans le sous-dossier ##data##, d'où le double ##data## dans le chemin sur l'hôte.
70 * Pièces jointes et leur historique stockés en fichiers (##attachment.hint=file##), pas dans la base.
71 * Index de recherche Solr dans ##data/store/solr## et ##data/cache/solr## : ils se reconstruisent à partir de la base (voir [[Dépannage>>Wiki Batcave John.Infrastructure.ServeurPrincipal.Depannage.WebHome]]).
72
73 == Mémoire ==
74
75 ##-Xmx1024m## limite la mémoire Java à 1 Go. Si le wiki ralentit ou s'arrête avec une erreur ##OutOfMemoryError## dans les journaux, augmenter cette valeur.
76
77 == Sauvegarde ==
78
79 * Base : dump SQL de ##xwiki-mariadb-db## par le script de [[Sauvegarde>>Wiki Batcave John.Infrastructure.Sauvegarde.WebHome]]. Les fichiers bruts ##xwiki/mariadb## sont exclus.
80 * Pièces jointes et configuration : ##<APPDATA>/xwiki##, sauvegardé tel quel.