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
~/.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
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