Merge pull request #91 from singlethink/feature-dockerize

Add Dockerfiles and scripts to build docker containers for dzcb

Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3
+
+ENV UID=1000
+ENV GID=1000
+
+RUN groupadd --gid ${GID} app && \
+    useradd --uid ${UID} --gid ${GID} -m --home /app app
+
+COPY . /app/dzcb
+RUN chown -R ${UID}:${GID} /app/dzcb
+
+WORKDIR /app
+USER app
+
+RUN pip install --user /app/dzcb && \
+    rm -rf /app/dzcb
+
+ENTRYPOINT [ "python", "-m", "dzcb" ]
+CMD []

Dockerfile.dev

@@ -0,0 +1,18 @@
+FROM python:3
+
+ENV UID=1000
+ENV GID=1000
+
+RUN groupadd --gid ${GID} app && \
+    useradd --uid ${UID} --gid ${GID} -m --home /app app
+
+COPY . /app/dzcb
+RUN chown -R ${UID}:${GID} /app/dzcb
+
+WORKDIR /app
+USER app
+
+RUN pip install --user -e /app/dzcb pytest
+
+ENTRYPOINT [ "/bin/bash" ]
+CMD []

README.md

@@ -291,6 +291,27 @@ python -m dzcb \
     --dmrconfig -- /tmp/my-codeplug
 ```
 
+## Docker Container
+
+A docker container for dzcb can be built and run as follows:
+
+```
+# Build container
+tools/build_docker.sh
+
+# Run dzcb
+docker run --rm -ti \
+      -v /tmp/my-codeplug:/my-codeplug \
+      dzcb \
+      --pnwdigital \
+      --seattledmr \
+      --default-k7abd \
+      --dmrconfig \
+      -- \
+      /my-codeplug
+```
+
+
 # Complex Usage
 
 See **[WALKTHROUGH](./doc/WALKTHROUGH.md)** for a step-by-step guide
@@ -371,6 +392,21 @@ for the implementation details.
 
 pip install -e ./dzcb
 
+## Development Docker Container
+
+A docker container for dzcb development can be built and run as follows:
+
+```
+# Build container
+tools/build_docker_dev.sh
+
+# Run dzcb
+docker run --rm -ti \
+      -v /tmp/my-codeplug:/my-codeplug \
+      -v .:/app/dzcb \
+      dzcb:dev
+```
+
 ## Bugs?
 
 Please submit the entire output directory including log files when submitting [issues](/issue/new).

tools/build_docker.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+set -e -o pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+docker buildx build --progress=plain -t dzcb .

tools/build_docker_dev.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+set -e -o pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+docker buildx build --progress=plain -t dzcb:dev -f Dockerfile.dev .