From 503ceb625bbd971fb3bf62b51ef2d8c1e343abf4 Mon Sep 17 00:00:00 2001
From: afischerdev <afischer@dbserv.de>
Date: Fri, 9 Feb 2024 12:34:56 +0100
Subject: [PATCH] added docker doc with command samples

---
 docs/developers/docker_guide.md | 125 ++++++++++++++++++++++++++++++++
 1 file changed, 125 insertions(+)
 create mode 100644 docs/developers/docker_guide.md

diff --git a/docs/developers/docker_guide.md b/docs/developers/docker_guide.md
new file mode 100644
index 0000000..990d8e9
--- /dev/null
+++ b/docs/developers/docker_guide.md
@@ -0,0 +1,125 @@
+---
+parent: Developers
+---
+
+# Docker help
+
+In addition to the intro in readme.md about Docker, here are a few commands for daily work with the system.
+
+Build the Docker with a version based name
+```
+$ docker build -t brouter-1.7.2 .
+```
+
+Start Docker with name additional to the Docker image name.
+Please note:
+The path for segments are on a Windows system.
+Here the port used in server.sh is published.
+```
+$ docker run --rm -v "I:/Data/test/segment4":/segments4 --publish 17777:17777 --name brouter-1.7.2 brouter-1.7.2
+```
+
+and with a mount for profiles as well
+```
+$ docker run --rm -v "I:/Data/test/segment4":/segments4 -v "I:/Data/test/profiles2":/profiles2 --name brouter-1.7.2 brouter-1.7.2
+```
+
+Show the running Docker processes
+```
+$ docker ps
+
+output:
+CONTAINER ID   IMAGE           COMMAND                  CREATED         STATUS         PORTS                      NAMES
+b23518e8791d   brouter-1.7.2   "/bin/sh -c /bin/ser…"   5 minutes ago   Up 5 minutes   0.0.0.0:17777->17777/tcp   brouter-1.7.2
+```
+
+Fire some curl or wget commands to test if is realy useful running.
+
+Stop a running Docker image - please note, this only works when starts docker image with name, see above
+```
+$ docker stop brouter-1.7.2
+```
+
+Docker available images
+
+```
+$ docker images
+
+output:
+REPOSITORY                     TAG                                        IMAGE ID       CREATED              SIZE
+brouter-1.7.2                  latest                                     e39703dec2fa   2 hours ago          410MB
+brouter                        latest                                     728f122c7388   3 hours ago          410MB
+```
+
+Control
+## Docker with docker-compose
+
+Use a git clone to build a local folder with last version.
+Make a Docker container with version number inside your repository folder.
+```
+$ docker build -t brouter:1.7.2 .
+
+$ docker images
+
+REPOSITORY                     TAG                                        IMAGE ID       CREATED          SIZE
+brouter-1.7.2                  latest                                     e39703dec2fa   3 hours ago      410MB
+brouter                        1.7.2                                      e39703dec2fa   3 hours ago      410MB
+```
+
+Start a container with composer
+This needs a docker config file docker-compose.yml
+Something like this:
+```
+version: '2'
+services:
+  brouter:
+    image: brouter:1.7.2
+    restart: unless-stopped
+    ports:
+      - 17777:17777
+    volumes:
+      - type: bind
+        source: "I:/Data/test/segment4"
+        target: /segments4
+#      - type: bind
+#        source: "I:/Data/test/profiles2"
+#        target: /profiles2
+```
+
+Start it
+```
+$ docker-compose up -d
+```
+
+Have a look what is running
+```
+$ docker-compose ps
+or
+$ docker-compose ls
+or
+$ docker ps
+```
+
+
+Now update your repository (git pull) and build your Docker container with the new version tag
+```
+$ docker build -t brouter:1.7.3 .
+
+$ docker images
+
+REPOSITORY                     TAG                                        IMAGE ID       CREATED         SIZE
+brouter                        1.7.3                                      5edc998cb5ae   3 hours ago     410MB
+brouter-1.7.2                  latest                                     e39703dec2fa   6 hours ago     410MB
+```
+
+Replace the version in Docker config file docker-compose.yml
+```
+    image: brouter:1.7.3
+```
+
+Stop old running container and start the new one
+```
+$ docker-compose down
+
+$ docker-compose up -d
+```