[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [taler-merchant] branch master updated: Docker deployment i
From: |
gnunet |
Subject: |
[GNUnet-SVN] [taler-merchant] branch master updated: Docker deployment instructions |
Date: |
Sun, 08 Jan 2017 10:53:10 +0100 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] [taler-merchant] branch master updated: Docker deployment instructions,
gnunet <=