From ce9e3883addd306c3ba15b14e2e1ef73f2232fa6 Mon Sep 17 00:00:00 2001
From: Gabriel Omar Cotelli <g.cotelli@gmail.com>
Date: Mon, 31 Jul 2023 11:31:21 -0300
Subject: [PATCH] Update docs and examples

---
 docs/reference/DockerImages.md    | 19 +++++++++++++++++++
 examples/docker-compose.build.yml | 19 +++++++++++++++++++
 examples/docker-compose.yml       |  6 +-----
 3 files changed, 39 insertions(+), 5 deletions(-)
 create mode 100644 docs/reference/DockerImages.md
 create mode 100644 examples/docker-compose.build.yml

diff --git a/docs/reference/DockerImages.md b/docs/reference/DockerImages.md
new file mode 100644
index 0000000..03aac40
--- /dev/null
+++ b/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.
diff --git a/examples/docker-compose.build.yml b/examples/docker-compose.build.yml
new file mode 100644
index 0000000..f552542
--- /dev/null
+++ b/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
diff --git a/examples/docker-compose.yml b/examples/docker-compose.yml
index f552542..fa34c37 100644
--- a/examples/docker-compose.yml
+++ b/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: