summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTristan Van Berkom <tristan.vanberkom@codethink.co.uk>2017-09-29 20:14:47 +0900
committerTristan Van Berkom <tristan.van.berkom@gmail.com>2017-09-29 11:45:22 +0000
commitd4e189ade8b53dab6352d78e32b413eb78f8574d (patch)
tree6f89c4189bc856f6f759dcdb27909aeea0ee47ab
parent14fa10f490b59a55307378b565cb517ad96d5aab (diff)
downloadbuildstream-d4e189ade8b53dab6352d78e32b413eb78f8574d.tar.gz
doc/source/artifacts.rst: Document --artifact-receiver-only option.
-rw-r--r--doc/source/artifacts.rst23
1 files changed, 16 insertions, 7 deletions
diff --git a/doc/source/artifacts.rst b/doc/source/artifacts.rst
index 1f801c080..5e5b98a8e 100644
--- a/doc/source/artifacts.rst
+++ b/doc/source/artifacts.rst
@@ -25,19 +25,28 @@ user to own the artifact cache.
useradd artifacts
+
+Installing the receiver
+-----------------------
You will also need to install BuildStream on the artifact server in order
to receive uploaded artifacts over ssh. Follow the instructions for installing
BuildStream :ref:`here <installing>`
-.. note::
+When installing BuildStream on the artifact server, it must be installed
+in a system wide location, with ``pip3 install .`` in the BuildStream
+checkout directory.
+
+Otherwise, some tinkering is required to ensure BuildStream is available
+in ``PATH`` when it's companion ``bst-artifact-receive`` program is run
+remotely.
- When installing BuildStream on the artifact server, it must be installed
- in a system wide location, with ``pip3 install .`` in the BuildStream
- checkout directory.
+You can install only the artifact receiver companion program without
+requiring BuildStream's dependencies by passing the ``--artifact-receiver-only``
+install option, like so:
+
+.. code::
- Otherwise, some tinkering is required to ensure BuildStream is available
- in ``PATH`` when it's companion ``bst-artifact-receive`` program is run
- remotely.
+ pip3 install . --install-option="--artifact-receiver-only"
Initializing the cache