diff options
author | buchgr <buchgr@google.com> | 2018-07-11 06:02:17 -0700 |
---|---|---|
committer | Copybara-Service <copybara-piper@google.com> | 2018-07-11 06:03:50 -0700 |
commit | a7ffccd2cdf24273e6ca30fe60d92c71f61322f7 (patch) | |
tree | fea2566a41815d1629685db341d036717acab606 /site | |
parent | 73abea52e86c70e201c00ec25a1f189223d3b9aa (diff) |
remote: unix socket support for remote http caching
This adds support for Unix sockets to Bazel for the
remote http cache. See corresponding issue #5098
for discussion.
RELNOTES: Introduce the --remote_cache_proxy flag,
which allows for remote http caching to connect
via a unix domain socket.
PiperOrigin-RevId: 204111667
Diffstat (limited to 'site')
-rw-r--r-- | site/docs/remote-caching.md | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/site/docs/remote-caching.md b/site/docs/remote-caching.md index 416550f63c..b484d6d942 100644 --- a/site/docs/remote-caching.md +++ b/site/docs/remote-caching.md @@ -307,6 +307,19 @@ You may want to delete content from the cache to: * Create a clean cache after a cache was poisoned * Reduce the amount of storage used by deleting old outputs +### Unix sockets + +The remote HTTP cache supports connecting over unix domain sockets. The behavior is similar to +curl's `--unix-socket` flag. Use the following to configure unix domain socket: + +``` +build --experimental_remote_spawn_cache +build --remote_http_cache=http://replace-with-your.host:port +build --remote_cache_proxy=unix:/replace/with/socket/path +``` + +This feature is unsupported on Windows. + ## Disk cache Bazel can use a directory on the file system as a remote cache. This is @@ -392,4 +405,3 @@ execution platform. [gRPC protocol]: https://github.com/googleapis/googleapis/blob/master/google/devtools/remoteexecution/v1test/remote_execution.proto [Buildfarm]: https://github.com/bazelbuild/bazel-buildfarm [issue #4558]: https://github.com/bazelbuild/bazel/issues/4558 - |