如何加入微服务 Apache ServiceComb 社区
2019獨角獸企業(yè)重金招聘Python工程師標準>>>
如何加入 微服務 Apache?ServiceComb 開源社區(qū)
本文轉載自 微服務 Apache SerivceComb (incubating) 的官方博客:
http://servicecomb.incubator.apache.org/cn/docs/join_the_community/
?
近期,熱衷開源和微服務的伙伴們非常關注如何加入到 微服務 Apache ServiceComb (incubating) 社區(qū)。ServiceComb作為開源的Apache 孵化項目,加入方式和常規(guī)的加入開源社區(qū)的方式大體一致,一般為三個階段:
1. 訂閱并關注社區(qū)動態(tài);
2. 開始在開源社區(qū)提交第一份代碼;
3. 深度加入社區(qū)討論并貢獻;
以下將詳細向大家講述如何一步步加入ServiceComb社區(qū)。
?
Step 1 訂閱并關注ServiceComb社區(qū)動態(tài)
訂閱和關注社區(qū)動態(tài)的途徑有:即時通訊工具(社區(qū)微信群、gitter)、社區(qū)公眾號、開發(fā)者郵件列表、門戶網(wǎng)站。
即時通訊工具
掃描下方二維碼或搜索ServiceComb小助手加入微信群,加入后可以在微信群中咨詢和求助,會有熱心的伙伴和committer 及時的響應回復。
也可使用Github賬號登錄gitter(地址 https://gitter.im/ServiceCombUsers/Lobby)進行在線討論,國內(nèi)的伙伴們更習慣于使用微信群進行在線交流,但為了更方便后來加入的人可以檢索并查閱前期的討論內(nèi)容存檔,所以ServiceComb社區(qū)推薦使用gitter。
郵件列表
郵件工作方式是開源社區(qū)極力推崇的方式,通過訂閱開發(fā)者郵件可以及時獲取到社區(qū)開發(fā)者的郵件討論內(nèi)容,可發(fā)起討論,也可通過回復感興趣的討論題目參與到討論中(郵件內(nèi)容均使用英文),郵件的存檔功能可以方便開發(fā)者查閱歷史問題的討論過程。
訂閱郵件方式:
-
發(fā)送任意內(nèi)容到
dev-subscribe@servicecomb.incubator.apache.org
-
收到來自dev-help的郵件后,再直接回復任意內(nèi)容來確認訂閱郵件列表即可。
-
訂閱成功后發(fā)送郵件到
dev@servicecomb.apache.org
參與社區(qū)討論與寫作,任何想法或建議以及技術/社區(qū)的討論咨詢都是受歡迎的。
-
郵件存檔內(nèi)容可通過
https://www.mail-archive.com/
搜索ServiceComb獲取。
社區(qū)公眾號
掃描下方二維碼關注公眾號或微信公眾號中搜索ServiceComb進行關注,公眾號會定期的發(fā)布和推送ServiceComb近期相應資訊(干貨資料、學習資源、線上活動、線下活動等)。
門戶網(wǎng)站
ServiceComb門戶網(wǎng)站是社區(qū)的官方入口,包括快速入門指南、用戶手冊、開發(fā)者手冊、常見問題和開發(fā)博文等。
網(wǎng)站地址: http://servicecomb.incubator.apache.org/cn/
?
Step 2 在 ServiceComb 社區(qū)提交第一份代碼(PR)
當關注社區(qū)并嘗試調試使用后,會發(fā)現(xiàn)一些簡單的bug(如文檔或代碼格式問題等),可以通過fix簡單的bug來熟悉ServiceComb社區(qū)的開發(fā)流程。
發(fā)現(xiàn)問題并提交Issue:
由于ServiceComb的任務管理是在Apache JIRA上進行的,所以需要先注冊并登錄到JIRA。關于JIRA詳細使用方法請參考JIRA使用幫助:http://servicecomb.incubator.apache.org/cn/developers/use-jira/
-
注冊并登陸到 https://issues.apache.org/jira/projects/SCB,點擊左側Kanban可以看到當前待處理、處理中和已經(jīng)完成的任務列表。
-
點擊新建創(chuàng)建新的issue或者task進行問題或任務跟蹤,選擇相應的模塊并添加描述信息。
任務提交到JIRA后,需要在本地進行代碼開發(fā),進行第一份代碼的提交。
提交第一份代碼(PR)
開發(fā)者在GitHub上fork倉庫后clone到本地進行代碼修改,修改完成并測試通過后可以創(chuàng)建PR提交代碼,提交PR后系統(tǒng)會自動運行CI進行代碼測試。測試通過后會有其他開發(fā)者或者maintainer進行review,沒有問題后會被approve并merge到主干分支。具體可參考門戶網(wǎng)站上開發(fā)者手冊中的代碼提交指南:
http://servicecomb.incubator.apache.org/cn/developers/submit-codes/
需要注意的是,創(chuàng)建PR的時候,PR的title要以JIRA中對應的問題編號開頭,如下圖中 [SCB-327],這樣系統(tǒng)就會自動關聯(lián)本次提交到相應JIRA任務下,方便進度跟蹤。
剛才提交的代碼經(jīng)過committer的review后,如果有問題committer會進行comment,繼續(xù)修改后push最新代碼即可。如果沒有問題會approve并merge。
至此,您已經(jīng)熟悉了ServiceComb社區(qū)的初級的開發(fā)流程,也是常規(guī)的社區(qū)開發(fā)方法(不同的社區(qū)承載體會有細微差異,如kubernetes的問題跟蹤是直接承載github的issue上)。下一步就可以深度參與到ServiceComb的討論并進行貢獻。
?
Step 3 深度參與到ServiceComb討論并貢獻
由于開源社區(qū)強調開放性,當開發(fā)者想在社區(qū)里做一些較大或中長期的特性時,則需在ServiceComb社區(qū)發(fā)起特性的討論。
如何發(fā)起特性討論
通過郵件發(fā)Proposal到社區(qū)進行討論,Proposal中有貼圖或附加文檔時可先創(chuàng)建好文件鏈接,將鏈接貼到郵件里即可,創(chuàng)建文件可以有一下兩種方式:
-
在JIRA上創(chuàng)建一個對應的特性任務,并將Proposal文檔添加到該任務的附件中,拷貝鏈接。
-
通過github向servicecomb.io網(wǎng)站以blog的形式提交文件,將該blog地址拷貝到郵件中。
文檔附件可參考:
http://servicecomb.incubator.apache.org/docs/service-registry-refactor-proposal/
Proposal郵件參考:
當在郵件中討論清楚特性設計后,就可以開始對應的代碼開發(fā),或對于部分小的任務(如代碼bug修復、文檔完善、網(wǎng)站優(yōu)化等),其本身不需要過多討論,則可參考上一步驟 Step 2 中的開發(fā)流程進行代碼貢獻。
遇到其他本文章未解決的問題(如用戶業(yè)務準備進行微服務技術選型或ServiceComb的概念性問題等)時,建議直接到微信群或者gitter里進行咨詢并尋求幫助。
社區(qū)鼓勵多勞多得和技術沉淀,堅持貢獻社區(qū)可以收獲來自社區(qū)的禮品激勵驚喜,堅持長期使用和參與社區(qū)項目的伙伴,將可能被選舉成 Apache committer 或者取得更高的榮譽,希望本文能對熱衷開源及ServiceComb社區(qū)的伙伴們有所幫助,也歡迎積極參加ServiceComb的線上及線下活動。
轉載于:https://my.oschina.net/u/3823482/blog/1798649
總結
以上是生活随笔為你收集整理的如何加入微服务 Apache ServiceComb 社区的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: AcWing 253. 普通平衡树
- 下一篇: 人工智能的智商等级