Initial Containerization (#4)

* Add initial docker files

* WIP add dev-related docker files

* WIP try installing node_modules into parent directory of checkout

* WIP

* Run as non-root inside container; fix paths

* Cleanup comment; add missing chown

* fixup comment

* reword

* Add comment

* Use long options

* Rearrange dockerfile lines

* Add docs, example config

* Fixup markdown

* Move USER further down

* Run dc in foreground

* Remove workaround; fixed in #3

* Refactor environment files

* Fixup spelling

Co-authored-by: Hannah <[email protected]>

Co-authored-by: Hannah <[email protected]>

Author: ivan-c

.env.default

@@ -0,0 +1,9 @@
+# Default docker-compose environment file (.env)
+# https://docs.docker.com/compose/environment-variables/#the-env-file
+# environment variables for interpolation in docker-compose YAML files
+# Copy to .env and modify as necessary
+
+COMPOSE_PROJECT_NAME=
+
+# docker-compose development overrides; uncomment to enable
+# COMPOSE_FILE=docker-compose.yaml:docker-compose.dev.yaml

Dockerfile

@@ -0,0 +1,19 @@
+# TODO update to newer version: Active LTS or Current
+FROM node:14
+
+# cache hack (very fragile): initially only copy list of project dependencies
+COPY --chown=node:node package.json package-lock.json /opt/node/
+
+# install node dependencies to parent directory of code
+WORKDIR /opt/node
+USER node
+RUN npm install
+
+# add node modules binary folder to system PATH
+ENV PATH=/opt/node/node_modules/.bin/:$PATH
+
+# copy source code, switch to code directory
+COPY --chown=node:node . /opt/node/app
+WORKDIR /opt/node/app
+
+CMD ["npm", "start"]

README.md

@@ -27,6 +27,19 @@ A number of options are available for local usage to support testing with synthe
 ### Setup
 This project manages dependencies using the [NPM package manager](https://www.npmjs.com/) in the [Node environment](https://nodejs.dev/) (Node version <= 16 is recommended for this application). Make sure to have both NPM and Node installed before proceeding. The dependencies for the application can be installed locally by typing `npm install` at the command line. A local version of the app can be launched by typing `npm start` at the command line and the page will reload when you make changes. A copy suitable for distribution can be built using the `npm run build` command (see the `build` folder).
 
+### Docker
+To start services via docker, first copy the default configuration files and modify as necessary:
+
+    # docker-compose service/project configuration
+    cp .env.default .env
+
+    # React App configuration
+    cp frontend.env.default frontend.env
+
+To start all services, run the below command:
+
+    docker-compose up
+
 ### Download Value Sets from VSAC
 The value set content used by the CQL is cached in a file named valueset-db.json, which has been checked into this project in an empty state. In order for the CDS to operate as intended, implementers must populate valueset-db.json with the value sets which have been published on the [Value Set Authority Center (VSAC)](https://vsac.nlm.nih.gov/). In order to access VSAC, you must sign up for a [UMLS Terminology Services account](https://uts.nlm.nih.gov//license.html).
 

docker-compose.dev.yaml

@@ -0,0 +1,11 @@
+# docker-compose development overrides
+---
+version: "3.4"
+services:
+  frontend:
+    volumes:
+      # mount code directory into container to allow hot-reloading
+      - ./:/opt/node/app
+    ports:
+      # map container port 3000 to $FRONTEND_EXTERNAL_PORT (port 3000 by default) on localhost (127.0.0.1)
+      - 127.0.0.1:${FRONTEND_EXTERNAL_PORT:-3000}:3000

docker-compose.yaml

@@ -0,0 +1,8 @@
+---
+version: "3.4"
+services:
+  frontend:
+    build:
+      context: .
+    env_file:
+      - frontend.env

default.env frontend.env.default

@@ -1,3 +1,6 @@
+# Example docker-compose environment file
+# Copy to frontend.env and modify as necessary
+# https://docs.docker.com/compose/env-file/
 
 #FHIR resources to load
 #REACT_APP_FHIR_RESOURCES=Condition,Procedure,Observation,Questionnaire,QuestionnaireResponse