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

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

头图.png

头图来源：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 联系方式，以实现更好的持续协作和任务进度的更新。