Merge pull request #50 from w3tecch/feature/docker-image

Feature/docker image

Author: dweber019

. dockerignore

@@ -0,0 +1,11 @@
+.vscode
+node_modules
+test
+.editorconfig
+.env.example
+.gitignore
+.travis.yml
+appveyor.yml
+icon.png
+LICENSE
+README.md

Dockerfile

@@ -0,0 +1,16 @@
+FROM node:alpine
+
+# Create work directory
+WORKDIR /usr/src/app
+
+# Install runtime dependencies
+RUN npm install yarn -g
+
+# Copy app source to work directory
+COPY . /usr/src/app
+
+# Install app dependencies
+RUN yarn install
+
+# Build and run the app
+CMD npm start serve

README.md

@@ -371,6 +371,85 @@ The last step is the easiest, just hit the following command in your terminal, b
 npm start db.seed
 ```
 
+## Run in Docker container
+
+### Install Docker
+
+Before you start, make sure you have a recent version of [Docker](https://docs.docker.com/engine/installation/) installed
+
+### Build Docker image
+
+```shell
+docker build -t <your-image-name> .
+```
+
+### Run Docker image in container and map port
+
+The port which runs your application inside Docker container is either configured as `PORT` property in your `.env` configuration file or passed to Docker container via environment variable `PORT`. Default port is `3000`.
+
+#### Run image in detached mode
+
+```shell
+docker run -d -p <port-on-host>:<port-inside-docker-container> <your-image-name>
+```
+
+#### Run image in foreground mode
+
+```shell
+docker run -i -t -p <port-on-host>:<port-inside-docker-container> <your-image-name>
+```
+
+### Stop Docker container
+
+#### Detached mode
+
+```shell
+docker stop <container-id>
+```
+
+You can get a list of all running Docker container and its ids by following command
+
+```shell
+docker images
+```
+
+#### Foreground mode
+
+Go to console and press <CTRL> + C at any time.
+
+### Docker environment variables
+
+There are several options to configure your app inside a Docker container
+
+#### project .env file
+
+You can use `.env` file in project root folder which will be copied inside Docker image. If you want to change a property inside `.env` you have to rebuild your Docker image.
+
+#### run options
+
+You can also change app configuration by passing environment variables via `docker run` option `-e` or `--env`.
+
+```shell
+docker run --env DB_HOST=localhost -e DB_PORT=3306
+```
+
+#### environment file
+
+Last but not least you can pass a config file to `docker run`.
+
+```shell
+docker run --env-file ./env.list
+```
+
+`env.list` example:
+
+```
+# this is a comment
+DB_TYPE=mysql
+DB_HOST=localhost
+DB_PORT=3306
+```
+
 ## Further Documentations
 
 | Name & Link                       | Description                       |