Make running jekyll less irritating

Every time I need to edit the blog and view it locally something in the
ruby/jekyll stack has changed enough that it doesn't work. So make a
Dockerfile and some instructions to make setting up the environment more
reliable. And separate from the host.

Author: bcl

.dockerignore

@@ -0,0 +1 @@
+.git

Dockerfile

@@ -0,0 +1,9 @@
+FROM fedora:latest
+RUN dnf --setopt=deltarpm=0 --verbose install -y passwd sudo vim-enhanced less redhat-rpm-config \
+@development-tools gcc-c++ autoconf automake libtool zlib-devel \
+rubygem-bundler ruby-devel kernel-headers
+WORKDIR /weldr.io/
+
+# Run as user passed in with --env LOCAL_UID=`id -u`
+COPY entrypoint.sh /usr/local/bin/entrypoint.sh
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

StyleGuide.md

@@ -2,6 +2,20 @@
 
 Notes for weldrists writing for weldr.io.
 
+## Testing locally using containers
+
+This will build a container, install the needed fedora packages and mount the current directory as
+your user id (so that you can edit from within the container without making everything owned by root).
+
+    sudo docker build -t weldr/jekyll .
+    sudo docker run -it --name=jekyll --security-opt="label=disable" -v "$PWD:/weldr.io/" --env LOCAL_UID=`id -u` -p 4000:4000 weldr/jekyll /usr/bin/bash
+    bundle install --binstubs=/tmp/bin/
+    bundle exec /tmp/bin/jekyll serve --host=0.0.0.0 --incremental
+
+...then just open http://localhost:4000/ and you're off. On subsequent runs you can reuse the container with:
+
+    sudo docker start -i jekyll
+
 ## Testing locally
 
 See README.md as well, but here's the quick version:

entrypoint.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# Setup a user account from environment:
+#   LOCAL_USERNAME
+#   LOCAL_UID
+USERNAME=${LOCAL_USERNAME:-user}
+USER_ID=${LOCAL_UID:-1000}
+
+if [ "$USERNAME" == "root" ]; then
+    echo "Running as root"
+    exec "$@"
+else
+    echo "Running with $USERNAME:$USER_ID"
+    useradd -u "$USER_ID" -G wheel -m "$USERNAME"
+    # Remove user password, allows sudo use
+    passwd -d "$USERNAME"
+    exec sudo -u "$USERNAME" "$@"
+fi