资料下载 : https://tungstenfabric.org.cn/assets/uploads/files/tf-community-contribute.pdf
很多希望加入TF 的贡献者都会提出 “ 灵魂三问 ” :
l TF 存在中文社区和国际社区两个社区,两者之间的关系是什么?
l 如何加入TF 中文社区,我能得到什么,我又能做什么?
l TF 国际社区是如何工作的,有什么经验可以借鉴?
针对第一个问题:中文社区与国际社区是什么关系?
TF 中文社区和 TF 国际社区是完全资源共享,无缝对接的。受制于网络环境、沟通平台,以及语言和时差( TF 国际社区的开会时间为北京凌晨 0 点、 2 点和 4 点)的影响,中国的云计算从业者和网络工程师在进行云和 SDN 的学习实践过程中,无法实现国际和国内的技术资源的共享。 TF 中文社区的创建,是希望在 SDN 方面给大家搭建一个本地平台,在信息传递,资源共享与国际社区同步。同时,邀请国际社区的专家作为中文社区的技术专家,给予指导和帮助。此外,针对中国的应用场景和开发者,中文社区正在做大量本土化的工作,搭建本地平台,并建立国内的技术委员会。社区的参与者自愿加入,通过民间的 NGO 的形式来把中国的平台运营起来,聚拢中国的参与者,解决中国面临的行业问题。
目前可以通过以下方式进行资料获取和信息沟通:
l 微信号:TF 中文社区
l 官网网站:http://tungstenfabric.org.cn/
l 邮箱:tfzw001@163.com
针对第二个问题:如何加入TF 中文社区,我能得到什么,我又能做什么?
参与TF 中文社区的构建,参与全球最顶尖的开源云网络的项目,为云计算的网络分场贡献力量。这个过程让学习和使用 TF 的过程不再孤单,亲手安装部署使用,还有能够了解功能场景、技术原理和架构、开发和运维。与全球高手一道,是受惠者也是建设者。
技术上,TF 中文社区在文档、行业案例和需求整理,以及项目治理上,都将投入力量。在市场上,将在线上内容分享和线下活动上发力。目前, TF 中文社区技术委员会正在招募过程中,设置了文档工作组、社区联络工作组、行业案例工作组和基础架构工作组等四个工作组,会员征集活动现已开启,扫描下方二维码,快速直达会员在线申请 ——

l 文档工作组,负责TF 相关文档站点的维护,文档组织结构的整理、翻译、发布和更新;
l 社区联络工作组,负责TF 中文社区与国际社区及合作社区的联络工作;
l 行业案例工作组,负责与用户和成员企业联络,整理TF 的使用案例和需求;
l 基础架构工作组,为TF 中文社区官网和项目组的 CI/CD 流程提供技术支持。
针对第三个问题:TF 社区是怎么工作的?有什么经验可以借鉴?
我们整理了 Tungsten Fabric 国际社区代表 Edward Ting 在“ TF 中文社区成立暨第一次全员大会”上的演讲,有助于大家了解国际社区的治理规则。
Tungsten Fabric 国际社区代表 Edward Ting
自我介绍一下,我在Tungsten Fabric (以下简称 TF )做了大概两年半,社区的技术指导委员会( Technical Steering Committee ,简称 TSC )分两部分,有 TC 和 CC ,分别有 5 个 Member ,我是 TC 其中一个 Member 。
我在硅谷20 多年,从第一份工作开始,没有在别的地方上过班。我在台湾长大,父母亲是绍兴人,今天我会用中文讲,社区治理及如何贡献代码。
关于Tungsten Fabric 社区

这个是TF 国际社区的 Governance (社区治理), TF 是 Linux 基金会下的一个正式项目,我刚才讲的 TSC 就是整个 Governance 里的重要组成部分,其中有技术的工作组,也有社区的工作组。
目前来说,TSC 开会的时间都是在美国加州时间早上 8 点到 11 点,中国地区要拨进来的话,时间大概在半夜 12 点到 2 点钟左右。

技术工作组由四大部分组成,分别是ARB (架构审查委员会)、 IWG (基础设施工作组)、 MWG (市场工作组)、 DWG (文档工作组)。
开会的时间,IWG 是每两周的早上 8 点, DWG 是每个星期三上午 11 点, MWG 是星期二的下午 1 点钟,都是在加州时间。(编者注:北京凌晨 0 点、 2 点和 4 点)
目前社区里四大区块的活动,大概就是这样。

整个TF 国际社区的 Landing Page ,都已经放在 tungsten.io ,信息非常完整。今年我们花了很大的功夫,把整个资料都放在那里,你可以看到很多东西,包括各种演示和文档,开会的记录,还有去哪里参展,发表了什么论文等等,都在里面。
这里第一个就是Governance ,刚才介绍过了,包括社区、技术、市场、文档等。
第二个很重要,加入国际社区的话,你需要签一个CLA 协议( Contributor License Agreement ,贡献者许可协议),协议分两种,一个是个人,一个是公司。不管你要做什么贡献,第一件事就是去那边签这个协议。
第三个是Demos ,里面放了很多视频、演讲、不同活动上的 Demo 等。
其他的几个,不多介绍了。大家可以到页面上去点这些链接,就可以看到很细节的东西。

