Skip to content
A Docker container used by Linaro's web site build process; the container isolates the building of Linaro's Jekyll-based web sites.
Shell Dockerfile
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.devcontainer.json
.gitattributes
Dockerfile
README.md
build-site.sh

README.md

jekyll-build-container

A Docker container used by Linaro's web site build process.

The container isolates the building of Linaro's Jekyll-based web sites. This avoids needing to install directly on the host the numerous packages used when building the sites. The container includes all of the Ruby gems used across the web sites, which is why it is critical that changes made to Gemfiles in any of the website repositories must be matched with a corresponding change to the gems referenced in the Dockerfile. Failure to do so could result in build failure on Linaro's Bamboo build service.

In addition to the notes below, more documentation can be found on the wiki.

Building

Prerequisites

  • An operating system capable of running Docker
  • Enough free RAM and disc space

Building has been tested with Docker Community Edition under Arch Linux, Ubuntu and Windows 10.

Building the container

Build the container in the usual way, e.g.

docker build --rm -t "linaroits/jekyllsitebuild:<tag>" .

Important: If developing a variant of this container, e.g. to add a new package, use a personal tag reference and then specify that tag when running the site building script, e.g.:

JEKYLLSITEBUILD="personaltag" ./build-site.sh

If you omit <tag>, Docker will default to tagging the container as latest which could cause confusion if testing local changes. For that reason, Linaro-provided versions of the jekyllsitebuild container will display the Bamboo build reference at the start of the scripts being run, e.g.:

Container built by bamboo.linaro.org: CON-JBC-JOB1-43
...

The script will now, if it has access to the Internet, check Docker Hub to see if the latest image is being used and warn if it isn't.

Built containers can also be found on Docker Hub for your convenience.

You can’t perform that action at this time.