From 58158ae7b6bc0b734731c913d3e64946b5a0d111 Mon Sep 17 00:00:00 2001 From: buchgr Date: Wed, 11 Jul 2018 13:47:30 -0700 Subject: site: udpate remote caching docs. Fixes #5488 RELNOTES: None PiperOrigin-RevId: 204181375 --- site/docs/remote-caching.md | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) (limited to 'site') diff --git a/site/docs/remote-caching.md b/site/docs/remote-caching.md index b484d6d942..15b09d4a3b 100644 --- a/site/docs/remote-caching.md +++ b/site/docs/remote-caching.md @@ -244,17 +244,15 @@ Use the following flags to: * disable sandboxing ``` -build --spawn_strategy=remote --genrule_strategy=remote -build --strategy=Javac=remote --strategy=Closure=remote build --remote_http_cache=http://replace-with-your.host:port +build --spawn_strategy=standalone ``` -Using the remote cache with sandboxing enabled is experimental. Use the +Using the remote cache with sandboxing enabled is the default. Use the following flags to read and write from the remote cache with sandboxing enabled: ``` -build --experimental_remote_spawn_cache build --remote_http_cache=http://replace-with-your.host:port ``` @@ -264,17 +262,15 @@ Use the following flags to: read from the remote cache with sandboxing disabled. ``` -build --spawn_strategy=remote --genrule_strategy=remote -build --strategy=Javac=remote --strategy=Closure=remote build --remote_http_cache=http://replace-with-your.host:port build --remote_upload_local_results=false +build --spawn_strategy=standalone ``` Using the remote cache with sandboxing enabled is experimental. Use the following flags to read from the remote cache with sandboxing enabled: ``` -build --experimental_remote_spawn_cache build --remote_http_cache=http://replace-with-your.host:port build --remote_upload_local_results=false ``` @@ -309,11 +305,11 @@ You may want to delete content from the cache to: ### 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: +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 ``` @@ -348,8 +344,11 @@ build --experimental_strict_action_env **Input file modification during a build** When an input file is modified during a build, Bazel might upload invalid -results to the remote cache. We are working on a solution for this problem. -See [issue #3360] for updates. Avoid modifying source files during a build. +results to the remote cache. We implemented a change detection that can be +enabled via the `--experimental_guard_against_concurrent_changes` flag. There +are no known issues and we expect to enable it by default in a future release. +See [issue #3360] for updates. Generally, avoid modifying source files during a +build. **Environment variables leaking into an action** -- cgit v1.2.3