diff options
author | Chandan Singh <chandan.devel@gmail.com> | 2018-10-10 00:59:17 +0000 |
---|---|---|
committer | Chandan Singh <chandan.devel@gmail.com> | 2018-10-10 00:59:17 +0000 |
commit | 35ac26a74be702deedbaaa5acf603194e0910731 (patch) | |
tree | 0f4cf1a5f64cacd9e1664123022e9c6615dec575 | |
parent | 120d8c7392c80cb56399329942bd603be3b7f0a2 (diff) | |
parent | dd472d957fb1c34ea2938fd263321f311603451e (diff) | |
download | buildstream-35ac26a74be702deedbaaa5acf603194e0910731.tar.gz |
Merge branch 'chandan/bst-and-docker' into 'master'
Add documentation and NEWS entry about bst-docker-import
See merge request BuildStream/buildstream!864
-rw-r--r-- | NEWS | 3 | ||||
-rw-r--r-- | doc/source/additional_docker.rst | 53 | ||||
-rw-r--r-- | doc/source/core_additional.rst | 1 |
3 files changed, 57 insertions, 0 deletions
@@ -24,6 +24,9 @@ buildstream 1.3.1 o Add new `pip` source plugin for downloading python packages using pip, based on requirements files from previous sources. + o Generate Docker images from built artifacts using + `contrib/bst-docker-import` script. + ================= buildstream 1.1.5 diff --git a/doc/source/additional_docker.rst b/doc/source/additional_docker.rst new file mode 100644 index 000000000..ff4c35cad --- /dev/null +++ b/doc/source/additional_docker.rst @@ -0,0 +1,53 @@ + +.. _bst_and_docker: + + +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 :ref:`BuildStream inside Docker <docker>` documentation for +instructions on how to run BuildStream as a Docker container. + +Generate Docker images +---------------------- + +The +`bst-docker-import script <https://gitlab.com/BuildStream/buildstream/blob/master/contrib/bst-docker-import>`_ +can be used to generate a Docker image from built artifacts. + +You can download it and make it executable like this: + +.. code:: bash + + 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 <https://stackoverflow.com/questions/14637979/>`_. + +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: + +.. code:: bash + + 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 <https://gitlab.com/BuildStream/buildstream/blob/master/contrib/bst-here>`_, +you can achieve the same results as the above example like this: + +.. code:: bash + + bst-docker-import -c bst-here -t bst-hello hello.bst diff --git a/doc/source/core_additional.rst b/doc/source/core_additional.rst index 76e523ee8..08c445630 100644 --- a/doc/source/core_additional.rst +++ b/doc/source/core_additional.rst @@ -8,3 +8,4 @@ Additional writings additional_cachekeys additional_sandboxing + additional_docker |