BuildStream and Docker

BuildStream integrates with Docker in multiple ways. Here are some ways in which these integrations work.

Run BuildStream inside Docker

Refer to the BuildStream inside Docker documentation for instructions on how to run BuildStream as a Docker container.

Generate Docker images

The bst-docker-import script can be used to generate a Docker image from built artifacts.

You can download it and make it executable like this:

mkdir -p ~/.local/bin
curl --get https://gitlab.com/BuildStream/buildstream/raw/master/contrib/bst-docker-import > ~/.local/bin/bst-docker-import
chmod +x ~/.local/bin/bst-docker-import

Check if ~/.local/bin appears in your PATH environment variable – if it doesn’t, you should edit your ~/.profile so that it does.

Once the script is available in your PATH and assuming you have Docker installed, you can start using the bst-docker-import script. Here is a minimal example to generate an image called bst-hello from an element called hello.bst assuming it is already built:

bst-docker-import -t bst-hello hello.bst

This script can also be used if you are running BuildStream inside Docker. In this case, you will need to supply the command that you are using to run BuildStream using the -c option. If you are using the bst-here wrapper script, you can achieve the same results as the above example like this:

bst-docker-import -c bst-here -t bst-hello hello.bst