commit 772d3d0f28250d2dbf57861a9d83e943bc8cdfad
parent e48900b7496e63d09a5c70963af60e052038fc64
Author: MS <ms@taler.net>
Date: Fri, 18 Nov 2022 13:13:10 +0100
How to install Docker.
And mention SystemD unit files related to test-worker
and walletbuilder.
Diffstat:
1 file changed, 25 insertions(+), 9 deletions(-)
diff --git a/taler-developer-manual.rst b/taler-developer-manual.rst
@@ -295,12 +295,21 @@ Demo Upgrade Procedure
#. 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``.
+The deployment is based on rootless Docker, managed by the
+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``.
+
+.. note::
+
+ Should the rootless Docker be installed, run the following command
+ or consult the `official documentation <https://docs.docker.com/engine/security/rootless/>`_.
+
+ .. code-block:: console
+
+ $ curl -fsSL https://get.docker.com/rootless | sh
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
@@ -383,14 +392,21 @@ Test builder
------------
This builder (``test-builder``) compiles and starts every Taler component.
-It is run by the ``taler-test`` Gv user.
+The associated worker is run by the ``taler-test`` Gv user, via the SystemD
+unit ``buildbot-worker-taler``.
+
+.. note::
+ the mentioned unit file can be found at ``deployment.git/systemd-services/``
Wallet builder
--------------
This builder (``wallet-builder``) compiles every Taler component
-and runs the wallet integration tests. It is run by the ``walletbuilder``
-Gv user.
+and runs the wallet integration tests. The associated worker is
+run by the ``walletbuilder`` Gv user, via the SystemD unit ``buildbot-worker-wallet``.
+
+.. note::
+ the mentioned unit file can be found at ``deployment.git/systemd-services/``
Documentation Builder
---------------------