这里就是刚刚说的四个组开会的信息,如果你点击进去,它以前的会议信息都在里面,包括会议时间,讨论了什么内容等,每周或每两周开一次会,每个会都有一些文档在里面,信息非常完整。

另外你怎么找到参与者,最常用的是去Slack ,里面有 Dev , Documentation , General , Users 这几项。
Mailing Lists 有这么多,比如说国内要办活动,你到这边来,发个邮件到 Conference 里,说明要办活动的情况,社区上看到就会考虑怎么去做宣传。
再比如说你要签贡献者许可协议,把文档下载下来之后,发个邮件到cla 这边,那些 Linux 基金会的人就会记录下来,你就可以正式成为社区贡献者。
如果是开发的人员,最常用的应该是dev ,还有就是 security ,每个开源的软件都会有各种网络安全问题,你可以发邮件到那里去,然后会有人判别具体是不是安全问题。
有任何技术上的问题,都可以使用Mailing Lists ,去跟社区沟通和解决问题。

接下来就是社交资源,除了网站Web 社区,还有 Blog 在上面,然后我们还有领英 Linkedin ,在 Twitter 上面也经常有媒体会发新的消息。 Randy Bias 现在是我们的主 席,可以在 Linkedin 和 Twitter 上 follow 他。

那么代码在哪里呢?主要就是在Github 里。在 Dockerhub 也放了一个已经编好的 5.1 版本,是今年 6 月的时候 release 的,一旦社区有新的 release 的时候,都会放到 Dockerhub 里头,你可以去那边获取,然后就可以安装和使用。
你如果Code Review 的话,就放在 Gerrit 里面,地址是 review.tungsten.io 。最后,我们现在把所有的 blueprint 蓝图,就说你的 feature 你要什么样的功能,什么样子的东西,可以放到 blueprint 里头去找。
如何贡献代码

如何贡献代码呢?这是总体的概述,先要注册到mailing lists ,然后你要签 CLA 协议,再把 blueprint 放到 Gerrit 里头,就可以了。

在Gerrit 里会区分什么是 bugs ,有 story 。在敏捷开发里头,他有讲说我是一个 story ,还是一个 epic ,还是一个 bug ,还是个 issue ,所以应该来说一个 blueprint 至少是一个 story 。如果是一个比较大的 blueprint ,可能就是一个 epic 。所以你在 Gerrit 里面去开一个 blueprint 的时候,你可以选择。
这两个链接,可以告诉你去哪里下载CLA ,一个是公司的,一个是个人的。
然后写完之后,就把它发送到CLA 上面去。
当你要做开发的时候,要确定到底是一个feature ,还是一个 bug ?你就提交一个 blueprint 到上边来。
这里讲述什么是一个blueprint 。
Blueprint 要通过的话,先要在 TC 里面 review ,然后到 TSC 做 vote ,这是一个流程。所以 TC 的话是每周二开会,然后 TSC 是每周四开会。
TF 国际社区的 release 周期目前还没有定下来,还在讨论中。
CI 现在我相信还是弱,有人在讨论说,换到不同 CI 的一个 infrastructure ,目前还没有改到那边去。
这是告诉你怎么去处理code ,你写了 code 之后,还要一直负责,我们会有人 review ,可最后还是写 code 的人去负责。
当然还有基本的要求,就是说你要怎么做测试等等,这是很标准的,在开源社区都是这样子。
最后,我个人再分享一下,跟其他的开源软件比起来,TF 其实还算靠谱和好用。当你面对不同场景、不同客户的需求,只要稍微调试一下就可以。基本上说 TF 的架构都有非常严谨的测试, Juniper 在里面就测得很好,拿到社区里面来的时候,问题都比较少。所以很鼓励大家去用 TF 。
关于 Tungsten Fabric :
Tungsten Fabric 项目是一个开源项目协议,它基于标准协议开发,并且提供网络虚拟化和网络安全所必需的所有组件。项目的组件包括: SDN 控制器,虚拟路由器,分析引擎,北向 API 的发布,硬件集成功能,云编排软件和广泛的 REST API 。
关于 TF 中文社区 :
TF 中文社区由中国的一群关注和热爱 SDN 的志愿者自发发起,有技术老鸟,市场老炮,也有行业专家,资深用户。将作为连接社区与中国的桥梁,传播资讯,提交问题,组织活动,联合一切对多云互联网络有兴趣的力量,切实解决云网络建设过程中遇到的问题。
来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/69957171/viewspace-2670933/ ,如需转载,请注明出处,否则将追究法律责任。