commit 2650fea7045c41b335e222a8e3af19cb714fa0ab parent 572251e5cfd38354d2d4fd0854f7c83bda0dab04 Author: MS <ms@taler.net> Date: Sat, 12 Nov 2022 13:45:59 +0100 deployment instructions Diffstat:
| M | taler-developer-manual.rst | | | 36 | ++++++++++++++++++++++++++++++++---- |
1 file changed, 32 insertions(+), 4 deletions(-)
diff --git 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 ------------------