Update docs and examples

docs/reference/DockerImages.md

@@ -0,0 +1,19 @@
+# Docker images reference
+
+## `gs64` base docker image
+
+This container image contains the GemStone/S 64 bits runtime support but doesn't
+provide an `extent0.dbf`. Users will need to map a volume against `/opt/gemstone/data/`
+containing the relevant data files (extents and transaction logs).
+
+## `gs64-rowan` docker image
+
+This container image builds on top of the base image providing the `extent0.rowan.dbf`.
+It's a useful target for a CI system.
+
+## `gs64-rowan-loader` docker image
+
+This container image builds on top of the rowan image installing also git.
+In order to use Rowan for cloning and manipulating remote repositories, users
+will need to map a volume against `/home/gemstone/.ssh/` containing the
+relevant keys.

examples/docker-compose.build.yml

@@ -0,0 +1,19 @@
+version: "3"
+
+services:
+  stone:
+    init: true
+    network_mode: host
+    build:
+      context: ../source
+      target: docker-gs64-rowan-loader
+      args:
+        GS_VERSION: 3.6.6
+    environment:
+      TZ: America/Argentina/Buenos_Aires
+    volumes:
+      - ./conf/:/opt/gemstone/conf/
+      - ./locks/:/opt/gemstone/locks/
+      - ./logs/:/opt/gemstone/logs/
+      - ./projects/:/opt/gemstone/projects/
+      - ~/.ssh/:/home/gemstone/.ssh/:ro

examples/docker-compose.yml

@@ -4,11 +4,7 @@ services:
   stone:
     init: true
     network_mode: host
-    build:
-      context: ../source
-      target: docker-gs64-rowan-loader
-      args:
-        GS_VERSION: 3.6.6
+    image: ghcr.io/ba-st/gs64-rowan-loader:v3.6.6
     environment:
       TZ: America/Argentina/Buenos_Aires
     volumes: