如何玩转 Kubernetes 开源社区？这篇文章一定要看！

道客船长道客船长 2021-10-13

近日，「DaoCloud 道客」成功进入 Kubernetes 开源榜单累计贡献度全球前十，亚洲前三。基于在 Kuberntes 开源社区的长期深耕细作，「DaoCloud 道客」积累了一些心得，特写此文章，旨在帮助对开源贡献感兴趣的同学快速⼊⻔，并为之后的进阶之路提供⼀些参考和指导意义。

1. 了解 Kubernetes 开源社区

这⼀章节，你将了解整个 Kubernetes 社区是如何治理的：

1.1. 分布式协作

与公司内部集中式的项⽬开发模式不同，⼏乎所有的开源社区都是⼀个分布式、松散的组织，为此，Kubernetes 建⽴了⼀套完备的社区治理制度。协作上，社区⼤多数的讨论和交流主要围绕 issue 和 PR 展开。由于 Kubernetes ⽣态⼗分繁荣，因此所有对 Kubernetes 的修改都⼗分谨慎，每个提交的 PR 都需要通过两个以上成员的 Review 以及经过⼏千个单元测试、集成测试、端到端测试以及扩展性测试，所有这些举措共同保证了项⽬的稳定。

1.2. Committees

委员会由多人组成，主要负责制定组织的行为规范和章程，处理一些敏感的话题。常见的委员会包括行为准则委员会，安全委员会，指导委员会。

1.3. SIG

SIG 的全称是 Special Interest Group，即特别兴趣⼩组，它们是 Kubernetes 社区中关注特定模块的永久组织，Kubernetes 作为⼀个拥有⼏⼗万⾏源代码的项⽬，单⼀的⼩组是⽆法了解其实现的全貌的。Kubernetes ⽬前包含 20 多个 SIG，它们分别负责了 Kubernetes 项⽬中的不同模块，这是我们参与 Kubernetes 社区时关注最多的⼩组。作为刚刚参与社区的开发者，可以选择从某个 SIG 入手，逐步了解社区的⼯作流程。

1.4. KEP

KEP 的全称是 Kubernetes Enhancement Proposal，因为 Kubernetes ⽬前已经是⽐较成熟的项⽬了，所有的变更都会影响下游的使⽤者，因此，对于功能和 API 的修改都需要先在 kubernetes/enhancements 仓库对应 SIG 的⽬录下提交提案才能实施，所有的提案都必须经过讨论、通过社区 SIG Leader 的批准。

1.5. Working Group

这是由社区贡献者⾃由组织的兴趣⼩组，对现阶段的⼀些⽅案和社区未来发展⽅向进⾏讨论，并且会周期性的举⾏会议。会议⼤家都可以参加，⼤多是在国内的午夜时分。以 scheduling 为例，你可以查看文档 Kubernetes Scheduling Interest Group 了解例次会议纪要。会议使⽤ Zoom 进⾏录制并且会上传到 Youtube, 过程中会有主持⼈主持，如果你是新⼈，可能需要你进行自我介绍。

🔗https://docs.google.com/document/d/13mwye7nvrmV11q9_Eg77z-1w3X7Q1GTbslpml4J7F3A/edit%23heading%25253Dh.ukbaidczvy3r

1.6. MemberShip

角色	职责	要求
Member	社区积极贡献者	对社区有多次贡献并得到两名reviewer的赞同
Reviewer	对其他成员贡献的代码积极的review	在某个子项目中长期review和贡献代码
Approver	对提交的代码进行最后的把关，有合并代码的权限	属于某一个子项目经验丰富的reviewer和代码贡献者
Maintainer	制定项目的优先级并引领项目发展方向	证明自己在这个项目中有很强的责任感和技术能力

每种⻆⾊承担不同的职责，同时也拥有不同的权限。⻆⾊晋升主要参考你对社区的贡献，具体内容可参考 KubernetesMemberShip。

🔗https://github.com/kubernetes/community/blob/master/community-membership.md

1.7. Issue 分类

Kubernetes Issues 有很多 label，如 bug, feature, sig 等，有时候你需要对这些 issue 进⾏⼿动分类，关于如何分类可以参考以下文章链接。

