opendev/gerrit
Code Issues Proposed changes

Bazel: Update local cache activation instructions

Browse Source 
Since [1] two action cache option were merged, and the experimental
prefix was removed. Also update the section about repository cache.
This cache is now activated per default and we can only change the
location of that cache.

[1] https://github.com/bazelbuild/bazel/pull/4874

Change-Id: Iec4557a28987665182e9fe3f476d035421b751fe
This commit is contained in:
David Ostrovsky
2018-05-07 07:51:38 +02:00
committed by David Ostrovsky
parent 60c5618a7a
commit 47b79bd20f
1 changed files with 10 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
Documentation/dev-bazel.txt
View File

@@ -365,38 +365,25 @@ JGit repository.
[[local-action-cache]] [[local-action-cache]]
To accelerate builds, local action cache can be activated. Note, that this To accelerate builds, local action cache can be activated.
experimental feature is not activated per default and only available since To activate the local action cache add these lines to your `~/.bazelrc` file:
Bazel version 0.7.
To activate the local action cache, create accessible cache directory:
---- ----
mkdir -p ~/.gerritcodereview/bazel-cache/cas build --disk_cache=~/.gerritcodereview/bazel-cache/cas
----
and add these lines to your `~/.bazelrc` file:
----
build --experimental_local_disk_cache_path=/home/<user>/.gerritcodereview/bazel-cache/cas
build --experimental_local_disk_cache
build --experimental_strict_action_env build --experimental_strict_action_env
build --action_env=PATH build --action_env=PATH
---- ----
[NOTE] `experimental_local_disk_cache_path` must be absolute path. Expansion of `~` is
unfortunately not supported yet. This is also the reason why we can't activate this
feature by default yet (by adjusting tools/bazel.rc file).
[[repository_cache]] [[repository_cache]]
To accelerate fetches, local repository cache can be activated. This cache is To accelerate fetches, local repository cache is activated per default in Bazel.
only used for rules_closure external repository and transitive dependendcies. This cache is only used for rules_closure external repository and transitive
That's because rules_closure uses standard Bazel download facility. For all dependendcies. That's because rules_closure uses standard Bazel download facility.
other gerrit dependencies, the download_artifacts repository cache is used For all other gerrit dependencies, the download_artifacts repository cache is used
already. already.
To activate the local repository cache, create accessible cache directory: To change the default local repository cache directry, create accessible cache
directory:
---- ----
mkdir -p ~/.gerritcodereview/bazel-cache/repository mkdir -p ~/.gerritcodereview/bazel-cache/repository
@@ -405,12 +392,9 @@ To activate the local repository cache, create accessible cache directory:
and add this line to your `~/.bazelrc` file: and add this line to your `~/.bazelrc` file:
---- ----
build --experimental_repository_cache=/home/<user>/.gerritcodereview/bazel-cache/repository build --repository_cache=/home/<user>/.gerritcodereview/bazel-cache/repository
---- ----
[NOTE] `experimental_repository_cache` must be absolute path. Expansion of `~` is
unfortunately not supported yet. This is also the reason why we can't activate this
feature by default yet (by adjusting tools/bazel.rc file).
GERRIT GERRIT
------ ------
Part of link:index.html[Gerrit Code Review] Part of link:index.html[Gerrit Code Review]