[GNUnet-SVN] [taler-merchant] branch master updated: Docker deployment instructions

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository merchant.

The following commit(s) were added to refs/heads/master by this push:
     new 99925fb  Docker deployment instructions
99925fb is described below

commit 99925fb7652487c56a3c813bea92313a732a5bbb
Author: Marcello Stanisci <address@hidden>
AuthorDate: Sun Jan 8 10:52:58 2017 +0100

    Docker deployment instructions
---
 doc/manual.texi  | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 doc/version.texi |  4 ++--
 2 files changed, 58 insertions(+), 3 deletions(-)

diff --git a/doc/manual.texi b/doc/manual.texi
index 3fe6c89..b97fe4e 100644
--- a/doc/manual.texi
+++ b/doc/manual.texi
@@ -175,7 +175,7 @@ account information is encapsulated within the Taler 
backend.
 * generic-instructions:: Generic installation guidelines
 * Installing Taler on Debian GNU/Linux:: Installing Taler on Debian GNU/Linux
 @c * Installing Taler with GNU Guix:: Installing Taler with GNU Guix
address@hidden * Installing Taler using Docker:: Installing Taler using Docker
+* Installing Taler using Docker:: Installing Taler using Docker
 @c * Installing Taler on Arch Linux:: Installing Taler on Arch Linux
 @c * Installing Taler on Windows:: Installing Taler on Windows
 @c * Installing Taler on OS X:: Installing Taler on OS X
@@ -185,6 +185,61 @@ account information is encapsulated within the Taler 
backend.
 
 This chapter describes how to install the GNU Taler merchant backend.
 
address@hidden Installing Taler using Docker
address@hidden Installing Taler using Docker
+
+This section provides instructions for the merchant backend
+installation using `Docker`.
+
+For security reasons, we run Docker against a VirtualBox instance,
+so the @code{docker} command should connect to a @code{docker-machine}
+instance that uses the VirtualBox driver.
+
+Therefore, the needed tools are: ``docker``, ``docker-machine``, and
+``docker-compose``.  Please refer to Docker's official
address@hidden://docs.docker.com/}documentation in order
+to get those components installed, as that is not in this manual's scope.
+
+Before starting to build the merchant's image, make sure a
+``docker-machine`` instance is up and running.
+
+Because all of the Docker source file are kept in our ``deployment``
+repository, we start by checking out the
address@hidden://taler.net/deployment} codebase:
+
address@hidden
+$ git clone git://taler.net/deployment
address@hidden smallexample
+
+Now we actually build the merchant's image.  From the same
+directory as above:
+
address@hidden
+$ cd deployment/docker/merchant/
+$ docker-compose build
address@hidden smallexample
+
+If everything worked as expected, the merchant is ready to be
+launched.  From the same directory as the previous step:
+
address@hidden
+# Recall: the docker-machine should be up and running.
+$ docker-compose up
address@hidden smallexample
+
+You should see some live logging from all the involved containers.
+At this stage of development, you should also ignore some (harmless)
+error message from postresql about already existing roles and databases.
+
+To test if everything worked as expected, it suffices to issue a
+simple request to the merchant, as:
+
address@hidden
+$ curl http://$(docker-machine ip)/
+# A greeting message should be returned by the merchant.
address@hidden smallexample
+
+
 @node generic-instructions
 @section Generic instructions
 
diff --git a/doc/version.texi b/doc/version.texi
index 3e3136f..13bfa00 100644
--- a/doc/version.texi
+++ b/doc/version.texi
@@ -1,4 +1,4 @@
address@hidden UPDATED 18 November 2016
address@hidden UPDATED-MONTH November 2016
address@hidden UPDATED 8 January 2017
address@hidden UPDATED-MONTH January 2017
 @set EDITION 0.2.0
 @set VERSION 0.2.0

-- 
To stop receiving notification emails like this one, please contact
address@hidden