changeset 561:8f075ae6cf33

Improve docker usage and related docs Move backend Dockerfile to canonical place and describe more of the setup in README.
author Tom Gottfried <tom@intevation.de>
date Mon, 03 Sep 2018 19:07:00 +0200
parents 66073a476baf
children 9aabebac1863
files Dockerfile docker/Dockerfile.backend docker/README.md
diffstat 3 files changed, 66 insertions(+), 29 deletions(-) [+]
line wrap: on
line diff
--- a/Dockerfile	Mon Sep 03 18:41:19 2018 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,29 +0,0 @@
-FROM ubuntu:bionic
-LABEL authors="tom.gottfried@intevation.de"
-
-RUN sed -i 's/$/ universe/' /etc/apt/sources.list
-
-RUN apt-get update &&\
-    apt-get -y install --no-install-recommends \
-            make git golang-go golang-github-gorilla-context-dev
-
-WORKDIR /opt/gemma
-
-# Copy only backend stuff
-COPY 3rdpartylibs.sh ./
-COPY pkg ./pkg/
-COPY cmd ./cmd/
-COPY Makefile ./
-COPY example_conf.toml ./
-
-RUN make install
-
-EXPOSE 8000
-
-CMD ["/usr/local/bin/gemma", "-c", "/opt/gemma/example_conf.toml"]
-
-# Run with e.g.
-# docker build -t gemma_backend .
-# docker run --name gemma_backend -v $PWD:/opt/gemma -d -p 8200:8000 \
-#            --link your_gemma_db:gemma_db gemma_backend
-#            --link your_gemma_geoserver:gemma_geoserver gemma_backend
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docker/Dockerfile.backend	Mon Sep 03 19:07:00 2018 +0200
@@ -0,0 +1,23 @@
+FROM ubuntu:bionic
+LABEL authors="tom.gottfried@intevation.de"
+
+RUN sed -i 's/\(deb.*\)$/\1 universe/' /etc/apt/sources.list
+
+RUN apt-get update &&\
+    apt-get -y install --no-install-recommends \
+            make git golang-go golang-github-gorilla-context-dev
+
+WORKDIR /opt/gemma
+
+# Copy only backend stuff
+COPY 3rdpartylibs.sh ./
+COPY pkg ./pkg/
+COPY cmd ./cmd/
+COPY Makefile ./
+COPY example_conf.toml ./
+
+RUN make install
+
+EXPOSE 8000
+
+CMD ["/usr/local/bin/gemma", "-c", "/opt/gemma/example_conf.toml"]
--- a/docker/README.md	Mon Sep 03 18:41:19 2018 +0200
+++ b/docker/README.md	Mon Sep 03 19:07:00 2018 +0200
@@ -38,3 +38,46 @@
 
 Omit the `-s` option to get a diagram with all tables or use any other
 schema name to see other parts of the whole picture.
+
+## Network setup
+
+- Create a network to connect containers:
+  ```
+  docker network create gemma
+  ```
+
+- Connect database to new network
+  ```
+  docker network connect gemma gemma_db
+  ```
+  Use `--alias gemma_db` if your container has a different name
+
+## GeoServer setup
+
+- Build Dockerfile with e.g.:
+  ```
+  docker build -t gemma_geoserver -f docker/Dockerfile.geoserv .
+  ```
+
+- Get a running instance with e.g.:
+  ```
+  docker run --name gemma_geoserver -d -p 8280:8080 --network gemma \
+         gemma_geoserver
+  ```
+  Use `--network-alias gemma_geoserver` if you give your container
+  a different name.
+
+## Gemma backend setup
+
+- Build Dockerfile with e.g.:
+  ```
+  docker build -t gemma_backend -f docker/Dockerfile.backend .
+  ```
+
+- Get a running instance with e.g.:
+  ```
+  docker run --name gemma_backend -v $PWD:/opt/gemma -d -p 8200:8000 \
+             --network gemma gemma_backend
+  ```
+  Use `--network-alias gemma_backend` if you give your container
+  a different name.