From a7ffccd2cdf24273e6ca30fe60d92c71f61322f7 Mon Sep 17 00:00:00 2001 From: buchgr Date: Wed, 11 Jul 2018 06:02:17 -0700 Subject: 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 --- site/docs/remote-caching.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'site/docs') 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 - -- cgit v1.2.3