phist91/jekyll repository overview

⁠phist91/jekyll

Dockerfile for a Docker image providing Jekyll, based on Ubuntu.

The Dockerfiles can be found on GitLab: https://gitlab.com/phist91/dockerfiles⁠

The image tags specify the day on which the image was built, e.g., 2024-02-01 denotes February 1, 2024. This should be helpful when older versions are needed. You can also specify the architecture (currently, amd64 or arm64), but if you do not, it will be picked automatically.

⁠Usage

⁠For local developing

To use the image for local development, mount the root folder of your Jekyll project to the containers' /jworkdir folder and specify a Docker volume for Ruby Gems used by Jekyll. For example, to download the required Gems first, you can use this command:

docker run -it --rm --volume="/path/to/project:/jworkdir" --volume="jekyll-gems:/gems" phist91/jekyll:latest /bin/bash -c "cd /jworkdir && bundle install"

Afterwards, you can build your project:

docker run -it --rm --volume="/path/to/project:/jworkdir" --volume="jekyll-gems:/gems" phist91/jekyll:latest /bin/bash -c "cd /jworkdir && bundle exec jekyll serve"

See the example Makefile⁠ for a Makefile template you can copy into the root folder of your Jekyll project.

⁠For GitLab CI

You can use the image for your Docker-powered GitLab CI pipeline. For example, your .gitlab-ci.yml could look like this:

jekyll:
  image: phist91/jekyll:latest
  script:
    - bundle install
    - bundle exec jekyll build
  artifacts:
    paths:
      - _site
    expire_in: 30 days