From fec72ac0ea674b9d0dfc13bf2d9060241f617078 Mon Sep 17 00:00:00 2001
From: David Oram <david.oram99@gmail.com>
Date: Thu, 23 Aug 2018 06:34:23 +1200
Subject: [PATCH] Dockerfile to package the 'redoc-cli' tool as a docker image

---
 cli/Dockerfile | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/cli/Dockerfile b/cli/Dockerfile
index 9de988b4..df34b500 100644
--- a/cli/Dockerfile
+++ b/cli/Dockerfile
@@ -1,25 +1,30 @@
-# To build:
-# - Must be in the project root directory
-# - docker build -f cli/Dockerfile .
+# Package the 'redoc-cli' as a docker image.
 #
-# To run
-# - docker run --rm -i -t <image> --help
-
+# To build:
+# $ cd <Redoc project directory>
+# $ docker build -t redoc-cli -f cli/Dockerfile .
+#
+# To run:
+# To display the command line options:
+# $ docker run --rm -it redoc-cli redoc-cli --help
+# .. will display the comand line help
+#
+# To the `swagger.yml` file in the current directory, and output 'redoc-static.html'
+# $  docker run --rm -it  -v $PWD:/data redoc-cli redoc-cli bundle swagger.yml
 
 FROM node:alpine
 
+# Needs python, alpine-sdk to build node packages
 RUN apk update && apk add --no-cache git python alpine-sdk nodejs
 
-# generate bundle
 WORKDIR /build
 COPY . /build
-#RUN cd cli && npm run compile:cli
-RUN yarn install --frozen-lockfile --ignore-optional --ignore-scripts
-RUN npm run bundle && npm run compile:cli
 
-RUN npm install typescript
-RUN npm install iltorb
-RUN npm install -g redoc-cli
+RUN yarn install --frozen-lockfile --ignore-optional --ignore-scripts && \
+  npm run bundle && npm run compile:cli && \
+  npm install typescript && \
+  npm install iltorb  && \
+  npm install -g redoc-cli
 
-ENTRYPOINT ["redoc-cli"]
+WORKDIR /data