ChunJun是易用、稳定、高效的批流一体的数据集成框架，主要应用于大数据开发平台的数据同步/数据集成模块，使大数据开发人员可简洁、快速的完成数据同步任务开发，供企业数据业务使用。
本文主要整理ChunJun的各类链接以及如何提交pr、Issue的方法，希望大家更好地参与开源，参与社区。
ChunJun百科
● 开源地址
GitHub：https://github.com/DTStack/chunjun
Gitee：https://gitee.com/dtstack_dev_0/chunjun
● 官方网站
https://dtstack.github.io/chunjun/
● 快速入门文档
https://dtstack.github.io/chunjun-web/docs/chunjunDocs/quickstart/
● 视频课程
Flink StreamSQL基础课程：
https://space.bilibili.com/677474984/channel/seriesdetail?sid=738125
2021年ChunJun课程：
https://space.bilibili.com/677474984/channel/seriesdetail?sid=738126
2022年ChunJun课程：
https://space.bilibili.com/677474984/channel/seriesdetail?sid=2240634
● 课件获取
关注公众号”ChunJun”，回复”课件”，即可获得您需要的对应课程的课件。
提交pr&Issue指南
如何提交一个优秀的pr
在GitHub上提交pr是参与ChunJun项目开源的一个重要途径，小伙伴们在使用中的一些功能上feature或者bugfix都可以向社区提交pr贡献代码，也可以根据已有的Issue提供自己的解决方案。
● 第一步：fork ChunJun到自己的GitHub仓库
点击fork后就可以在自己仓库中看到以你名字命名的ChunJun项目了：
● 第二步：clone ChunJun到本地IDE
● 第三步：将DTStack/ChunJun设置为本地仓库的远程分支upstream
● 第四步：提交代码
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:69050c4e-3241-4837-9b18-30cfe1a11f43
[En]
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:da4f19d2-4214-42b7-a169-c1d11fbe0f2c
本地修改代码后，提交commit
commit_message格式： [commit_type][module] message
commit_type:
feat：表示是一个新功能（feature)
hotfix：hotfix，修补bug
docs：改动、增加文档
opt：修改代码风格及opt imports这些，不改动原有执行的代码
test：增加测试
eg:[hotfix-12345][mysql] Fix mysql time type loses precision.
rebase远程分支
这一步很重要，因为我们仓库中的chunjun代码很有可能已经落后于社区，所以我们 push commit前需要rebase，保证我们的commit是基于社区最新的代码，很多小伙伴没有这一步导致提交的pr当中包含了其他人的commit
rebase后有可能出现代码冲突，一般是由于多人编辑同一个文件引起的，只需要根据提示打开冲突文件对冲突部分进行修改，将提示的冲突文件的冲突都解决后，执行
依此往复，直至屏幕出现类似rebase successful字样即可
rebase之后代码可能无法正常推送，需要git push -f 强制推送，强制推送是一个有风险的操作，操作前请仔细检查以避免出现无关代码被强制覆盖的问题
push到github仓库
● 第五步：提交pr
以我修复kafka写入过程中出现空指针问题为例，经过步骤四我已经把代码提交至我的仓库master分支
进入ChunJun仓库页面，点击Pull Request
选择head仓库和base仓库以及相应的分支
填写pr信息，pr信息应该尽量概括清楚问题的前因后果，如果存在对应Issue要附加Issue地址，保证问题是可追溯的
pr提交成功后需要一段时间代码review，您可以耐心等待一下我们review后合入，或者直接联系我们，提交pr的同学更有机会加入我们共创小组。
如何正确进行pr review
● pr review
• 如果是简单的代码或者文档改动，review 结束可以直接合并
• 如果是较大的内容改动，需要对应模块owner review
• 如果是功能分支，需要pr中提供设计思路，有必要的情况下，提供设计文档
• pr 回复时间不能超过一周
• 不符合规范的pr 在回复提示过后仍未改动，不予合并，一周之后关闭
● review pr 的要求
• 在pr里备注修复的issue
• pr commit 模版[hotfix-#issueID][#fix-module] #fix-commit.
• 修改内容尽量保持与issue内容一致，如果出现无关修改，在pr中备注出来
• review 代码时注意代码格式化
如何正确提出一个Issue
issue是一种非常好的可沉淀、可复现、可跟踪的交流方式，如果您发现了ChunJun有任何bug或奇怪的性能特征，请在GitHub或Gitee中提交新的Issue。
目前我们团队主要在GitHub上解决Issue和pr相关内容，Gitee上会相对慢一些，大家如果有Issue或者pr尽量在GitHub上提出，我们会及时处理。
● 在 GitHub 上提交的新 Issue 分为以下几种：
• 反馈错误 (Bug Reports)
• 提交新需求 (Feature Requests)
• 常规问题 (General Questions)
• 性能问题 (Performance Questions)
● 进行高效提问的方法
请您详细描述存在问题+问题截图，提交到ChunJun的Issue，以便我们迅速定位问题并作出回应。
Issue地址：
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:dd3cd35b-c4ad-44bd-ae42-d0f19f80db8f
[En]
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:f5d10569-5966-4854-9f6c-ba13cbdc31d2
《提问的智慧》：
https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md
《社区提问指南》：
https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md
● 提交Issue需要注意的地方
提交的Issue 最好带上详细的复现问题的步骤，这样可以减少其他同步复现问题的时间，更快更有效地解决问题。
如果能定位到源码的问题，建议提交一个pr来修复它，而不是等待其他同学。
社群交流技巧
除了GitHub和Gitee之外，我们还有一个拥有3000多人的开源框架技术交流群，在群内，大家可以尽情交流ChunJun相关技术和资讯，各位开发者们互帮互助，一串代码、一个建议，都是对ChunJun的莫大帮助。
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:49ad6b56-65ac-42b1-842f-d691d986dfcc
[En]
[TencentCloudSDKException] code:FailedOperation.ServiceIsolate message:service is stopped due to arrears, please recharge your account in Tencent Cloud requestId:5e94151e-09d4-4af6-b47c-d8ed5ba50a54
对于社群，我们希望它能够成为一个所有对开源、对ChunJun有兴趣的朋友的交流场所，而不是一个单纯的答疑群。在群里，不论是ChunJun团队成员还是你们，所有人的角色都是ChunJun的爱好者和共建者，而不是”客服””机器人”这样的角色。
当您对于ChunJun有疑问时，我们首先推荐您搜索相关文档，如果不能得到答案，强烈建议您通过提交Issue和我们进行沟通，最后才是在社群内提问。因为通过提交Issue的方式，问题可以得到沉淀，社群内消息刷新得很快，一个不小心，您的问题就石沉大海了。
我们团队成员平时还有自己的工作，没办法守在电脑前一个个回复社群中的问题，所以勇敢地提出 Issue吧，那一刻，你就已经变成了开源项目的参与者！
ChunJun团队也将根据大家的反馈，定期更新迭代官方文档，不断完善项目质量，和你们一起共建ChunJun。
Original: https://www.cnblogs.com/DTinsight/p/16601475.html
Author: 数栈DTinsight
Title: Ding！您有一份ChunJun实用指南，请查收
原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/561787/
转载文章受原作者版权保护。转载请注明原作者出处！