Bazel Central Registry贡献者访谈：揭秘顶级开源项目维护经验

什么是Bazel Central Registry？

Bazel Central Registry（BCR）是Bazel外部依赖系统（"Bzlmod"）的默认注册表，托管在https://bcr.bazel.build/。作为Bazel生态系统的核心组成部分，BCR不仅托管Bazel特定库（通常称为"rulesets"）的元数据，还为没有上游Bazel支持的项目（最常见的是C/C++项目）提供中央托管服务。

成为BCR贡献者的终极指南

贡献前的准备工作

贡献者在提交补丁和贡献前需要完成几个关键步骤：

1. 签署贡献者许可协议（CLA）：所有贡献必须附带贡献者许可协议。您（或您的雇主）保留贡献的版权，这只是授予项目使用和重新分发您的贡献的权限。可以访问https://cla.developers.google.com/查看当前协议或签署新协议。

2. 了解贡献政策：BCR有严格的贡献政策，包括：

   • 所有对BCR仓库的更改必须作为拉取请求提交并进行审核
   • 仅添加原则：不得修改现有模块版本以确保构建的可重现性
   • 每个模块版本必须有一个presubmit.yml文件
   • BCR模块只能依赖BCR中已有的模块

提交贡献的完整流程

1. 准备贡献：确保您的贡献符合BCR的贡献政策和社区准则。

2. 提交拉取请求：所有提交，包括项目成员的提交，都需要审核。BCR使用GitHub拉取请求进行此目的。

3. 通过代码审核：您的拉取请求将由BCR维护者或模块维护者审核。审核过程中可能会有反馈和修改请求。

4. CI检查：确保您的贡献通过所有CI检查。如果PR的CI检查因presubmit.yml更改而被阻止，维护者需要在应用presubmit-auto-run标签前审查这些更改。

5. 合并贡献：一旦您的贡献通过审核并通过所有CI检查，就会被合并到BCR中。

如何成为BCR维护者？

成为BCR维护者是参与项目深度贡献的绝佳方式。以下是成为维护者的步骤和责任：

成为BCR维护者的路径

1. 积累贡献经验：在成为BCR维护者之前，建议先贡献和维护一个Bazel模块。

2. 提交维护者申请：所有维护者请求将由Rules Authors SIG和Bazel团队审核批准。

BCR维护者的核心责任

• 审核和接受贡献：审查并接受符合BCR贡献政策的社区贡献。维护者可以合并他们仔细审查并通过CI的任何PR。

• 评估BCR健康状况：通过监控BCR测试和服务基础设施来评估BCR的健康状况。

• 任命模块维护者：识别并任命模块维护者，确保每个模块都有专人负责。

• 处理问题：在BCR GitHub仓库中分类和处理问题。

维护者审核PR的实用指南

BCR维护者在审核PR时应记住以下关键步骤：

• 新模块名称检查：确保模块名称简洁明确，避免过于通用的名称。如果项目托管在GitHub上，星标的数量可以提供一个很好的基本信号。

• 鼓励模块维护：当PR添加一个没有现有维护者的模块时，鼓励PR作者承担模块维护职责。

• 版本兼容性检查：当模块版本使用覆盖时，提醒PR作者包含至少7.2.1的bazel_compatibility。

• C++模块检查：对于包含BUILD补丁或覆盖的C++模块，鼓励使用与模块本身同名的构建目标，并仔细检查可见性规范。

模块维护者的角色与责任

每个模块都必须在其metadata.json文件中提供维护者列表。第一个为Bazel模块做出贡献的人可能会被任命为模块维护者。

模块维护者的主要职责

• 审核和批准更改：审查和批准与指定Bazel模块相关的更改。模块维护者可以使用正常的GitHub PR审查流程来批准PR。

• 更新模块版本：为指定的Bazel模块更新新版本。

• 问题处理：作为其分配模块的问题联系点。

与维护者沟通的最佳方式

• 优先使用公共渠道：尽可能在GitHub上公开进行所有沟通。

• 使用指定渠道：通过GitHub或Slack联系维护者。当无法通过GitHub联系时，可以通过Slack群组bzlmod联系维护者。

• 理解维护时间线：维护者是社区的志愿者，大多数PR可能会在3个工作日内得到处理。如果PR没有标记"awaiting user response"标签，那么注册维护者应该在3天内处理。

如何开始贡献？

1. 克隆仓库：首先克隆BCR仓库

   git clone https://gitcode.com/GitHub_Trending/ba/bazel-central-registry
   

2. 阅读贡献指南：详细阅读贡献指南和BCR政策。

3. 选择一个模块：可以选择一个现有模块进行改进，或添加一个新模块。

4. 提交PR：按照贡献流程提交您的第一个PR，体验完整的贡献过程。

BCR作为Bazel生态系统的关键组成部分，为开发者提供了一个集中管理和共享Bazel模块的平台。通过贡献BCR，您不仅可以帮助改进Bazel生态系统，还能获得宝贵的开源项目维护经验。无论您是Bazel新手还是经验丰富的开发者，都欢迎加入BCR社区，为这个顶级开源项目贡献自己的力量！