写点什么

参与 Apache 顶级开源项目的 N 种方式,Apache Dubbo Samples SIG 成立!

发布于: 2021 年 05 月 24 日


头图来源:https://opensource.guide/来源 | 阿里巴巴云原生公众号

只有贡献代码才算是参与开源项目社区贡献吗?

一说到参与开源项目贡献,一般大家的反应都是代码级别的贡献,总觉得我的代码被社区合并了,我才算一个贡献者,这是一个常见的错误认知。其实,在一个开源社区中有非常多的角色是 non-code contributor,一个开源社区中的很多关键职责被大家给忽略了。​组织活动也可以是贡献社区:


  • 你可以像远在巴西库亚巴的 @fzamperin 学习,为你喜欢的开源项目组织 workshop 或线下 meetup

  • 你还可以帮助社区成员找到合适的线下峰会来提交技术议题

  • ……


技术写作或者技术布道也是贡献社区:


  • 为你喜欢的开源项目编写或者改进文档

  • 建立一个如何使用这个开源项目的 samples

  • 将文档翻译成其他语言,帮助全球开发者认识、使用该项目

  • 在自己的公众号或者博客分享使用该项目的指南和心得

  • ……


设计和官网开发也是贡献社区:


  • 重构开源项目官网来帮助开发者更好的认识、使用该开源项目

  • 进行用户调研来更好地改善官网导航和目录

  • 构建一个 style guide 来帮助该项目拥有一个更统一、完善的视觉设计

  • 为该开源项目设计贴纸、T 恤等周边

  • ……

Apache Dubbo Samples SIG 成立!samples 贡献者招募中

Apache Dubbo 发展到今天,已经有 386 个贡献者,贡献者了包括代码、测试、用例、文档、使用建议等丰富内容。当前 Dubbo Core 有 2.7、3.0 两个非常活跃的演进分支,其中 2.7 版本已被众多知名企业大规模的投入生产环境,如携程、工商银行、瓜子二手车等,而 3.0 分支也已经在 3 月份发布了 preview 版本,按照计划在 6 月份第一个 3.0 可用版本也将正式发布。​内核的快速演进与迭代促进了 Dubbo 的快速发展,同时,也给整个社区与 Committer 核心项目组带来新的挑战,这体现在:​


  • 新 Feature 相关的用户示例与文档缺失。用户对新版本特性如何使用无从知晓,翻阅代码成为唯一的途径。

  • 稳定性无法得到充分保障。在迭代过程中,单元测试、集成测试没有得到有效的补充,这导致测试覆盖度的下降和回归成本的高涨,更糟糕的是如果发版环节有些问题仍未被发现,则它们将不可避免的被带到用户使用环节。


由于文档和用例的缺失,我们不得不处理大量的 Issue、也包括其他的线上答疑,来解答用户的疑问,其中有一些是用户不知道某个具体功能怎么用,有一些则是使用了不正确的配置方式导致不能正常运行;稳定性的下降则是对我们自己以及 Dubbo 用户两方面的双重打击,持续的出现问题会导致用户开始对 Dubbo 的版本发布失去信心,而对我们这些核心维护者而言,花费大量精力完成的版本却给用户带来了困扰,这会让整个开发组也变得沮丧。毫无疑问,对于 Dubbo 社区而言,解决以上问题成为了当前迫在眉睫的工作任务,这本身的重要性并不亚于大家所热衷的核心功能开发,但我们也认识到,投入到其中需要花费一定的精力,仅仅靠当前的几位维护者会非常吃力,尤其是考虑到他们还需要兼顾整个 Dubbo 社区的运作。​在这样的背景下,我们想到了召集来自社区的力量,今天在 Committer 核心成员的一致建议下,Apache Dubbo 决定成立 Samples SIG(注:SIG  是 special interest group 的缩写,即兴趣小组),以期能改善以上的示例缺失、稳定性等问题。毫无疑问,这个 SIG 的运转需要广大开发者的积极参与,当然,社区的核心开发者们也会积极的活跃在其中。

Dubbo 现状

当然,能稳定的支撑这么多企业与实例稳定的运行,Dubbo 的测试与稳定性机制也并非一无是处,以下是 Dubbo 具备的一些能力与运作机制。​


  • 单元测试。单元测试全部位于_https://github.com/apache/dubbo_主干仓库,目前能达到大概 40% - 50% 的覆盖度,但遗憾的是近期的很多新增修改,包括 2.7 与 3.0,在这方面做的都有所欠缺。

  • 集成测试。Dubbo 的集成测试项目位于_https://github.com/apache/dubbo-samples_,里面包含了我们当前建设的大部分 Dubbo Feature 用例,你可以把当做一个 Quick Start 的示例工程用,也可以作为功能参考手册(代码),我们在其上构建了自动化的集成测试机制,能实现对所有用例的全量验证。

  • 基于 Github Actions 的自动化测试流程。每一次代码提交、PR 都会触发这个 Workflow,它会对主干仓库进行编译,并依次运行单元测试、集成测试,同时还有一些代码合规范的检查。


我们要做的提升计划,就是在以上已有组件的基础之上继续完善。通过梳理,我们总结出以下部分内容需要重点完善:​


  • Dubbo 3.0 中新引入的一些核心机制、组件的单元测试覆盖

  • Dubbo 3.0 中新引入的一些核心组件的用户用例、集成测试

  • Dubbo 重点组件的,如 Zookeeper、Nacos 等

  • Dubbo 内核一些核心组件,如 Registry、Directory、URL、FilterBuilder、Context、AsyncRpcResult、ApplicationModel、ServiceRepository 等的单元测试覆盖


请关注下文的 SIG 联系方式,以实现更好的持续协作和任务进度的更新。

对参与者的帮助与要求

参与到 SIG 中来,不论你是学生、初学 Dubbo 的开发者、用户、或是混迹职场的技术达人,这里应该都能您带来一些帮助:​


  • 掌握 Dubbo 新特性的使用方式

  • 快速了解 Dubbo 的核心工作机制

  • 掌握 Dubbo 的演进动态的一手信息

  • 如果你是企业用户,也能共同实现推动 Dubbo 稳定性的提升,解决 Dubbo 的企业落地问题

  • 与业内的技术专家、同行深入交流,提升自己,实现信息共享

  • 积累活跃度,成为开源达人,与 Apache 结缘并有机会成为 Apache Dubbo Committer


另外,社区也会不定期的举办线上、线下活动,获得社区贡献者专属礼物。我们对参与者的唯一要求就是热情,希望参与者能持续的投入在 Dubbo 社区的建设中,并定期的参加我们 SIG 的交流活动,以实现与其他人的协作。


参考文档


发布于: 2021 年 05 月 24 日阅读数: 336
用户头像

阿里巴巴云原生 2019.05.21 加入

还未添加个人简介

评论

发布
暂无评论
参与 Apache 顶级开源项目的 N 种方式,Apache Dubbo Samples SIG 成立!