docs: switch local Build Cache guides to push-enabled default - #232
Merged
Merged
Conversation
The CLI now defaults --cache-push to true for local activate (Gradle, Bazel, React Native, and the interactive wizard). Update the four "in local builds" guides to reflect the new default: wizard prompt keeps the default answer, what activation writes changes for Bazel, and the trade-off section becomes "opt into pull-only" rather than "push is an escape hatch". Source: bitrise-io/bitrise-build-cache-cli PR #528 (ACI-5380).
Badlazzor
requested review from
aorcsik,
ilanazholobovsky,
matenadasdi and
zoltan-baba
as code owners
September 9, 2026 14:07
Badlazzor
marked this pull request as draft
September 9, 2026 14:16
zsolt-marta-bitrise
approved these changes
Sep 10, 2026
Badlazzor
marked this pull request as ready for review
September 17, 2026 11:33
zoltan-baba
approved these changes
Sep 17, 2026
zoltan-baba
deleted the
docs-impact/aci-5380-local-cache-push-default
branch
September 17, 2026 14:13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Source change: bitrise-io/bitrise-build-cache-cli#528 (ACI-5380)
Changes for this code change
The CLI flipped
--cache-pushdefault fromfalsetotruefor local activate on Gradle, Bazel, React Native (already merged separately as PR #466), and the interactive wizard. Local activation now behaves the same as the CI activation: read + write.Four "in local builds" guides updated:
bitrise-build-cache/build-cache-for-gradle/configuring-the-build-cache-for-gradle-in-local-builds.mdx— wizard step 5 now says "keep the default Yes, push too"; the## Local builds only read from the cacheand## Pushing to the cache from local buildssections merge into## Cache push mode(default = push) +## Opting into pull-only mode(opt-in).bitrise-build-cache/build-cache-for-bazel/configuring-the-build-cache-for-bazel-in-local-builds.mdx— same wizard + section flip. Also updated the sample.bazelrcblock to show--remote_upload_local_results(the new default), the "committing the configuration" subsection now frames pull-only as a deliberate developer-side override rather than "what the CLI writes", and the--noremote_upload_local_resultsrow in the "What is safe to commit" table now reads "Optional, if you want to force pull-only".bitrise-build-cache/build-cache-for-react-native/configuring-the-build-cache-for-react-native-in-local-builds.mdx— same wizard + section flip.bitrise-build-cache/build-cache-for-xcode/configuring-the-build-cache-for-xcode-in-local-builds.mdx— same wizard + section flip. (Xcode's CLI default was alreadytrue, so the wizard-prompt copy was the only user-visible drift.)What a reviewer must verify before merge
npm start).#cache-push-mode,#opting-into-pull-only-mode) don't have inbound links from other pages — I grep'd the docs repo and found none, but a partial or an auto-generated index could still reference the old anchors.Pre-existing drift NOT fixed here
Flagging these for a separate cleanup rather than expanding this PR's scope:
:::notetelling users to manually stop the xcelerate proxy / ccache helper after re-runningactivatewith a different push setting. The CLI already auto-restarts the daemon on push flag change (seebitrise-io/bitrise-build-cache-cliPRs #477, previously). That note is stale as of that fix. Not touched here to keep this diff scoped to ACI-5380.