🔗文章链接：https://hackmd.io/O_gw_sXGRLC_F0cNr3Ev1Q

1.8. 其他关注项

Slack：

🔗https://slack.k8s.io

StackOverFlow：

🔗https://stackoverflow.com/questions/tagged/kubernetes

Discussion：

🔗https://groups.google.com/g/kubernetes-dev

2. 开始你的 first-good-issue

更多详情可参见官⽅⽂档，⽂档详细描述了该如何提交 PR，以及应该遵循什么样的原则，并给到了⼀些最佳实践。

🔗官方文档：https://www.kubernetes.dev/docs/guide/contributing/

2.1. 申请 CLA

当你提交 PR 时，Kubernetes 代码仓库 CI 流程会检查是否有 CLA 证书，如何申请证书可以参考官⽅⽂档。

🔗官方文档：https://github.com/kubernetes/community/blob/master/CLA.md

2.2. 搜索 first-good-issue 「你可以选择你感兴趣的或你所熟悉的 SIG」

first-good-issue 是 Kubernetes 社区为培养新参与社区贡献的开发⼈员⽽准备的 issue，⽐较容易上⼿。

以 sig/scheduling 为例，在 Issues 中输⼊：

is:issue is:open label:sig/scheduling label:"good first issue" no:assignee

该 Filters 表示筛选出没有被关闭的，属于 sig/scheduling，没有 assign 给别⼈的 good first issue。

如果没有相关的 good-first-issue，你也可以选择 kind/documentation 或者kind/cleanup 类型 issue。

2.3.了解 issue 上下⽂，确定⾃⼰能够完成就通过 /assign 命令标记给⾃⼰。这⾥涉及到⼀些常⻅命令，如下所示；更多命令，⻅ Command-Help。

🔗Command-Hlep：https://prow.k8s.io/command-help?repo=kubernetes%25252Fkubernetes

/retitle	重命名标题
/close	关闭 issue
/assign	将 issue assign 给⾃⼰
/sig scheduling	添加标签 sig/scheduling
/remove-sig scheduling	去掉标签
/help	表示需要帮助，会打上标签 help wanted
/good-first-issue	添加标签 good first issue
/retest	重新测试出错的测试⽤例
/ok-to-test	准备好开始测试

2.4. 编码

a. Fork 代码仓库

将 kubernetes/Kubernetes fork 到⾃⼰的 GitHub 账号名下。

b. Clone ⾃⼰的代码仓库

git clone git@github.com:<your github id>/kubernetes.git

c. 追踪源代码仓库代码变动

添加 upstream：

git remote add upstream https://github.com/kubernetes/kubernetes.git

git remote -v 检查是否添加成功，成功则显示：

origin git@github.com:<your github id>/kubernetes.git (fetch) origin git@github.com:<your github id>/kubernetes.git (push) upstream https://github.com/kubernetes/kubernetes.git (fetch) upstream https://github.com/kubernetes/kubernetes.git (push)

同步 upstream kubernetes 最新代码

git checkout mastergit pull upstream master git push

d. 切分支，编码

git checkout -b <branch name>

e. Commit，并提交 PR

命令行：

git commit -s -m '<change me>'

注意：

commit push 前先执⾏一些检查，如 make update等

如果本次修改还没有完成，可以使⽤ Github Draft 模式，并添加 [WIP] 在标题中

Commit 信息过多，且没有特别⼤的价值，建议合成⼀条 commit 信息

git rebase -i HEAD~2

f. 提交 PR

在 GitHub ⻚⾯按照模版提交 PR

2.5. CI

a. PR 提交后需要执⾏ Kubernetes CI 流程，此时需要 Kubernetes Member 输入 /ok- to-test 命令，然后会⾃动执⾏ CI，包括验证和各种测试。可以 @ 社区成员帮助打标签。

b. ⼀旦测试失败，修复后可以执⾏ /retest 重新执⾏失败的测试，此时，你已经可以⾃⼰操作。

2.6. Code Review

