Migrate to Bazel 8 by lolski · Pull Request #427 · typedb/bazel-distribution

lolski · 2026-02-23T13:55:07Z

Motivation

Update Bazel version from 6.2 to 8.5.1.

The upgrade is done in a backwards-compatible way, such that "upstream" repositories that are yet to be upgraded may depend on this repository. This is done by preserving a few Bazel 6 configs (WORKSPACE, etc) alongside the new Bazel 8 ones. Once every repositories have been upgraded to Bazel 8, these files will be removed.

Implementation

Create MODULE.bazel

The new module declaration is organized into these sections:

Module ID and version
Common/util declarations needed by subsequent declarations
Build dependencies
Languages and toolchains: where we declare our Rust, Kotlin, Python, and other languages we use
Platform definitions for doing architecture and OS selections
Package managers: pip, maven
Assembly and deployments
Docs

We've also done syntactic changes to fix broken rules during the upgrade, here's a few examples:

The deprecated cfg = "host" updated to cfg = "exec"
output_to_genfiles = True removed in various places.
struct.to_json() to json.encode()

The following files are kept for backwards compatibility, and will be removed when all repos have been

WORKSPACE: Deprecated with notice; updated dep versions to match MODULE.bazel; added rules_cc() call

- Add .bazelrc with enable_workspace=true (required for Bazel 8) - Update .bazelversion to 8.0.0 - Replace cfg = "host" with cfg = "exec" (deprecated in Bazel 8) - Remove output_to_genfiles attribute (removed in Bazel 8) - Update rules_python to 1.0.0 (PyInfo provider moved) - Update rules_rust to 0.56.0 - Add rules_cc 0.0.17 dependency - Update rules_jvm_external to 6.6 Note: Build is blocked on Java toolchain compatibility issues. See dependencies/bazel-8-upgrade-plan.md for details.

Switch from WORKSPACE to MODULE.bazel as the primary build configuration. This enables rules_java 8.x which is required for Bazel 8 (rules_java 7.x creates dependency cycles in WORKSPACE mode). - Add MODULE.bazel with BCR dependencies and extension configurations - Remove --enable_workspace=true from .bazelrc (Bzlmod now default) - Add deprecation notices to WORKSPACE and legacy .bzl files - WORKSPACE kept functional for backward compatibility

The doc_hub.bzl loads rules from //docs/doxygen:rules.bzl and //docs/python:rules.bzl which requires these directories to be Bazel packages. Add BUILD files with bzl_library targets and move the sphinx_runner target to the python subpackage.

Note: LLVM toolchain configuration moved to typedb_dependencies repo, which is the root module when building downstream repos.

Configure toolchains_llvm for standalone builds only using dev_dependency. This allows bazel-distribution to build independently while avoiding conflicts when used as a dependency (where the root module must configure its own LLVM toolchain).

Documents current Bzlmod migration state: - 52/53 targets build successfully - Only //:docs targets fail (stardoc/bzl_library issue)

The struct.to_json() method was removed in Bazel 8. Use json.encode() which is the new standard way to encode objects to JSON.

Set TZ=UTC in the sphinx runner environment to fix babel/zoneinfo error in sandboxed Bazel builds where TZ may be set to /UTC.

Bazel 8 requires directory outputs to be declared with declare_directory() rather than attr.output(). Changed to use attr.string + declare_directory, matching the doxygen_docs rule.

Reorganize the flat MODULE.bazel structure into clearly delineated sections so that related bazel_dep, extension, toolchain, and use_repo calls are co-located. No functional changes.

lolski · 2026-02-24T12:01:17Z

.factory/automation.yml

      type: foreground
      command: |
-        bazel build //...
+        bazel build //... --extra_toolchains=@llvm_toolchain//:all -- -//:docs -//:docs.extract


Excluded docs since I can't yet get it to work

dmitrii-ubskii

Mostly questions.

The following files are kept for backwards compatibility [...]
.bazelrc: Created with Bzlmod migration comment

