From 47e9bc6387c098ab25a083b17e33f10fdabab096 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Konrad=20H=C3=B6ffner?= <konrad.hoeffner@uni-leipzig.de>
Date: Fri, 23 Sep 2022 13:54:12 +0200
Subject: [PATCH] Add Docker Compose template for SPARQL endpoint and RDF
 browser. Resolve #96.

---
 docker/.env.dist          |  1 +
 docker/README.md          | 13 +++++++++++++
 docker/docker-compose.yml | 35 +++++++++++++++++++++++++++++++++++
 docker/initdb.d/setup.sql |  9 +++++++++
 docker/rdf/example.ttl    | 19 +++++++++++++++++++
 5 files changed, 77 insertions(+)
 create mode 100644 docker/.env.dist
 create mode 100644 docker/README.md
 create mode 100644 docker/docker-compose.yml
 create mode 100644 docker/initdb.d/setup.sql
 create mode 100644 docker/rdf/example.ttl

diff --git a/docker/.env.dist b/docker/.env.dist
new file mode 100644
index 0000000..612efe5
--- /dev/null
+++ b/docker/.env.dist
@@ -0,0 +1 @@
+DBA_PASSWORD=changeme
diff --git a/docker/README.md b/docker/README.md
new file mode 100644
index 0000000..90411a5
--- /dev/null
+++ b/docker/README.md
@@ -0,0 +1,13 @@
+Simple template for a Docker Compose setup with a SPARQL Endpoint and RDF browser for a small knowledge base.
+
+# Run
+
+1. `docker compose up --build`
+2. test the SPARQL endpoint http://localhost:8890/sparql and the RDF browser at http://localhost:8080/
+
+# Adapt
+
+1. replace rdf/example.ttl with your knowledge base
+2. add your namespaces to initdb.d/setup.sql
+3. adapt docker-compose.yml
+4. copy .env.dist to .env and change DBA\_PASSWORD
diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
new file mode 100644
index 0000000..f25b791
--- /dev/null
+++ b/docker/docker-compose.yml
@@ -0,0 +1,35 @@
+services:
+
+  virtuoso:
+    image: openlink/virtuoso-opensource-7
+    environment:
+      - DBA_PASSWORD=${DBA_PASSWORD}
+      - VIRT_DATABASE_ERRORLOGLEVEL=3
+      - VIRT_SPARQL_DEFAULTGRAPH=http://example.org
+      - VIRT_SPARQL_DEFAULTQUERY=select distinct * {?s ?p ?o.} LIMIT 100
+      - VIRT_PARAMETERS_DIRSALLOWED=., /usr/local/virtuoso-opensource/share/virtuoso/vad, /rdf
+      - VIRT_PLUGINS_-=-
+    volumes:
+      - ./rdf:/rdf:ro
+      - ./initdb.d:/opt/virtuoso-opensource/initdb.d:ro
+    ports:
+      - "127.0.0.1:8890:8890"
+    restart: unless-stopped
+
+  rickview:
+    image: ghcr.io/konradhoeffner/rickview:master
+    environment:
+      - RICKVIEW_KB_FILE=/rdf/example.ttl
+      - RICKVIEW_TITLE=Example Title
+      - RICKVIEW_SUBTITLE=Example Subtitle
+      - RICKVIEW_PREFIX=ex
+      - RICKVIEW_NAMESPACE=http://example.org/
+      - RICKVIEW_EXAMPLES=ExClass ExProperty ExInstance
+    volumes:
+      - ./rdf:/rdf:ro
+    ports:
+      - "127.0.0.1:8080:8080"
+    restart: unless-stopped
+
+volumes:
+  rdf:
diff --git a/docker/initdb.d/setup.sql b/docker/initdb.d/setup.sql
new file mode 100644
index 0000000..0409ae8
--- /dev/null
+++ b/docker/initdb.d/setup.sql
@@ -0,0 +1,9 @@
+log_message('Setup: Activate CORS');
+update DB.DBA.HTTP_PATH set HP_OPTIONS = serialize(vector('browse_sheet', '', 'noinherit', 'yes', 'cors', '*', 'cors_restricted', 0))  where HP_LPATH = '/sparql';
+log_message('Setup: Declare namespaces');
+DB.DBA.XML_SET_NS_DECL ('ex', 'http://example.org/', 2);
+log_message('Setup: Load data');
+ld_dir_all ('/rdf/', '*.ttl', 'http://example.org');
+rdf_loader_run();
+log_message('Setup: Finished');
+
diff --git a/docker/rdf/example.ttl b/docker/rdf/example.ttl
new file mode 100644
index 0000000..5c6f79d
--- /dev/null
+++ b/docker/rdf/example.ttl
@@ -0,0 +1,19 @@
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
+@prefix owl: <http://www.w3.org/2002/07/owl#>.
+@prefix ex: <http://example.org/>.
+
+ex:ExClass
+  a owl:Class;
+  rdfs:comment "an example class"@en;
+  rdfs:label "example class"@en.
+
+ex:ExInstance
+  ex:exProperty 5;
+  a ex:ExClass;
+  rdfs:comment "an example instance."@en;
+  rdfs:label "example instance"@en.
+
+ex:exProperty
+  a owl:DatatypeProperty;
+  rdfs:domain ex:ExClass;
+  rdfs:label "Beispielproperty"@de, "example property"@en.