# Role : docker_wikijs


## Services fournis

- main.yml : Installation de wikijs sur un serveur docker_host
- configure_reverse_proxy.yml : Configuration d'un reverse proxy préalablement installé par le role reverse_proxy


## Variables

Fournir les variables suivantes. Par exemple :

```yaml
docker_wikijs_fqdn: wiki.libretic.fr
docker_wikijs_data_dir: /data1
docker_wikijs_service_id: wikijs
docker_wikijs_db_name: wikijs
docker_wikijs_db_user: wikijsdbuser
docker_wikijs_db_password: mdp_de_wikijsdbuser
docker_wikijs_rp_cert: LE
docker_wikijs_rp_docker_host: machine.domaine.local
docker_wikijs_rp_access_policy: OpenAccessPolicy
docker_wikijs_rp_indexing: AllowCrawlerIndexing
docker_wikijs_rp_waf: "On"
```

| Option                         | Valeur par défaut | Description                                                                               |
|--------------------------------|-------------------|-------------------------------------------------------------------------------------------|
| docker_wikijs_fqdn             |                   | Le nom de domaine pour lequel le service wikijs répond                                    |
| docker_wikijs_data_dir         |                   | L'emplacement dans lequel se trouvent les volumes de donnees docker pour le service       |
| docker_wikijs_service_id       |                   | Le nom de service souhaité : conditionne le nommage des volumes et le routage par traefik |
| docker_wikijs_db_name          |                   | Nom de la base de données postgres pour wikijs                                            |
| docker_wikijs_db_user          |                   | Nom du user postgres propriétaire de la base de données                                   |
| docker_wikijs_db_password      |                   | Mot du passe du user postgres                                                             |
| docker_wikijs_rp_docker_host   |                   | pour configure_reverse_proxy.yml: fqdn de la machine contenant le conteneur docker        |
| docker_wikijs_rp_cert          | LE                | Type de certificat pour le reverse proxy (LE = letsencrypt)                               |
| docker_wikijs_rp_access_policy |                   | Modèle d'autorisation d'accès du reverse proxy                                            |
| docker_wikijs_rp_indexing      |                   | Stratégie du reverse proxy vis à vis des robots                                           |
| docker_wikijs_rp_waf           |                   | Activation websecurity du reverse proxy                                                   |



## Fichier definition.yml

Le fichier definition.yml d'origine de wikijs est remplacé afin de modifier le nom des scopes openid. Surveiller les nouvelles versions de ce fichier dans les futures images et le corriger le cas échéant.

```
scopes:
  - profile
  - libreticMail
```


## Poursuite de l'installation dans wikijs

Après le premier lancement :
- créer le compte administrateur
- créer la configuration openid connect ; détails dans [le wiki libretic](https://wiki.libretic.fr)