Allow docker workflow

Author: cburgdorf

Dockerfile

@@ -0,0 +1,15 @@
+FROM ruby:2.5
+
+RUN gem install jekyll -v 3.8
+RUN gem install jekyll-paginate -v 1.1
+RUN gem install jekyll-redirect-from -v 0.15
+
+EXPOSE 4000
+
+CMD ["/bin/sh"]
+
+# This Docker container is intended to only provide the necessary environment to
+# build the blog. It does not know about the blog itself. One should provide a
+# blog as a mount point and use this soley as a safe-heaven jekyll environment.
+
+# E.g. sudo docker run -it --mount src="$(pwd)",target=/blog,type=bind thoughtram/blog:latest cd /blog && jekyll build

README.md

@@ -11,3 +11,19 @@ sudo gem install jekyll-paginate
 
 jekyll serve
 ```
+
+## Using docker
+
+This blog requires `ruby`, `jekyll` and a bunch of other dependencies in specific versions. Managing these dependencies can become difficult over time and often the simplest solution is to use `docker`.
+
+**NOTE: Depending on the `docker` installation, the following commands might need to be run using `sudo`.**
+
+| Action    |      Local Jekyll   |  Using Docker                    |
+|-----------|---------------------|----------------------------------|
+| Building  | `jekyll build`      | `yarn docker-jekyll-build`       |
+| Serving   | `jekyll serve`      | `yarn docker-jekyll-serve`       |
+| Deplyoing | `yarn deploy [...]` | `yarn deploy --use-docker [...]` |
+
+### Caveats
+
+These commands are intended to be used as straight forward replacements. There's one caveat though: They don't let one use additional parameters. E.g. one can not change the default port for serving, it is hard-wired to serve the site on `http://localhost:4000`.

deploy.js

@@ -11,15 +11,15 @@ let execute = (cmd) => {
     return output;
   }
   catch (e) {
-    //Doesn't feel write to swallow the exceptions but there doesn't seem
-    //to be a built in way to supress exceptions if git add and git push fail
+    console.error(chalk.red(e.toString()))
   }
 }
 
 const metaOnly = process.argv.includes('--meta-only');
 const skipMeta = process.argv.includes('--skip-meta');
 const force = process.argv.includes('--force');
 const noPush = process.argv.includes('--no-push');
+const useDocker = process.argv.includes('--use-docker');
 
 const defaultBranch = 'master';
 const deployBranch = 'gh-pages';
@@ -52,7 +52,13 @@ if (isBehindUpstream && !force) {
 
 console.log(chalk.green('Performing jekyll build...'));
 // perform jekyll build
-execute(`jekyll build`);
+
+if (useDocker) {
+  execute(`./docker-jekyll-build`);
+} else {
+  execute(`jekyll build`);
+}
+
 
 console.log(chalk.green('Generating deploy artifacts...'));
 // cleanup temp branches

docker-jekyll-build

@@ -0,0 +1,2 @@
+#!/bin/sh
+docker run -it --init --mount src="$(pwd)",target=/blog,type=bind thoughtram/blog:latest /bin/sh -c "cd /blog && jekyll build"

docker-jekyll-serve

@@ -0,0 +1,2 @@
+#!/bin/sh
+docker run -it --init -p  4000:4000 --mount src="$(pwd)",target=/blog,type=bind thoughtram/blog:latest /bin/sh -c "cd /blog && jekyll serve --host 0.0.0.0"

package.json

@@ -5,7 +5,9 @@
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "deploy": "node deploy.js"
+    "deploy": "node deploy.js",
+    "docker-jekyll-build": "./docker-jekyll-build",
+    "docker-jekyll-serve": "./docker-jekyll-serve"
   },
   "repository": {
     "type": "git",