Kubernetes 是一个快速发展的开源项目,它依赖于贡献者和用户来维护和改进它。我们的目标是成为一个开放、包容、友好的社区,并且总是很高兴看到新面孔加入我们。
您不必是一位经验丰富的系统工程师才能做出贡献。您甚至不必是软件工程师;我们欢迎技术作家、项目经理和学生。您可以通过多种方式为 Kubernetes 做贡献,并非所有方式都涉及代码。您可以参加会议并在会上发言、在 Slack 上提问以及提交 issue。
加入开源社区的最佳方式之一是做出贡献,本文旨在帮助您首次贡献取得成功。
沟通
加入 Kubernetes Slack。Kubernetes 是一个不断发展的社区,这意味着我们仍在弄清楚如何记录所有内容,通常摆脱困境的最佳方法是从更有经验的贡献者那里寻求帮助。事实上,在每个月第二个星期三,我们都会举办一个“Meet Our Contributors”视频聊天,就是为了这个目的。在 Kubernetes 社区日历 和相应的 Slack 频道 #meet-our-contributors 中查找它。您还可以在以下频道中找到帮助:#kubernetes-users、#kubernetes-novice 或 #sig-contribex。
完成基本操作
您应该熟悉 GitHub 的工作原理,以及 Kubernetes 项目的 GitHub 工作流程。
找到您的问题
选择您要处理的第一个 issue 取决于您贡献的动机以及您的技术舒适度。您可以选择修复现有 issue 或提交新 issue。
选择贡献可能会在使用 Kubernetes 的过程中自然而然地发生。假设您注意到一个错误并想修复它,或者您想到一个您希望添加的功能。您非常熟悉语言和工具,这对您来说不会太困难。
浏览开放的 GitHub issue,看看是否可以找到相关的开放 issue;如果没有,则创建一个。尽可能遵守 issue 和 pull request 模板中概述的指南。通过评论 issue 或在 Slack 中提问来征求社区的反馈,并在您开始工作之前与可能已经在处理该 issue 的任何人协调。
您可能还想做出贡献,因为您想了解 Kubernetes 并尝试在此过程中获得一些实践经验。在 Kubernetes 项目存储库中查找诸如“help wanted”或“good first issue”之类的标签。
一个很好的初学者方法是查找并修复错别字。这使您可以体验工作流程,而无需担心代码标准和技能。
掌握您的贡献
由于 Kubernetes 是一个庞大的项目,跨越多个存储库,并且拥有数千名成员,因此即使您在 GitHub 中标记了某人的名字,也很难引起注意。我们并非有意冒犯!
这就是 SIG(特别兴趣小组)的用武之地。这些是专注于项目各个部分的小型焦点小组,每个小组都有自己的 Slack 频道。不要犹豫,介绍自己并提出问题,即使您的问题是“我是否在与合适的人交谈?”
其中一些是自动化的;在新的 pull request 上,Kubernetes 机器人将添加一位审阅者,然后该审阅者可以添加一个 SIG 标签,这将提高代码所有者和熟悉该材料的审阅者的可见性。现有的 issue 很可能已经有一个 SIG 标签。
如果您要提交新的 GitHub issue,您可能很难找到合适的人来推销您的想法。与 pull request 不同,您不太可能有人为您添加 SIG 标签;您必须使用 机器人命令 自己执行此操作。浏览 SIG 列表 并尝试找出哪个是最相关的。 如果您不知道选择哪个 SIG,请不要太担心。以我的经验,与其完全不贴标签而让您的 issue 很快变得默默无闻,不如选错 SIG 并让其他人将其重新标记为不同的 SIG。
例如,要将 SIG contributor-experience
标签添加到 issue,请在评论中键入
/sig contributor-experience
万岁!您的 pull request 终于打开了。
但是等等!还有几个步骤。
您需要 Kubernetes 组织成员添加 /ok-to-test
标签到您的 pull request,以便可以运行测试套件。请耐心等待成员执行此操作。
- 确保您有一个 SIG 标签并遵循机器人提示。如果您遇到困难,请提问。
- 修复测试和审查期间出现的问题。
- 对您的审阅者保持礼貌和沟通。如果您的 pull request 没有得到审查,您可以在 Slack 中询问或分配另一位审阅者。
- 一旦您的 pull request 通过审核,机器人将自动合并它。
恭喜!您已完成首次向上游贡献。我保证随着练习,它会变得更容易。
本文是官方 Kubernetes 贡献者指南 部分内容的轻量级入门版本。如需成为贡献者的指导,请参阅 多个指导计划 以及 新贡献者视频办公时间。
Guinevere Saenger 将于今年 3 月 8-11 日在加利福尼亚州帕萨迪纳举行的 SCaLE16x 大会上发表演讲。要参加并获得 50% 的门票折扣,请使用促销代码 OSDC 注册。
1 条评论