[译] 编写 Bazel rules(一):simple binary rule

原文:Writing Bazel rules: simple binary rule 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2018-07-31,更新于 2025-09-08。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions Bazel 是 Google 开发的开源 build tool。它很适合大型项目,原因包括高度并行的 remote build 和 execution、remote caching、对多种语言的成熟支持,以及扩展到数十亿行代码规模的 monorepo 的能力。 与 Make 这类简单的 build tool,或 Maven 这类面向特定语言的工具相比,Bazel 的学习曲线可能相当陡峭,尤其是你想扩展 Bazel、让它做一些新事情的时候。 ...

2026-11-10 · 7 min · 1341 words · Jay Conrod

[译] 编写 Bazel rules(七):module extensions

原文:Writing Bazel rules: module extensions 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2025-10-14。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions 本文也发布在 EngFlow blog。 距离本系列上一篇文章最初发表,已经快六年了。这次有不少新内容可聊! 过去几年最大的变化,是引入了 Bazel modules,也就是 Bzlmod,并弃用了 WORKSPACE mode。我已经更新了前面的全部文章,使它们兼容 Bazel modules。这次则介绍新增的功能:如何编写 module extension,以及为什么需要它。 什么是 module extension? Bazel 的新 module system,与其他 build tool 使用的 package management system 相似,例如 Go modules、npm packages、Maven artifacts 和 Cargo crates。Module 作者先在 Bazel Central Registry(BCR) 发布一个版本,使用者再将它列入 MODULE.bazel,就能建立依赖。Bazel 启动时,会从包含当前目录的 root module 开始,对每个 MODULE.bazel 求值,并递归处理全部依赖,然后使用 minimal version selection 为每个依赖选定版本。 ...

2026-11-10 · 6 min · 1254 words · Jay Conrod

[译] 编写 Bazel rules(三):data 和 runfiles

原文:Writing Bazel rules: data and runfiles 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2020-02-01,更新于 2025-09-08。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions Bazel 有一个很方便的功能,可以简化 test 和 executable 的许多工作:通过 data attribute,让数据文件在运行时可用。你可能见过这样的 rule: cc_library( name = "server_lib", srcs = ["server.cc"], data = ["private.key"], ) 文件被列入 data attribute,或行为与 data 类似的 attribute 后,Bazel 会让通过 bazel run 启动的 executable 在运行时能够访问这些文件。这可用于 plugin、配置文件、certificate、key、resource 等许多场景。 ...

2026-11-10 · 3 min · 565 words · Jay Conrod

[译] 编写 Bazel rules(二):library rule、depset 和 provider

原文:Writing Bazel rules: library rule, depsets, providers 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2018-08-15,更新于 2025-09-08。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions 上一篇文章编写了一个 go_binary rule,用一组源文件编译并链接出 Go executable。这次我们来定义 go_library rule,用它编译一个可供其他 library 和 binary 依赖的 Go package。 本文关注 rule 之间如何传递信息,建立可供 linker 或类似 linking action 使用的 dependency graph。全部代码都来自 rules_go_simple 的 v2 branch。 ...

2026-11-10 · 5 min · 916 words · Jay Conrod

[译] 编写 Bazel rules(五):repository rules

原文:Writing Bazel rules: repository rules 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2019-11-09,更新于 2025-09-10。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions 前几篇文章中,我们写出了一套功能不多、但已经实用的 Bazel rules。不过,它们有一个大问题:依赖 host system 上安装的工具。这样一来,开发者就必须安装一些本来可能用不着的工具。团队成员最终很可能用着不同版本,构建出不同的 binary,程序也可能在一台机器上正常、换一台就不行。这还会破坏 remote execution 和 caching,因为 host 的 toolchain 未必存在于 remote platform。 ...

2026-11-10 · 4 min · 783 words · Jay Conrod

[译] 编写 Bazel rules(六):platform 和 toolchain

原文:Writing Bazel rules: platforms and toolchains 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2019-12-07,更新于 2025-09-10。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions Bazel 最重要的优势之一,是能将构建与 host system 隔离。这使 reproducible build 和 remote execution 成为可能,也让 Bazel 能扩展到巨型项目。但隔离并不完全自动:host platform、execution platform 和 target platform 可能各不相同,rule 必须与 Bazel 配合,确保使用正确的工具。 ...

2026-11-10 · 7 min · 1439 words · Jay Conrod

[译] 编写 Bazel rules(四):将逻辑移到 execution phase

原文:Writing Bazel rules: moving logic to execution 作者:Jay Conrod,曾在 Google 的 Go 团队工作,现就职于 EngFlow。 原文发表于 2018-12-26,更新于 2025-09-09。 译注:文中的“我”指原作者。版本号和工具行为保留原文发表或更新时的语境,示例代码与技术术语保留原样。 Writing Bazel rules 系列: 编写 Bazel rules(一):simple binary rule 编写 Bazel rules(二):library rule、depset 和 provider 编写 Bazel rules(三):data 和 runfiles 编写 Bazel rules(四):将逻辑移到 execution phase 编写 Bazel rules(五):repository rules 编写 Bazel rules(六):platform 和 toolchain 编写 Bazel rules(七):module extensions 本文会把新的逻辑放进 execution phase,进一步扩展这套 Bazel rules 的能力。跟着动手的读者可以在 rules_go_simple 的 v4 branch 找到新代码。 你可能还记得,Bazel 的工作分为三个阶段: Loading phase: Bazel 读取并求值 build file,找出用户要求构建的 target,并递归加载这些 target 的依赖所对应的 build file。这些工作在调用 Bazel 的机器上进行,target graph 会缓存在内存中。 Analysis phase: Bazel 对 target 及其依赖的 rule implementation function 求值。Implementation function 声明待生成的文件、生成文件所需的 action,以及 action 的输入。和 loading phase 一样,这些工作也在调用 Bazel 的机器上完成,action graph 会缓存在内存中。 Execution phase: Bazel 找出哪些文件已经过期,并执行生成这些文件所需的 action。Action 可以在本地 sandbox 中执行,也可以通过 execution service 远程执行。输出文件会缓存在本地,或存入 remote caching service。 Ruleset 作者可以为任意一个阶段编写代码,同一个问题也往往有多种解决办法。不过,execution phase 有许多优势。在这个阶段执行的代码可以完整地通过 I/O 访问源文件,因此能做更灵活的判断;可以用任意语言编写,因此可能比 Starlark 更快,也更灵活;工作还能分散到多台机器上执行,结果可以持久缓存,因此能让大型开发团队的构建更快。 ...

2026-11-10 · 6 min · 1229 words · Jay Conrod