参与贡献
Jaeger 是一个具有开放治理 的开源项目。我们欢迎社区贡献,并很高兴能获得您的帮助来改进和扩展该项目。下面是一些关于如何参与项目贡献的建议。其中一些甚至不需要任何编程。还有一个很好的 CNCF 指南,介绍如何开始为开源做贡献并确定从何处入手 。
训练营
为了更好地理解项目并提出合理的解决方案,熟悉 Jaeger 及其代码库总是有益的。我们强烈建议以下步骤
- 阅读一些 Jaeger 教程,例如这篇博客文章 或这个视频 。
- 亲自运行HotROD 演示 。博客和视频可能已过时,亲自动手很有帮助。
- 回顾Jaeger 架构 并理解其组件。
- Fork 并克隆相应的仓库,以便能够在本地构建和运行项目 。
- 学习贡献的最佳实践,包括如何签署您的代码和进行贡献 。
- 尝试解决一些您可以在 Jaeger 仓库中找到的简单未解决问题。
非编程贡献
加入在线聊天室,帮助解答社区其他成员的问题。
加入我们每两周一次的视频会议,讨论问题、大型倡议或展示案例研究。
帮助记录常见问题的答案,可以在Jaeger 文档 或Stackoverflow 上进行。
帮助改进Jaeger 文档 ,特别是当您自己遇到某些内容不清晰或不工作的问题时。
发表关于 Jaeger 的博客文章或教程,例如
- 您公司选择了哪种部署模型以及原因。
- 如何将 Jaeger 与托管存储解决方案(如 AWS Elasticsearch)结合使用。
- 您在组织中通过 Jaeger 解决了哪些问题。
- 您如何为非简单的流程(例如异步处理)建模 traces。
提示
- 在@Jaegertracing 发布您的博客文章推文,并发送电子邮件至
jaeger-tracing@googlegroups.com
。 - 如果您的博客发布在 Medium 上,请联系维护者,我们可能会将其添加到我们的官方博客中 。
倡导在您的公司部署 Jaeger。
提出在 Jaeger 中构建新功能的方案设计。
组织本地线下活动,讲解 Jaeger 和分布式追踪的好处。
编程贡献
当然,参与 Jaeger 的实际开发也有很多机会。最容易上手的方式是处理被标记为good-first-issue 的问题。请注意,Jaeger 项目包含许多不同的仓库 ,涵盖后端组件、Jaeger UI、Kubernetes 工具、分析工具等。其中许多仓库都有这些问题标签,所以您可以选择最感兴趣的领域。
另一个值得关注的标签是help-wanted ,我们用它来标记维护者认为有前景/有用但不在当前路线图上的功能(毕竟,我们都有自己的本职工作,优先级不同)。
- Jaeger 后端: good-first-issue , help-wanted
- Jaeger 前端: good-first-issue , help-wanted
请参考贡献指南 了解如何进行代码贡献。并确保遵守CNCF 行为准则 。
如果有人已经在处理某个问题怎么办?
我们有一项政策 ,不会明确将问题分配给任何人。但是,您可能会发现已经有人创建了拉取请求(它会显示在评论区和/或问题标题正下方)。在这种情况下,问题通常处于以下三种状态之一
- PR 有作者最近的更新(一周内),意味着作者正在积极处理。在这种情况下,最好等待作者完成工作。
- PR 上最新的评论来自维护者,建议进行一些更改,但作者尚未处理这些评论,因此 PR 看起来已经过时。在这种情况下,最好在 PR 中提及作者,询问他们是否还在继续处理,或者是否愿意将任务交给其他人。
- 有时事情可能会被遗漏,维护者会错过 PR 上的最新更改。如果这些最新更改看起来不错(例如 CI 检查全部通过)但维护者尚未审查,最好在 PR 中提醒维护者进行审查。如果能帮助审查就更好了。
辅导计划
Jaeger 项目定期通过 CNCF 参与辅导计划。请参阅辅导计划。