No it wasn't 🤔
But even so, is .bazelrc even deprecated? I see no indication of that in the docs (https://bazel.build/versions/8.5.0/run/bazelrc)

.bazelversion

WORKSPACE

MODULE.bazel

common/deps.bzl

MODULE.bazel

dmitrii-ubskii · 2026-02-27T12:08:49Z

maven/deps.bzl

-    "com.eclipsesource.minimal-json:minimal-json",
+    "com.eclipsesource.minimal-json:minimal-jsonz",


Use Label() instead of a plain string for the uploader dep in all deploy macros (artifact, maven, pip, apt, helm). Plain string labels in macros are resolved relative to the calling repo, causing 'no such package common/uploader' errors when macros are invoked from external repos. Label() resolves relative to the .bzl file's own repo at load time. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

The label `//docs:doxygen/doxyfile.template` references a file across a package boundary. Since `docs/doxygen/` has its own BUILD file, the correct label is `//docs/doxygen:doxyfile.template`. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

agluszak added 2 commits February 29, 2024 17:28

Migrate to bzlmod, bump deps

844ca9b

Format

ec83b01

lolski requested a review from alexjpwalker as a code owner February 23, 2026 13:55

lolski force-pushed the bazel-8-upgrade branch from 0e87a93 to 2619736 Compare February 23, 2026 13:57

lolski changed the title ~~Upgrade to Bazel 8~~ Migrate Bazel to version 8 Feb 24, 2026

lolski changed the title ~~Migrate Bazel to version 8~~ Migrate to Bazel 8 Feb 24, 2026

lolski added 16 commits February 24, 2026 13:48

Add MODULE.bazel.lock for reproducible builds

7a70125

Add BUILD files to docs subdirectories for Bzlmod compatibility

a3aeb41

Note: LLVM toolchain configuration moved to typedb_dependencies repo, which is the root module when building downstream repos.

Add BZLMOD_MIGRATION_STATUS.md documenting build status

a0c939b

Documents current Bzlmod migration state: - 52/53 targets build successfully - Only //:docs targets fail (stardoc/bzl_library issue)

Add rules_nodejs, ghr archives, and Node.js toolchain for Bzlmod

902fcd1

Fix Bazel 8 compatibility: use json.encode() instead of to_json()

44bc27c

The struct.to_json() method was removed in Bazel 8. Use json.encode() which is the new standard way to encode objects to JSON.

Fix babel timezone error in sphinx_docs rule

468a8c2

Set TZ=UTC in the sphinx runner environment to fix babel/zoneinfo error in sandboxed Bazel builds where TZ may be set to /UTC.

Fix sphinx_docs directory output for Bazel 8

88ea4e2

Bazel 8 requires directory outputs to be declared with declare_directory() rather than attr.output(). Changed to use attr.string + declare_directory, matching the doxygen_docs rule.

Update MODULE.bazel.lock

cebc7f7

Refactor MODULE.bazel into thematic sections

fef6bf5

Reorganize the flat MODULE.bazel structure into clearly delineated sections so that related bazel_dep, extension, toolchain, and use_repo calls are co-located. No functional changes.

Trigger CI

0da4e9f

wip

c7b9595

wip

ebed626

lolski force-pushed the bazel-8-upgrade branch from a3d729d to ebed626 Compare February 24, 2026 13:49

lolski commented Feb 24, 2026

View reviewed changes

wip

b4740b5

lolski requested a review from dmitrii-ubskii February 24, 2026 13:53

lolski added priority: blocker domain: build labels Feb 24, 2026

dmitrii-ubskii reviewed Feb 24, 2026

View reviewed changes

.bazelversion Outdated Show resolved Hide resolved

WORKSPACE Show resolved Hide resolved

MODULE.bazel Show resolved Hide resolved

common/deps.bzl Show resolved Hide resolved

MODULE.bazel Outdated Show resolved Hide resolved

MODULE.bazel Show resolved Hide resolved

wip

72d0ca5

lolski added 3 commits February 25, 2026 15:37

wip

1fabd8f

wip

bcb8380

wip

9796c94

dmitrii-ubskii self-requested a review February 27, 2026 12:06

dmitrii-ubskii approved these changes Feb 27, 2026

View reviewed changes

lolski and others added 3 commits February 27, 2026 18:29

wip

9b04ae7

wip

5c77681

lolski force-pushed the bazel-8-upgrade branch from b849197 to b42e1df Compare March 16, 2026 12:30

lolski and others added 2 commits March 26, 2026 16:55

Fix jar_file uninitialized variable in collect_maven_coordinate aspect

88f291a

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Migrate to Bazel 8#427

Migrate to Bazel 8#427
lolski wants to merge 28 commits intomasterfrom
bazel-8-upgrade

lolski commented Feb 23, 2026 •

edited

Loading

Uh oh!

lolski Feb 24, 2026

Uh oh!

dmitrii-ubskii left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dmitrii-ubskii Feb 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		"com.eclipsesource.minimal-json:minimal-json",
		"com.eclipsesource.minimal-json:minimal-jsonz",

Conversation

lolski commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation

Implementation

Create MODULE.bazel

Uh oh!

lolski Feb 24, 2026

Choose a reason for hiding this comment

Uh oh!

dmitrii-ubskii left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dmitrii-ubskii Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lolski commented Feb 23, 2026 •

edited

Loading