Add build script

So that we can execute a local production build the same way we do in CI

Signed-off-by: Robert Young <robertyoungnz@gmail.com>

Author: robobario

.dockerignore

@@ -1,6 +1,7 @@
 .jekyll-cache
 .gitignore
 run.sh
+build.sh
 Dockerfile
 .dockerignore
 .git

.github/workflows/jekyll-gh-pages.yml

@@ -63,16 +63,13 @@ jobs:
         # this is to enable forks to override the url and baseurl
         run: echo "${{ vars.JEKYLL_CONFIG_OVERRIDES }}" > _config-overrides.yml
       - name: Build with Jekyll
-        # Outputs to the './_site' directory by default
+        # Outputs to the './_site' directory
         run: |
-          docker run \
-            --rm \
-            -u "$(id -u):$(id -g)" \
-            -v "$(pwd):/site" \
-            localhost:5000/kroxy-jekyll:latest \
-            bash -c 'eval "$(rbenv init -)" && cp -r /css/_sass/bootstrap /site/_sass/ && JEKYLL_ENV=production bundle exec jekyll build --config=_config.yml,_config-overrides.yml'
+          ./build.sh
         env:
-          JEKYLL_ENV: production
+          CONTAINER_ENGINE: docker
+          CONFIG_OVERRIDES: _config-overrides.yml
+          BUILD_IMAGE_SPEC: localhost:5000/kroxy-jekyll:latest
       - name: Upload artifact
         # Automatically uploads an artifact from the './_site' directory by default
         uses: actions/upload-pages-artifact@v3

.github/workflows/pr-build.yml

@@ -32,10 +32,9 @@ jobs:
           cache-to: type=gha,mode=max
 
       - name: Build with Jekyll
+        # Outputs to the './_site' directory
         run: |
-          docker run \
-            --rm \
-            -u "$(id -u):$(id -g)" \
-            -v "$(pwd):/site" \
-            localhost:5000/kroxy-jekyll:latest \
-            bash -c 'eval "$(rbenv init -)" && cp -r /css/_sass/bootstrap /site/_sass/ && JEKYLL_ENV=production bundle exec jekyll build --config=_config.yml'
+          ./build.sh
+        env:
+          CONTAINER_ENGINE: docker
+          BUILD_IMAGE_SPEC: localhost:5000/kroxy-jekyll:latest

_config.yml

@@ -47,6 +47,7 @@ exclude:
   - .idea
   - docs/README.md
   - Dockerfile
+  - build.sh
   - run.sh
   - bootstrap_setup.sh
   - README.md

build.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# This script exists to run a production build of the code. Users can:
+# * Supply a builder image with BUILD_IMAGE_SPEC, otherwise we build the image
+# * Include additional configuration overrides with ${CONFIG_OVERRIDES}, additional
+#   override files should be added to the project directory. Eg I add an _config-overrides.yml
+#   and set CONFIG_OVERRIDES=_config-overrides.yml
+# * Control their container engine binary by setting CONTAINER_ENGINE, for example to 'docker'.
+# The output of the build will be emitted to an _site directory in the project director
+trap "exit" INT
+set +euo pipefail
+
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+cd ${SCRIPT_DIR}
+CONTAINER_ENGINE=${CONTAINER_ENGINE:-podman}
+if [ -z "${BUILD_IMAGE_SPEC}" ]; then
+  ${CONTAINER_ENGINE} build . -t kroxylicious-website
+  export BUILD_IMAGE_SPEC=kroxylicious-website
+fi
+if [ -n "${CONFIG_OVERRIDES}" ]; then
+  export CONFIG_OVERRIDES=",${CONFIG_OVERRIDES}"
+else
+  export CONFIG_OVERRIDES=""
+fi
+RUN_ARGS=()
+if [ "$CONTAINER_ENGINE" = 'podman' ]; then
+  RUN_ARGS+=(-v "$(pwd):/site/:Z")
+else
+  RUN_ARGS+=(-v "$(pwd):/site")
+  RUN_ARGS+=(-u $(id -u):$(id -g))
+fi
+RUN_ARGS+=(-e JEKYLL_ENV="${JEKYLL_ENV:-production}" --rm "${BUILD_IMAGE_SPEC}")
+BUILD_COMMAND='eval "$(rbenv init -)" && cp -r /css/_sass/bootstrap /site/_sass/ && bundle exec jekyll build --config=_config.yml'"${CONFIG_OVERRIDES}"
+RUN_ARGS+=(bash -c "${BUILD_COMMAND}")
+echo "${RUN_ARGS[@]}"
+${CONTAINER_ENGINE} run "${RUN_ARGS[@]}"