Skip to content

📖 Document RBE_platform cache-silo-key for distributed builds #36

Open
Lambourl wants to merge 1 commit intodevelopfrom
feature/rbe-env-var
Open

📖 Document RBE_platform cache-silo-key for distributed builds #36
Lambourl wants to merge 1 commit intodevelopfrom
feature/rbe-env-var

Conversation

@Lambourl
Copy link
Copy Markdown
Contributor

  • Add FAQ entry in the distributed builds documentation explaining how to use the cache-silo-key property via RBE_platform to segregate remote cache hits
  • Useful when investigating flaky builds, testing toolchain changes or starting fresh without invalidating other users' cache entries

Comment thread 0352-distributed-builds.md Outdated
> 💡 Don't forget to ajdust the number of jobs `-j` used for the build, to avoid overloading your local machine, when building with `RBE_remote_disabled`.

> ## 🧹 How to force a clean cache for a `--distributed --build`?
> Sometimes it may be necessary to ensure a build doesn't reuse any previously cached remote actions (_e.g._ investigating a flaky build, testing a toolchain change or simply starting fresh). This can be done by passing a `cache-silo-key` via the `RBE_platform` environment variable:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Testing a toolchain change will result in cache invalidation.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please change into: investigating a flaky build or simply starting fresh

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not if you're using Tipi with the driver-only method, but this might not be the right place for that explanation, actually. But I will do the change

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@Lambourl Lambourl force-pushed the feature/rbe-env-var branch from 7eb9e4a to 1387b9f Compare April 24, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants