如何加入微服務 Apache ServiceComb 社區

如何加入 微服務 Apache ServiceComb 開源社區

本文轉載自 微服務 Apache SerivceComb (incubating) 的官方博客：

http://servicecomb.incubator.apache.org/cn/docs/join_the_community/

 

近期，熱衷開源和微服務的夥伴們很是關注如何加入到 微服務 Apache ServiceComb (incubating) 社區。ServiceComb做爲開源的Apache 孵化項目，加入方式和常規的加入開源社區的方式大致一致，通常爲三個階段：

1. 訂閱並關注社區動態；

2. 開始在開源社區提交第一份代碼；

3. 深度加入社區討論並貢獻；

如下將詳細向你們講述如何一步步加入ServiceComb社區。

 

Step 1 訂閱並關注ServiceComb社區動態

訂閱和關注社區動態的途徑有：即時通信工具（社區微信羣、gitter）、社區公衆號、開發者郵件列表、門戶網站。

即時通信工具

掃描下方二維碼或搜索ServiceComb小助手加入微信羣，加入後能夠在微信羣中諮詢和求助，會有熱心的夥伴和committer 及時的響應回覆。

也可以使用Github帳號登陸gitter（地址 https://gitter.im/ServiceCombUsers/Lobby）進行在線討論，國內的夥伴們更習慣於使用微信羣進行在線交流，但爲了更方便後來加入的人能夠檢索並查閱前期的討論內容存檔，因此ServiceComb社區推薦使用gitter。

郵件列表

郵件工做方式是開源社區極力推崇的方式，經過訂閱開發者郵件能夠及時獲取到社區開發者的郵件討論內容，可發起討論，也可經過回覆感興趣的討論題目參與到討論中（郵件內容均使用英文），郵件的存檔功能能夠方便開發者查閱歷史問題的討論過程。

訂閱郵件方式：

• 發送任意內容到

  dev-subscribe@servicecomb.incubator.apache.org

• 收到來自dev-help的郵件後，再直接回復任意內容來確認訂閱郵件列表便可。

• 訂閱成功後發送郵件到

  dev@servicecomb.apache.org

  參與社區討論與寫做，任何想法或建議以及技術/社區的討論諮詢都是受歡迎的。

• 郵件存檔內容可經過

  https://www.mail-archive.com/

  搜索ServiceComb獲取。

社區公衆號

掃描下方二維碼關注公衆號或微信公衆號中搜索ServiceComb進行關注，公衆號會按期的發佈和推送ServiceComb近期相應資訊（乾貨資料、學習資源、線上活動、線下活動等）。

門戶網站

ServiceComb門戶網站是社區的官方入口，包括快速入門指南、用戶手冊、開發者手冊、常見問題和開發博文等。

網站地址: http://servicecomb.incubator.apache.org/cn/

 

Step 2 在 ServiceComb 社區提交第一份代碼（PR）

當關注社區並嘗試調試使用後，會發現一些簡單的bug（如文檔或代碼格式問題等），能夠經過fix簡單的bug來熟悉ServiceComb社區的開發流程。

發現問題並提交Issue：

因爲ServiceComb的任務管理是在Apache JIRA上進行的，因此須要先註冊並登陸到JIRA。關於JIRA詳細使用方法請參考JIRA使用幫助：http://servicecomb.incubator.apache.org/cn/developers/use-jira/

• 註冊並登錄到 https://issues.apache.org/jira/projects/SCB，點擊左側Kanban能夠看到當前待處理、處理中和已經完成的任務列表。

• 點擊新建建立新的issue或者task進行問題或任務跟蹤，選擇相應的模塊並添加描述信息。

任務提交到JIRA後，須要在本地進行代碼開發，進行第一份代碼的提交。

提交第一份代碼（PR）

開發者在GitHub上fork倉庫後clone到本地進行代碼修改，修改完成並測試經過後能夠建立PR提交代碼，提交PR後系統會自動運行CI進行代碼測試。測試經過後會有其餘開發者或者maintainer進行review，沒有問題後會被approve並merge到主幹分支。具體可參考門戶網站上開發者手冊中的代碼提交指南：

http://servicecomb.incubator.apache.org/cn/developers/submit-codes/

須要注意的是，建立PR的時候，PR的title要以JIRA中對應的問題編號開頭，以下圖中 [SCB-327]，這樣系統就會自動關聯本次提交到相應JIRA任務下，方便進度跟蹤。

剛纔提交的代碼通過committer的review後，若是有問題committer會進行comment，繼續修改後push最新代碼便可。若是沒有問題會approve並merge。

至此，您已經熟悉了ServiceComb社區的初級的開發流程，也是常規的社區開發方法（不一樣的社區承載體會有細微差別，如kubernetes的問題跟蹤是直接承載github的issue上）。下一步就能夠深度參與到ServiceComb的討論並進行貢獻。

 

Step 3 深度參與到ServiceComb討論並貢獻

因爲開源社區強調開放性，當開發者想在社區裏作一些較大或中長期的特性時，則需在ServiceComb社區發起特性的討論。

如何發起特性討論

經過郵件發Proposal到社區進行討論，Proposal中有貼圖或附加文檔時可先建立好文件連接，將連接貼到郵件裏便可，建立文件能夠有一下兩種方式：

• 在JIRA上建立一個對應的特性任務，並將Proposal文檔添加到該任務的附件中，拷貝連接。

• 經過github向servicecomb.io網站以blog的形式提交文件，將該blog地址拷貝到郵件中。

  文檔附件可參考：

  http://servicecomb.incubator.apache.org/docs/service-registry-refactor-proposal/

  Proposal郵件參考：

當在郵件中討論清楚特性設計後，就能夠開始對應的代碼開發，或對於部分小的任務（如代碼bug修復、文檔完善、網站優化等），其自己不須要過多討論，則可參考上一步驟 Step 2 中的開發流程進行代碼貢獻。

遇到其餘本文章未解決的問題（如用戶業務準備進行微服務技術選型或ServiceComb的概念性問題等）時，建議直接到微信羣或者gitter裏進行諮詢並尋求幫助。

社區鼓勵多勞多得和技術沉澱，堅持貢獻社區能夠收穫來自社區的禮品激勵驚喜，堅持長期使用和參與社區項目的夥伴，將可能被選舉成 Apache committer 或者取得更高的榮譽，但願本文能對熱衷開源及ServiceComb社區的夥伴們有所幫助，也歡迎積極參加ServiceComb的線上及線下活動。