a. 每次提交需要有 2 个 Reviewer 进⾏ Code Review，如果通过，他们会打上 /lgtm 标签，表示 looks good to me, 代码审核完成。

b. 另外需要⼀个 Approver 打上 /approve 标签，表示代码可以合⼊主⼲分⽀，GitHub 机器⼈会⾃动执⾏ merge 操作。

c. PR 跟进没有想像中那么快，有时候 1-2 周也正常。

d. 恭喜，你完成了第⼀个 PR 的提交。

3. 如何成为 Kubernetes Member

3.1. 官方文档要求对项目有多个贡献，并得到两个 revieweres 的同意

Sponsored by 2 reviewers and multiple contributions to the project

3.2. 贡献包括

PRIssueKepComment

3.3. 建议

a. 多参与社区的讨论，表达⾃⼰的观点

b. 多参与 issue 的解答，帮助提问者解决问题，社区的意义也在于此

c. 可以在看源代码的时候多留意⼀些语法、命名和重复代码问题，做⼀些重构相关的⼯作

d. 从测试⼊⼿也是⼀个好办法，如补全测试，或者修复测试

e. 参与⼀些代码的 review，可以学到不少知识

f. 最有价值的肯定是 feature 的实现，可以提交 kep

3.4. 关于如何获得 Reviewer 的同意

可以事先通过邮件打好招呼，把⾃⼰做的⼀些事情同步给他们，以及⾃⼰未来在开源社区的规划。

3.5. 结果

成为 Kubernetes Member 不是⽬的，⽽应该是⽔到渠成的结果。

4. 常用命令

参考 Makefile ⽂件

🔗https://github.com/kubernetes/kubernetes/blob/master/build/root/Makefile

单元测试（单方法）

go test -v --timeout 30s k8s.io/kubectl/pkg/cmd/get -run ^TestGetSortedObjects$

集成测试（单⽅法）

make test-integration WHAT=./vendor/k8s.io/kubectl/pkg/cmd/get GOFLAGS="-v" KUBE_TEST_ARGS="-run ^TestRuntimeSortLess$"

E2E 测试

可以使⽤ GitHub 集成的 E2E 测试：

/test pull-kubernetes-node-kubelet-serial

5. 小结

Kubernetes 和 Linux 一样,早已成为 IT 技术的重要事实标准，而开源 Kubernetes 是整个行业的 “上游”，灌溉了数亿的互联网和企业应用。「DaoCloud 道客」融合自身在各行各业的实战经验，持续贡献 Kubernetes开源项目，致力于让以Kubernetes为代表的云原生技术更平稳、高效地落地到产品和生产实践中。此外，「DaoCloud 道客」全面布局开源生态，是最早一批加入 CNCF 基金会的云原生企业，拥有云原生基金会成员，Linux 基金会成员，Linux 基金会培训合作伙伴，Kubernetes 培训合作伙伴，Kubernetes 兼容性认证，以及 Kubernetes 认证服务提供商等资质，坚持构建并维护云原生开源生态圈。在开源贡献这条道路上，「DaoCloud 道客」会一直走下去，也愿意成为开源社区的守护者、暸望塔，并始终坚信开源的力量、原生的力量会与这个时代产生共鸣，迸发出属于自己的光彩。

作者简介

殷纳

DaoCloud 云原生工程师

Kubernetes Member

专注 Kubernetes 及多集群管理开源工作

DaoCloud 公司简介

上海道客网络科技有限公司，成立于 2014 年底，公司拥有自主知识产权的核心技术，以云计算、人工智能为底座构建数字化操作系统为实体经济赋能，推动传统企业完成数字化转型。成立迄今，公司已在金融科技、先进制造、智能汽车、零售网点、城市大脑等多个领域深耕，标杆客户包括交通银行、浦发银行、上汽集团、东风汽车、海尔集团、金拱门（麦当劳）等。被誉为科技领域准独角兽企业。公司在北京、武汉、深圳、成都设立多家分公司及合资公司，总员工人数超过 300 人，是上海市高新技术企业、上海市“专精特新”企业和上海市“科技小巨人”企业，并入选了科创板培育企业名单。

