[taler-docs] branch master updated: deployment instructions

[gnunet]

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

ms pushed a commit to branch master
in repository docs.

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

commit 2650fea7045c41b335e222a8e3af19cb714fa0ab
Author: MS <ms@taler.net>
AuthorDate: Sat Nov 12 13:45:59 2022 +0100

    deployment instructions
---
 taler-developer-manual.rst | 36 ++++++++++++++++++++++++++++++++----
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/taler-developer-manual.rst b/taler-developer-manual.rst
index 5608cb8..0a3b16f 100644
--- a/taler-developer-manual.rst
+++ b/taler-developer-manual.rst
@@ -292,19 +292,47 @@ Demo Upgrade Procedure
 
 #. Login as the ``demo`` user on ``gv.taler.net``.
 #. Pull the latest ``deployment.git`` code.
-#.  Navigate to the ``deployment.git/docker/demo`` directory.
-#.  The README file is the reference about building and running the services.
+#. Navigate to the ``deployment.git/docker/demo`` directory.
+#. Refer to the README, or the smaller cheat sheet below.
+
+The deployment is based on rootless Docker, that is
+a SystemD unit in userspace: ``docker.service``.  The
+running daemon is reached by every Docker command at the
+address held into the ``DOCKER_HOST`` environment variable.
+Normally, it points to ``unix:///run/user/$(id -u)/docker.sock``.
+Such variable is automatically exported by ``~/.bashrc``.
 
 Upgrading the ``demo`` environment should be done with care, and ideally be
 coordinated on the mailing list before.  It is our goal for ``demo`` to always
 run a "working version" that is compatible with various published wallets.
-
 Please use the :doc:`demo upgrade checklist <checklist-demo-upgrade>` to make
 sure everything is working.
-
 Nginx is already configured to reach the services as exported by
 Docker Compose.
 
+
+Cheat sheet
+-----------
+
+All commands run from deployment.git/docker/demo.
+
+.. code-block:: console
+
+  # Start services.
+  $ docker-compose start --remove-orphans -d
+ 
+  # Stop services.
+  $ docker-compose stop
+ 
+  # Build base image (without tags-file builds master)
+  $ ./build_base.sh images/base/Dockerfile [tags-file]
+
+  # Build all the services based on the latest base image
+  $ docker-compose build
+
+  # View live logs of the daemonized services.
+  $ docker-compose logs
+
 Tagging components
 ------------------
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.