The bazel_env rule creates a "virtual environment" for Bazel-managed tools and toolchains by making them available under stable, platform-independent paths as well as on PATH.
This allows all developers to share the same tool versions as used in the Bazel build for IDEs and local usage.
bazel_env relies on the direnv tool to automatically set up PATH when entering the project directory.
When you run the bazel_env target, it will print instructions on how to set up direnv and its .envrc file.
The example includes some commonly used tools and toolchains.
- Add a dependency on
bazel_env.bzlto yourMODULE.bazelfile:
bazel_dep(name = "bazel_env.bzl", version = "0.1.0", dev_dependency = True)- Add a
bazel_envtarget to aBUILD.bazelfile (e.g. top-level or in atoolsdirectory):
load("@bazel_env.bzl", "bazel_env")
bazel_env(
name = "bazel_env",
toolchains = {
"jdk": "@rules_java//toolchains:current_host_java_runtime",
},
tools = {
# Tools can be specified as labels.
"buildifier": "@buildifier_prebuilt//:buildifier",
"go": "@rules_go//go",
# Tool paths can also reference the Make variables provided by toolchains.
"jar": "$(JAVABASE)/bin/jar",
"java": "$(JAVA)",
},
)- Run the
bazel_envtarget and follow the instructions to installdirenvand set up the.envrcfile:
$ bazel run //:bazel_env
====== bazel_env ======
✅ direnv is installed
❌ bazel_env's bin directory is not in PATH. Please follow these steps:
1. Enable direnv's shell hook as described in https://direnv.net/docs/hook.html.
2. Add the following snippet to a .envrc file next to your MODULE.bazel file:
watch_file bazel-out/bazel_env-opt/bin/bazel_env/bin
PATH_add bazel-out/bazel_env-opt/bin/bazel_env/bin
if [[ ! -d bazel-out/bazel_env-opt/bin/bazel_env/bin ]]; then
log_error "ERROR[bazel_env.bzl]: Run 'bazel run //:bazel_env' to regenerate bazel-out/bazel_env-opt/bin/bazel_env/bin"
fi
3. Allowlist the file with 'direnv allow .envrc'.
Multiple bazel_env targets can be added per project.
Note that each target will eagerly fetch and build all tools and toolchains when built, so consider splitting them up into workflow-specific targets if necessary.
- Run the
bazel_envtarget and follow the instructions to installdirenvand allowlist the.envrcfile:
$ bazel run //:bazel_env
====== bazel_env ======
✅ direnv is installed
❌ bazel_env's bin directory is not in PATH. Please follow these steps:
1. Enable direnv's shell hook as described in https://direnv.net/docs/hook.html.
2. Add the following snippet to a .envrc file next to your MODULE.bazel file:
watch_file bazel-out/bazel_env-opt/bin/bazel_env/bin
PATH_add bazel-out/bazel_env-opt/bin/bazel_env/bin
if [[ ! -d bazel-out/bazel_env-opt/bin/bazel_env/bin ]]; then
log_error "ERROR[bazel_env.bzl]: Run 'bazel run //:bazel_env' to regenerate bazel-out/bazel_env-opt/bin/bazel_env/bin"
fi
3. Allowlist the file with 'direnv allow .envrc'.
- Run the target again to get a list of all tools and toolchains:
====== bazel_env ======
✅ direnv is installed
✅ direnv added bazel-out/bazel_env-opt/bin/bazel_env/bin to PATH
Tools available in PATH:
* buildifier: @buildifier_prebuilt//:buildifier
* go: @rules_go//go
* jar: $(JAVABASE)/bin/jar
* java: $(JAVA)
Toolchains available at stable relative paths:
* jdk: bazel-out/bazel_env-opt/bin/bazel_env/toolchains/jdk
Build the bazel_env target to keep the tools and toolchains up-to-date with the Bazel build.
The target can also be executed with bazel run to print the list of tools and toolchains as well as clean up removed tools.
See the generated documentation for more information on the bazel_env rule.