网址：www.daocloud.io

邮件：info@daocloud.io

电话：400 002 6898

: ， . Video Mini Program Like ，轻点两下取消赞 Wow ，轻点两下取消在看

李光耀：过早翘起尾巴与美国对抗是中国厄运的开始！

劲爆！为了姜萍两位女CEO互揭老底！

谁会想到，裁员会裁到总编辑头上

消失11天的姜萍，这回麻烦大了…

“环评”提质增效助力高质量发展？

如何玩转 Kubernetes 开源社区？这篇文章一定要看！

1. 了解 Kubernetes 开源社区

1.1. 分布式协作

1.2. Committees

1.3. SIG

1.4. KEP

1.5. Working Group

1.6. MemberShip

1.7. Issue 分类

Kubernetes Issues 有很多 label，如 bug, feature, sig 等，有时候你需要对这些 issue 进⾏⼿动分类，关于如何分类可以参考以下文章链接。

1.8. 其他关注项

Slack：

🔗https://slack.k8s.io

StackOverFlow：

🔗https://stackoverflow.com/questions/tagged/kubernetes

Discussion：

🔗https://groups.google.com/g/kubernetes-dev

2. 开始你的 first-good-issue

2.3.了解 issue 上下⽂，确定⾃⼰能够完成就通过 /assign 命令标记给⾃⼰。这⾥涉及到⼀些常⻅命令，如下所示；更多命令，⻅ Command-Help。

2.4. 编码

2.5. CI

2.6. Code Review

3. 如何成为 Kubernetes Member

3.1. 官方文档要求对项目有多个贡献，并得到两个 revieweres 的同意

3.2. 贡献包括

3.3. 建议

3.4. 关于如何获得 Reviewer 的同意

可以事先通过邮件打好招呼，把⾃⼰做的⼀些事情同步给他们，以及⾃⼰未来在开源社区的规划。

3.5. 结果

成为 Kubernetes Member 不是⽬的，⽽应该是⽔到渠成的结果。

4. 常用命令

5. 小结

您可能也对以下帖子感兴趣

李光耀：过早翘起尾巴与美国对抗 是中国厄运的开始！

劲爆！为了姜萍两位女CEO互揭老底！

谁会想到，裁员会裁到总编辑头上

消失11天的姜萍，这回麻烦大了…

“环评”提质增效 助力高质量发展？

生成图片，分享到微信朋友圈

如何玩转 Kubernetes 开源社区？这篇文章一定要看！

1. 了解 Kubernetes 开源社区

1.1. 分布式协作

1.2. Committees

1.3. SIG

1.4. KEP

1.5. Working Group

1.6. MemberShip

1.7. Issue 分类

Kubernetes Issues 有很多 label，如 bug, feature, sig 等，有时候你需要对这些 issue 进⾏⼿动分类，关于如何分类可以参考以下文章链接。

1.8. 其他关注项

Slack：

🔗https://slack.k8s.io

StackOverFlow：

🔗https://stackoverflow.com/questions/tagged/kubernetes

Discussion：

🔗https://groups.google.com/g/kubernetes-dev

2. 开始你的 first-good-issue

2.3.了解 issue 上下⽂，确定⾃⼰能够完成就通过 /assign 命令标记给⾃⼰。这⾥涉及到⼀些常⻅命令，如下所示；更多命令，⻅ Command-Help。

2.4. 编码

2.5. CI

2.6. Code Review

3. 如何成为 Kubernetes Member

3.1. 官方文档要求对项目有多个贡献，并得到两个 revieweres 的同意

3.2. 贡献包括

3.3. 建议

3.4. 关于如何获得 Reviewer 的同意

可以事先通过邮件打好招呼，把⾃⼰做的⼀些事情同步给他们，以及⾃⼰未来在开源社区的规划。

3.5. 结果

成为 Kubernetes Member 不是⽬的，⽽应该是⽔到渠成的结果。

4. 常用命令

5. 小结

您可能也对以下帖子感兴趣

李光耀：过早翘起尾巴与美国对抗是中国厄运的开始！

“环评”提质增效助力高质量发展？