# Bazel Remote Cache Config Generator

`bzl-cache-rc-gen` generates a `.bazelrc` based on provided configuration for using the shared Edge remote Bazel cache.  This can be used for generating `.bazelrc` files to use on local developer machines or containers / CI builds. 

Valid configuration values and descriptions of what they do can be found in `main.go`.  They can also be seen by running `bazel run //cmd/tools/bzl-cache-rc-gen -- --help`. 

For general configuration recommendations, [see the Bazel remote caching documentation for this repo](https://docs.edge-infra.dev/dev/contributing/bazel/#remote-caching).


## Unique Cache Keys

Importantly, `bzl-cache-rc-gen` creates a unique Bazel cache key based on some heuristics that attempt to identify the uniqueness of the machine it is ran on.  This is used to ensure our Bazel cache is not poisoned (more information [here](https://forum.buildkite.community/t/any-experience-setting-up-a-shared-remote-build-cache-using-bazel/1119/4)).  For example, [this is the script used by Kubernetes](https://github.com/kubernetes/test-infra/blob/master/images/bootstrap/create_bazel_cache_rcs.sh).