[CareTech] Update doc

parent 7359d512
# Caretech
Ce dossier contient les fichiers nécessaires au déploiement des services hébergées pour le Caretech.
Ce dossier contient les fichiers nécessaires au déploiement des services hébergées pour le CareTech.
Chaque service a son propre sous-dossier.
Chaque service a son propre sous-dossier avec sa documentation.
......@@ -8,6 +8,10 @@ Cette image Docker essentiellement utilise le package Python `umap-project`, et
Lors du lancement de l'application, les fichiers statiques sont copiés dans `/srv/umap/static`. Le fichier [uwsgi.ini](./uwsgi.ini) permet justement de router les requêtes qui commencent par `/static` vers ce dossier.
Seuls les utilisateurs authentifiés peuvent créer une carte. L'enregistrement de nouveaux utilisateurs n'est pas autorisée.
Attention : par défaut, les cartes sont **publiques** : il faudra, pour chaque carte, rendre la carte [uniquement accessible aux éditeurs](https://wiki.openstreetmap.org/wiki/UMap/FAQ#How_to_make_a_.22private.22_uMap.3F).
## Configuration
L'ensemble de la configuration se fait via l'environnement.
......@@ -17,28 +21,49 @@ Les variables sont réparties entre le fichier Compose et les fichiers de secret
## Lancement
S'assurer que l'image a été construite et poussée sur le registre de production.
S'assurer que l'image a été construite et poussée sur le registre de production et que les fichiers `.secrets` sont créés.
```bash
docker-compose up -d && docker-compose logs -f
```
L'interface d'administration est accessible à `carte.caretech.picasoft.net/admin`.
L'interface d'administration est accessible à https://carte.caretech.picasoft.net/admin.
### Premier lancement
#### Création de l'administrateur
Dans la configuration actuelle, l'instance est fermée et les comptes doivent être créés manuellement.
En particulier, un compte administrateur doit être créé au premier lancement.
```bash
docker-compose exec app bash
umap createsuperuser
$ docker-compose exec app bash
$ umap createsuperuser
# Example
Loaded local config from /srv/umap/settings.py
Utilisateur: caretech
Adresse électronique: caretech@xxx
Password:
Password (again):
Superuser created successfully.
```
Remplir les différents champs.
On se rend dans l'interface d'administration
#### Configuration des fonds de carte
On se rend dans l'interface d'administration (https://carte.caretech.picasoft.net/admin/).
Les URL à ajouter pour les fonds de carte peuvent être trouvées ici : https://wiki.openstreetmap.org/wiki/Tile_servers
Par exemple, on ajoutera OpenStreetMap-FR et on lui donnera une priorité plus élevée que le fond de carte présent par défaut (Positron) : c'est vraisemblablement lui qui sera utilisé :
* URL : `https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png`
* Attribution : `© Openstreetmap France | Données © [[https://www.openstreetmap.org/copyright|les contributeurs OpenStreetMap]]`
* Rang : 1
On peut ensuite naviguer entre les deux fonds de carte.
## Mise à jour
......
# Very long and random key
SECRET_KEY=
# Email, comma-separated
ADMIN_EMAIL=
# Database URL
DATABASE_URL=postgis://user:password@umap-db-caretech/caretech
......@@ -17,12 +17,17 @@ Lancer `docker-compose up -d && docker-compose logs -f` et vérifier qu'il n'y a
Lors du premier lancement, en consultant le site, on arrivera sur une page permettant de finaliser l'installation.
### Création du compte administrateur
En particulier, on va créer un compte administrateur.
On choisit un email et un mot de passe et on remplit l'URL du wiki (celle par laquelle on est arrivé sur la page).
On choisit un email et un mot de passe et on remplit l'URL du wiki (celle par laquelle on est arrivé sur la page). L'email n'a pas besoin d'exister pour le compte administrateur : il fait office de login.
On désactive la télémétrie.
On arrive ensuite sur une page permettant de créer la page d'accueil du wiki.
À partir d'ici, on configurera ce que l'on veut dans l'interface d'administration (https://wiki.caretech.picasoft.net/a) : thème, permissions, langue... On se réferera à la documentation officielle.
Par défaut, seul l'administrateur pourra se connecter, les inscriptions ne sont pas ouvertes.
## Mise à jour
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment