![頭圖.png](https://ucc.alicdn.com/pic/developer-ecology/f38cea34b6214cc19b4edc99b77e8e14.png)

頭圖來源：https://opensource.guide/
來源 | [阿里巴巴雲原生公眾號](https://mp.weixin.qq.com/s/k92V4O6vJnaun2J3qY9RRg)

## 只有貢獻程式碼才算是參與開源專案社群貢獻嗎？

一說到參與開源專案貢獻，一般大家的反應都是程式碼級別的貢獻，總覺得我的程式碼被社群合併了，我才算一個貢獻者，這是一個常見的錯誤認知。其實，在一個開源社群中有非常多的角色是 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 的交流活動，以實現與其他人的協作。

**參考文件**：

- [_https://opensource.guide/how-to-contribute/_](https://opensource.guide/how-to-contribute/)

參與 Apache 頂級開源專案的 N 種方式，Apache Dubbo Samples SIG 成立！

相關文章