Quantcast

Dockerizing Jekyll

comments edit

The source repository for this article is on Github.

I wanted to write a short post on development applications dockerisation. There was a small issue though: I no more had ruby and associated bundles installed… it turned out that creating a docker image containing everything necessary to run jekyll was in fact quite easy.

Here is the dockerfile:

FROM ruby:alpine

RUN apk add --no-cache \
        build-base \
        make && \
    gem install bundler

EXPOSE 4000 

ENTRYPOINT [ "bundle" ]

CMD [ "exec", "jekyll", "serve", "-H", "0.0.0.0" ]

The trick is to install build-base and make to allow for c modules compilation during bundle install.

And to run it, set working directory, bind mount it to current folder and that’s it. If you want to keep your installed ruby gems, you can bind mount them as well.

First, install dependencies (providing parameters after image name will override the CMD in dockerfile) :

docker run -ti \
    --workdir '/code' \
    -v "${PWD}:/code" \
    -v "${PWD}/.gems:/usr/local/bundle" \
    -p "4000:4000" \
    mathieubrun/jekyll:latest install

And then run jekyll :

docker run -ti \
    --workdir '/code' \
    -v "${PWD}:/code" \
    -v "${PWD}/.gems:/usr/local/bundle" \
    -p "4000:4000" \
    mathieubrun/jekyll:latest

Finally, everything can be wrapped in a shell alias for maximum reusability.

To try it out, run in either bash or powershell :

git clone https://github.com/mathieubrun/mathieubrun.github.io
cd mathieubrun.github.io
docker run -ti \
    --workdir '/code' \
    -v "${PWD}:/code" \
    -v "${PWD}/.gems:/usr/local/bundle" \
    -p "4000:4000" \
    mathieubrun/jekyll:latest install
docker run -ti \
    --workdir '/code' \
    -v "${PWD}:/code" \
    -v "${PWD}/.gems:/usr/local/bundle" \
    -p "4000:4000" \
    mathieubrun/jekyll:latest

And then open your browser to localhost:4000 !