dev/README.md
changeset 687 53fee689f666
parent 686 385e3a12ee27
child 690 5b6102a80205
--- 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`