summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorPaul Cristian Sarbu <paul.cristian.sarbu@huawei.com>2023-09-12 17:59:20 +0200
committerKlaus Aehlig <klaus.aehlig@huawei.com>2023-09-15 14:42:47 +0200
commitf821e6b70c59037384ac6afb3a44517fe46953e6 (patch)
tree58334f832d4265afe8552c4cf542dcd41a7e75f6 /share
parent7f5e729b76865bbf01d1405b08f3292cee4e0e20 (diff)
downloadjustbuild-f821e6b70c59037384ac6afb3a44517fe46953e6.tar.gz
just serve: add remote execution endpoint and --fetch-absent option
The serve service will communicate with this endpoint when needed, as well as ensure artifacts it provides are synced with the remote execution CAS, if requested by the client. If just-mr is given the --fetch-absent option, it Always produce present roots irrespective of the 'absent' pragma. For Git repositories marked with the 'absent' pragma, first try to fetch any commit trees provided by the serve endpoint from the execution endpoint CAS, before reverting to a network fetch. Co-authored-by: Klaus Aehlig <klaus.aehlig@huawei.com> Co-authored-by: Alberto Sartori <alberto.sartori@huawei.com>
Diffstat (limited to 'share')
-rw-r--r--share/man/just-serve-config.5.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/share/man/just-serve-config.5.md b/share/man/just-serve-config.5.md
index ee42692c..c742e207 100644
--- a/share/man/just-serve-config.5.md
+++ b/share/man/just-serve-config.5.md
@@ -19,6 +19,10 @@ The just-serve configuration format
The configuration file is given by a JSON object.
+ - The value for the key *`"local build root"`* is a string specifying the path
+ to use as the root for local CAS, cache, and build directories. The path will
+ be created if it does not exist already.
+
- The value for the key *`"repositories"`* is a list of strings specifying
paths to Git repositories for **`just`** **`serve`** to use as additional
object lookup locations. The paths are to be used in the order given and
@@ -59,6 +63,15 @@ The configuration file is given by a JSON object.
For subkey *`"server key"`* the value is a string specifying the path to a
TLS server key.
+ - The value for the key *`"execution endpoint"`* is a JSON object specifying
+ the arguments of a remote execution endpoint to be used by **`just`**
+ **`serve`**.
+ For subkey *`"address"`* the value is a string specifying the remote
+ execution address in a NAME:PORT format.
+ For subkey *`"compatible"`* the value is a flag which specifies whether
+ the remote endpoint uses the original remote execution protocol.
+
+
See also
========