如何加入微服务 Apache ServiceComb 社区
2019獨角獸企業重金招聘Python工程師標準>>>
如何加入 微服務 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的線上及線下活動。
轉載于:https://my.oschina.net/u/3823482/blog/1798649
總結
以上是生活随笔為你收集整理的如何加入微服务 Apache ServiceComb 社区的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: AcWing 253. 普通平衡树
- 下一篇: 人工智能的智商等级