--- a/dev/README.md Thu Mar 15 23:52:11 2018 +0100
+++ b/dev/README.md Fri Mar 16 12:29:12 2018 +0100
@@ -1,16 +1,40 @@
# HDALab Docker images
-- restore database
--
+L'application HDALab a été conteneurisée en 5 services dont 2 nécessite la construction d'une image.
+Les services sont orchestrés avec l'application `docker-compose`.
+L'ensemble expose les ports suivant sur l'ordinateur hôte:
+ - port 8080 : l'interface web HDALab
+ - port 8025 : Accès à l'interface de consultation [mailhog](https://github.com/mailhog/MailHog).
+ - port 5432 : port serveur postgresql
+
+## Mise place des images conteneurs docker
+
+Deux possibilités existent pour mettre en place les images docker :
+ - construire les images
+ - import des images
+
+### Construction des images
+Les commandes suivantes permettent de construire les images. Ces commandes sont à lancer dans le même répertoire que le fichier `docker-compose.yml`.
+
+```
+$ ./prepare_docker_build.sh
+$ docker-compose -p hdalab build
+```
+
+### Import des images
+
+Lancer cette commande pour charger les images du projet.
+
+```
+$ docker load -i <chemin/vers/fichier/archives/images>
+```
## Comment construire les container HDALab
Toutes les commandes suivantes sont à effectuer dans le répertoire contenant le fichier `docker-compose.yml`.
```
-$ ./prepare_docker_build.sh
-$ docker-compose -p hdalab build
$ docker-compose -p hdalab up -d
$ docker-compose -p hdalab exec hdalab django-admin collectstatic --noinput
$ docker-compose -p hdalab exec hdalab django-admin migrate --noinput
@@ -30,7 +54,7 @@
### Import des données issues de l'export HDA
Cette commande importe les données RDF exportées à partir de l'application HDA.
-Attention cette commande peut être longue.
+Attention cette commande peut être longue (plusieurs heures).
```
$ docker-compose -p hdalab exec hdalab /usr/local/sbin/import_hda_rdf.sh /etc/hdalab/data /var/lib/hdalab http://data.culture.fr/entrepot/HDA/export.tgz
@@ -63,7 +87,6 @@
```
-
# Commandes utiles
## liste des services
@@ -129,3 +152,10 @@
$ echo "drop database hdalab;\ncreate database hdalab owner iri encoding 'utf-8';" | docker exec -i hdalab_pg_1 psql -U iri postgres
```
+## Accès à la base de donnée
+
+Le port postgresql 5432 est ouvert sur l'ordinateur hôte.
+La base utilisée par l'application est `hdalab`.
+L'utilisateur et mot de passe pour y accéder sont :
+ - utilisateur: `iri`
+ - mot de passe: `iri`