BuildStream inside Docker

If your system cannot provide the base system requirements for BuildStream, then it is possible to run buildstream within a Docker image.

The BuildStream project provides Docker images containing BuildStream and its dependencies. This gives you an easy way to get started using BuildStream on any Unix-like platform where Docker is available, including Mac OS X.

We recommend using the bst-here wrapper script which automates the necessary container setup. You can download it and make it executable like this:

mkdir -p ~/.local/bin
curl --get > ~/.local/bin/bst-here
chmod +x ~/.local/bin/bst-here

Check if ~/.local/bin appears in your PATH environment variable -- if it doesn't, you should edit your ~/.bashrc so that it does:

export PATH="${PATH}:${HOME}/.local/bin"

Once the script is available in your PATH, you can run bst-here to open a shell session inside a new container based off the latest version of the buildstream/buildstream Docker image. The current working directory will be mounted inside the container at /src.

You can also run individual BuildStream commands as bst-here COMMAND. For example: bst-here show systems/my-system.bst. Note that BuildStream won't be able to integrate with Bash tab-completion if you invoke it in this way.

Two Docker volumes are set up by the bst-here script:

  • buildstream-cache -- mounted at ~/.cache/buildstream
  • buildstream-config -- mounted at ~/.config/

These are necessary so that your BuildStream cache and configuration files persist between invocations of bst-here.

By default, the latest tag of the buildstream/buildstream image will be used. This tag tracks the latest stable release of BuildStream. You can choose to use a different tag using the -j option. For example, you can run the nightly build of BuildStream like so:

bst-here -j nightly

More details on image variants can be found here.