issue2551163 - add starter docker

This works but I should be able to shrink it by 10MB (to 75 or so) by
doing a multi-stage build.

Also this only supports anydbm/sqlite at the moment. So the saved
space will be used by mysql and pgsql drivers before I am done.

Based on alipine linux python image. Invoke with:

  docker run --rm -v /.../issue.tracker:/usr/src/app/tracker \
      -p 9017:8080 roundup-app:latest

you can also append tracker specifications like:

  inhouse=tracker/inhouse customer=tracker/customer

to the docker command to start up two trackers on the two tracker
homes on the volume mounted at (/usr/src/apps/) tracker.

Author: rouilj

scripts/Dockerfile

@@ -0,0 +1,70 @@
+# build in root dir using:
+#     docker build -t roundup-app --rm -f Dockerfile ..
+#
+# run using:
+#    docker run --rm -v /home/rouilj/develop/roundup.sysadmin/issue.tracker:/usr/src/app/tracker -p 9017:8080 roundup-app:latest
+
+FROM python:3-alpine
+
+ENV appdir=/usr/src/app
+WORKDIR $appdir
+
+# allow roundup install from local directory or from pypi
+ARG source=local
+
+LABEL "org.roundup-tracker.vendor"="Roundup Issue Tracker Team" \
+      "org.roundup-tracker.description"="Roundup Issue Tracker using sqlite" \
+      "version"="2.1.0 $source"
+
+# add requirements for pip here, e.g. pytz or other modules
+#  ignore warnings from pip to use virtualenv
+COPY scripts/requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# copy the elements of the release directory to the docker image
+COPY setup.py install/
+COPY doc install/doc/
+COPY frontends install/frontends/
+COPY locale install/locale/
+COPY roundup install/roundup/
+COPY share install/share/
+
+# verify source has one of two valid values then
+# install in python3 standard directories from local copy
+# or install in python3 standard directories from pypi using pip
+
+RUN if [ "$source" == "local" ] || [ "$source" == "pypi" ]; then :; \
+           else echo "invalid value for source: $source"; \
+                echo "must be local or pypi"; exit 1; fi; \
+    if [ "$source" == "local" ]; then cd install && ./setup.py install; fi; \
+    if [ "$source" == "pypi" ]; then pip install roundup; fi
+
+# delete source files
+RUN rm -rf install
+
+# map port 8080 to your local port
+EXPOSE 8080/tcp
+
+# mount a trackerdir on tracker location
+RUN mkdir tracker
+VOLUME $appdir/tracker
+
+# do not run roundup as root
+RUN adduser -D roundup
+
+# run the server
+USER roundup
+ENTRYPOINT [ "roundup-server", "-L", "-n", "0.0.0.0" ]
+
+# allow the invoker to override cmd with multiple trackers
+# in each subdirectory under $appdir/tracker. E.G.
+# docker run .... \
+#   issues=tracker/issues foo=tracker/foo
+#
+# note using "issue=$appdir/tracker" results in error:
+#
+#  No valid configuration files found in directory /usr/src/app/$appdir/tracker
+#
+# so $appdir not expanded and $PWD prefixed onto the (relative path)
+#   $appdir/tracker. Hence use relative path for spec.
+CMD [  "issues=tracker" ]

scripts/requirements.txt

@@ -0,0 +1,15 @@
+# human timezones
+pytz
+# indexer
+Whoosh
+# databases - need devel and other files installed to be built.
+#psycopg2==2.7.4
+#mysqlclient==1.3.10
+# encryption - need additional packages
+#gpg==1.10.0
+# java web tokens
+PyJWT==1.7.1
+# extra compression support - build needs gcc
+#Brotli==1.0.4
+#zstd==1.5.0.2
+