如何参与 Apache Mesos 开源社区:沟通渠道、贡献流程与工作组指南
如何参与 Apache Mesos 开源社区:沟通渠道、贡献流程与工作组指南
Apache Mesos 是一个由成员共同组织的开源社区:无论你是运行或编写 framework 的用户,还是深入核心代码的开发者,都可以通过邮件列表、Slack、本地用户组、JIRA 问题跟踪与补丁贡献等途径参与其中。本文以仓库中官方 Community 页面为核心,结合 docs/ 下的贡献指南与 support/ 下的协作工具配置,系统梳理提问、报告 bug、提交补丁以及加入工作组的完整路径,帮助你快速找到适合自己的参与方式。
社区概览:一个由成员组织的开源社区
Apache Mesos 的社区由它的成员共同组织——包括正在阅读本文的你。官方社区页面(site/source/community.html.md)开篇即点明了这种组织方式:无论你处于哪个角色,都有机会与社区取得联系、提出问题、在本地参与活动,并为项目做出贡献。若想了解哪些组织正在生产环境中使用 Mesos,可以参考仓库中的 Powered By Mesos 列表。
社区的基础设施围绕两套协作工具运转:JIRA(问题跟踪)与 Review Board / GitHub(代码评审),配合若干邮件列表与实时聊天渠道。下面的章节将逐一展开。
沟通渠道:从哪里提问、从哪里同步进展
邮件列表:社区的正式沟通主干
邮件列表是 Apache 项目的"法定"沟通渠道,Mesos 为不同目的维护了多条列表。每条列表都支持标准的订阅与退订方式:向对应的 -subscribe@mesos.apache.org 地址发送邮件即可订阅,向 -unsubscribe@mesos.apache.org 发送邮件即可退订(邮件正文可留空或写任意内容)。所有列表的历史消息均可在 lists.apache.org 上按列表名检索归档。
| 列表 | 订阅地址 | 退订地址 | 用途 |
|---|---|---|---|
| Users | user-subscribe@mesos.apache.org | user-unsubscribe@mesos.apache.org | 用户提问与使用讨论 |
| Developers | dev-subscribe@mesos.apache.org | dev-unsubscribe@mesos.apache.org | 开发者协作、设计讨论、版本规划 |
| JIRA Updates | issues-subscribe@mesos.apache.org | issues-unsubscribe@mesos.apache.org | JIRA 问题动态通知 |
| Reviews | reviews-subscribe@mesos.apache.org | reviews-unsubscribe@mesos.apache.org | Review Board 评审动态 |
| Jenkins Builds | builds-subscribe@mesos.apache.org | builds-unsubscribe@mesos.apache.org | 持续集成构建结果 |
| Commits | commits-subscribe@mesos.apache.org | commits-unsubscribe@mesos.apache.org | 代码提交通知 |
| Modules | modules-subscribe@mesos.apache.org | modules-unsubscribe@mesos.apache.org | 模块相关讨论 |
在实际使用中,dev@mesos.apache.org 列表承担了最多的开发讨论,工作组的例行会议纪要与通知也统一发往该列表(详见下文"工作组"章节)。在提问或求助前,建议先检索邮件列表归档,避免重复提问。
Slack、IRC 与 Matrix:实时讨论
- Slack:开发者和用户在
mesos.slack.com上实时交流;可通过官方邀请渠道申请加入。历史上 Slack 标准版由 Criteo 赞助。 - IRC / Matrix:Slack 频道同时镜像到 freenode 的
#mesos频道以及 Matrix 上的#mesos房间;不熟悉 IRC 的新手可以使用基于 Web 的客户端访问#mesos频道。 - Twitter:关注
@ApacheMesos可以获取项目动态。
本地用户组(Mesos User Groups)
除了线上渠道,社区还有分布在各城市的 Mesos User Groups(MUG)负责组织本地 meetup、hackathon 等活动,以促进 Mesos 的采用与交流。完整的本地组织列表见 site/source/community/user-groups.html.md,覆盖比利时、中国(上海/深圳/西安)、法国、德国、印度、日本、荷兰、波兰、英国、美国等国家与地区。
如果你想在自己的城市创建 MUG,文档给出的路径很简单:在用户列表 user@mesos.apache.org 上表达兴趣,社区会把你加入名单。MUG 通常借助 Meetup 或 Twitter 组织活动,社区鼓励至少由两个组织共同牵头,并分担活动的承办与组织责任。
报告与跟踪问题:JIRA 的正确用法
所有 bug、改进与功能请求都由 Apache 托管的 JIRA issue tracker(项目代号 MESOS)统一跟踪。在使用前需要注意:
- 报告问题前需要在 JIRA 注册账号;
- 每个任务、功能、bug 修复都应创建对应的 JIRA,以便跟踪进度;
- 报告时尽量提供充分的上下文(复现步骤、环境、期望行为等);
- 如果你打算自己动手解决某个 ticket,请先把它 assign 给自己,避免与其他贡献者重复劳动,也能让关注该 issue 的人及时获知进展。
更详细的规范见 docs/reporting-an-issue.md,其中强调:强烈建议在动手前与社区讨论解决方案,并引用 Beginner Contribution Guide 与 Advanced Contribution Guide 了解后续的开发参与方式。
贡献补丁:两条并行的路径
Mesos 依赖社区来测试版本、发现 bug、贡献修复与功能,并对现有 API 提供反馈。官方根据改动规模提供了两条贡献路径:
路径一:初学者路径(GitHub Pull Request)
这是面向首次贡献者的轻量流程,最适合纯文档修改和琐碎修复,详见 docs/beginner-contribution.md。流程要点:
- 获取源码:Fork Apache Mesos 的 GitHub 镜像仓库,克隆到本地。纯文档改动无需构建项目;功能改动则需先按 docs/building.md 安装依赖并完成构建。
- 找到要解决的问题:可以在 JIRA 上寻找尚未分配、且带有
newbie、newbie++、beginner、beginners标签的 ticket 作为起步项目;也可以在 Mesos Slack 或开发者列表上咨询 committer,确认哪些工作对社区价值更高。 - 动手修改:注意同步更新
docs/下的文档,并在src/tests/中补充或更新测试。 - 构建与测试:代码改动需要在提交 PR 前运行
make check并确保全部通过;纯文档改动则用 Markdown 预览器核对渲染效果。 - 提交 PR:将本地分支推送到自己的 fork,向 Apache Mesos 仓库发起 Pull Request,然后在 Slack 或开发者列表上通知社区。
./support/setup-dev.sh 会安装 git hooks,帮助你在提交时自动遵循 Mesos 的代码风格——仓库中的 support/pre-commit-config.yaml 就定义了 license 头检查、提交拆分检查(support/mesos-split.py)与 cpplint 等本地 hook。
路径二:进阶路径(JIRA + Review Board 工作流)
对于影响较大、涉及多个组件的改动,官方采用 Apache 标准的 JIRA + Review Board 工作流,详见 docs/advanced-contribution.md。
前置条件:
- Apache JIRA 账号与 Review Board 账号;
- RBTools(0.7.10 已知可用,1.0.1 曾出现已知问题)与 pre-commit 工具。
编码之前:
- 在 JIRA 找到未分配的 issue(优先选择状态为 "Accepted" 的 ticket,意味着至少有一位开发者认可其价值),或自己创建;
- 将 ticket assign 给自己(JIRA 管理员把你的账号升级为 contributor 后即可操作);
- 在 ticket 内及早讨论方案,获取 reviewer 反馈;
- 找到一位 shepherd(即愿意指导并最终提交你改动的 committer),可通过开发者列表、ticket 评论@相关 maintainer、或 Slack/IRC 渠道联系。
创建补丁:
- 遵循测试驱动开发:先编写会失败的测试用例(参考 docs/testing-patterns.md);
- 阅读 Mesos C++ Style Guide,建议通过 git pre-commit hook 自动检查风格;
- 在仓库根目录依次执行
./bootstrap、./support/setup-dev.sh,并在独立 build 目录中构建:mkdir build && cd build && ../configure && make,避免生成文件污染src/; - 运行
make check确保单元测试全部通过;可配合GTEST_FILTER过滤单个用例(如make check GTEST_FILTER="HTTPTest.Delete"),并用--gtest_repeat反复运行新测试以排查不稳定失败; - 将改动拆分为多个原子 commit,每个 commit 代表一个逻辑独立的变化;commit message 使用过去时态,首句以大写字母开头、不超过 72 个字符并以句号结尾——仓库 support/gitlint 中即配置了
^[A-Z].*\.$的标题正则与 72 字符的行长限制; - 提交前用
git diff master核对改动范围,必要时git rebase master保持分支与主干同步。
提交评审:
- 使用
post-reviews.py(support/下针对post-review的封装)提交评审:先ln -s support/reviewboardrc .reviewboardrc软链示例配置——该配置指向 Review Board 服务器、mesos仓库并预设评审目标组(见 support/reviewboardrc); - 从本地分支运行
support/post-reviews.py,它会为每个相对master的新 commit 创建一条评审; - 在评审的 "Bugs" 字段填入 JIRA 编号(自动关联),在 "Reviewers" 中加上你的 shepherd,在 "Description" 中说明新增/受影响的文档,在 "Testing Done" 中描述测试过程;
- 等待 committer 给出 "Ship It";期间逐条回复评审意见("Done." 或解释处理方式),并通过
git rebase -i调整已有 commit 而非新建 commit; - 收到 "Ship It" 后由 committer 合入仓库,最后补全或更新相关文档。
在进阶贡献中还有一个关键文件:docs/contributors.yaml。它把贡献者映射到其 JIRA 与 Review Board 账号,用于追踪各组织对 Apache Mesos 的贡献;首次提交 PR 时应在其中为自己添加条目(email 字段填写本地 git 客户端配置的邮箱,affiliations 可选填或省略)。
从贡献者到 committer
提交合入并不是终点。Apache Mesos committer 是获得代码仓库与相关基础设施写权限的贡献者,每位 committer 同时也是 PMC 的投票成员。候选人的考察维度在 docs/committer-candidate-guidelines.md 中有详细列举:对 Apache Way 的理解、对项目目标的认同、对项目的承诺、在项目中的知识广度与深度、以及在已知领域之外的判断力。最务实的路径,就是持续参与开发者讨论并提交高质量补丁。
此外,docs/committers.md 还定义了 Maintainer 机制:maintainer 是长期投入某个组件维护的 committer,负责及时反馈 bug 与评审、保证代码可读性与测试覆盖、控制技术债并遵循风格指南。改动功能、修复非平凡 bug、非平凡重构、性能改进或大量文档更新,都建议咨询对应组件的 maintainer;而修 typo、琐碎修复等则通常无需征询。
如果你的评审长期无人回应,可以参考 docs/reopening-reviews.md:确认 JIRA 已存在且被社区接受、你已 assign 到该 issue、主动联系 maintainer 或 shepherd,并更新评审内容以匹配最新的代码基线,再重新打开评审。
工作组(Working Groups):围绕特定方向的专题协作
随着社区规模扩大,大型且复杂的特性与组件会交由独立的工作组(Working Groups)推进。加入工作组可以与相关特性的利益相关者、贡献者和 committer 建立直接联系。官方对工作组的期望包括:
- 至少有一位 lead,负责组织并推动小组会议;
- 定期举行对公众开放、可录制并归档的(线上)会议;
- 维护会议纪要,并定期同步到
dev@mesos.apache.org列表; - 设有对应的 Slack 频道(同样公开归档)承载同步讨论;
- 往期会议视频发布到项目的 YouTube 频道;
- 工作组不设独立邮件列表,讨论统一走
dev@mesos.apache.org,发邮件时在主题前加工作组名作为标签:
[XXX WG] YOUR SUBJECT HERE
例如 API 工作组的邮件主题可写成 [API WG] Deprecate the v0 scheduler API。
社区当前活跃的工作组如下:
| 名称 | Leads | Slack 频道 | 会议安排 |
|---|---|---|---|
| Containerization(容器化) | Jie Yu, Gilbert Song | #containerizer | 每月第一个周四 9:00 AM PST |
| Performance(性能) | Benjamin Mahler | #performance | 每月第三个周三 10:00 AM PST |
| Community(社区) | Vinod Kone | #community | 隔周周一 10:30 AM PST |
| API | Greg Mann | #http-api | 隔周周二 11:00 AM PST |
经验丰富的贡献者在处理跨组件、影响深远的高级 JIRA ticket 时,也会采用类似的模式:由利益相关方组成工作组,产出设计文档,初始组建信息通过开发者同步会议、开发者列表、IRC 等社区渠道发布。
配套阅读与进一步深入
- 首次贡献:阅读 Beginner Contribution Guide,了解仅用 GitHub 即可完成的小改动流程;
- 深度贡献:阅读 Advanced Contribution Guide,掌握 JIRA + Review Board 完整工作流;
- 评审与设计:阅读 docs/effective-code-reviewing.md 与 docs/developer-guide.md,了解评审者视角与常用设计模式;
- 核心库:新贡献者应熟悉
stout(底层操作系统抽象库)与libprocess(并发组件库),分别见 3rdparty/stout/README.md 与 3rdparty/libprocess/README.md; - 社区页面源码:本指南的原始出处为 site/source/community.html.md,本地用户组列表见 site/source/community/user-groups.html.md。
Apache Mesos 社区的价值来自每一位参与者的持续投入:无论是提问、报告 bug、评审代码,还是牵头组织本地活动,都是在推动项目向前。从订阅一条邮件列表开始,你已经是社区的一部分。