参与贡献
Jaeger 是一个开放治理 的开源项目。我们欢迎社区贡献,并希望得到您的帮助来改进和扩展项目。下面是一些关于如何参与项目的建议。其中有些甚至不需要任何编码。还有一个很好的 CNCF 指南,介绍如何开始为开源项目做贡献以及从何开始 。
训练营
为了更好地理解项目并提出合理的解决方案,熟悉 Jaeger 及其代码库总是有帮助的。我们强烈建议遵循以下步骤:
- 阅读一些 Jaeger 教程,例如这篇博客文章 或这段视频 。
- 亲自运行HotROD 演示 。博客和视频可能已过时,最好亲自动手实践。
- 查阅Jaeger 架构并理解其组件。
- 派生并克隆相关仓库,以便能够在本地构建和运行项目 。
- 了解如何根据最佳实践进行贡献,包括如何签署代码和贡献 。
- 尝试解决一些可以在 Jaeger 仓库中找到的简单开放问题。
无需编码的参与
加入在线聊天室,帮助回答社区其他成员的问题。
加入我们的双周视频会议,讨论问题、大型倡议或展示案例研究。
帮助记录常见问题的答案,无论是在Jaeger 文档 中还是在Stackoverflow 上。
帮助改进Jaeger 文档 ,特别是当您遇到不清楚或不起作用的问题时。
发布关于 Jaeger 的博客文章或教程,例如:
- 贵公司选择了哪种部署模型以及原因。
- 如何将 Jaeger 与托管存储解决方案(如 AWS Elasticsearch)一起使用。
- 您通过 Jaeger 在您的组织中解决了哪些问题。
- 您如何为非简单工作流(如异步处理)建模跟踪。
提示
- 在 Twitter 上发布您的博客文章并@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 定期参与导师计划。请参阅导师计划。