ansible-role-docker_wikijs/README.md

# 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_rp_cert: LE
docker_wikijs_docker_host: machine.domaine.local
```

| 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_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)                               |



## 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)