WikiJS est un moteur de wiki très puissant et très flexible, en plus d'être moderne et assez joli. Des réflexions sont en cours sur le remplacement du wiki actuel, mal organisé avec un moteur peu efficace.
La VM est hérbergée sur le virtualiseur odin. Elle a pour ip 10.128.0.66
et a pour FQDN wikijs.adm.auro.re.
Le service est lui accessible pour l'instant sur https://wikijs.auro.re/.
La documentation du service est disponible ici : https://docs.requarks.io/
Le code source est disponible sur Github, sous licence AGPLv3 : https://github.com/Requarks/wiki
Le service WikiJS tourne sur la VM wikijs.adm.auro.re
, sur le virtualiseur odin. 2 coeurs, 1 Go de RAM et 15 Go de stockage (dont 2 Go de swap, 4 Go de /
, 4 Go de /var
et le reste de /var/lib/docker
) sont alloués. La machine tourne sur Debian Buster et utilise Docker.
L'image Docker officielle de WikiJS est utilisée, avec un fichier /var/local/ansible-docker/wikijs-docker/docker-compose.yml
assez minimaliste :
version: '3.3'
services:
wiki:
image: requarks/wiki:2
environment:
DB_TYPE: postgres
DB_HOST: services-bdd-local.adm.auro.re
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: ${DB_PASS}
DB_NAME: wikijs
restart: unless-stopped
ports:
- "3000:3000"
Le mot de passe de la base de données doit être entré dans un fichier .env
lisible par l'utilisateur root seulement.
Avant de lancer, il faut d'abord créer la base de données, sur la VM services-bdd-local.adm.auro.re :
# su postgres -c "createuser wikijs -P"
# su postgres -c "createdb wikijs -O wikijs"
Et on oublie pas d'ajouter la ligne dans /etc/postgresql/11/main/pg_hba.conf
permettant à la VM WikiJS de se connecter :
host wikijs wikijs 10.128.0.66/32 md5
Le service se démarre ensuite simplement comme un service Docker :
# docker-compose up -d wiki
Pour mettre à jour WikiJS, il suffit uniquement de retélécharger la nouvelle image et de recréer le conteneur, comme l'indique la documentation officielle : https://docs.requarks.io/install/upgrade
# docker-compose pull wiki
# docker-compose up -d --force-recreate wiki
On veut que les comptes sur le Wiki soient liés avec les comptes utilisateurs Aurore. Sur l'interface administrateur (accessible après avoir créé un premier compte admin local), on se rend dans l'onglet « Authentification », puis « Ajouter une stratégie » et enfin « LDAP / Active Directory ».
On s'assure qu'un service LDAP de type readonly avec pour nom Wiki.js a bien été créé sur Re2o.
On rentre donc les paramètres :
LDAP URL : ldap://re2o-ldap.adm.auro.re:389
Admin Bind DN : cn=wikijs,ou=service-users,dc=auro,dc=re
Admin Bind Credentials : Mot de passe transmis à Re2o
Search base : cn=Utilisateurs,dc=auro,dc=re
Search filter : (uid={{username}})
Use TLS : non
Verify TLS certificates : non
Unique ID Field Mapping : uid
Email Field Mapping : mail
Display Name Field Mapping : uid
Avatar Picture Field Mapping (inutilisé) : None
Autoriser l'auto-inscription : oui
On peut ensuite tester que les paramètres de connexion fonctionnent correctement.