Skip to main content

贡献者指南

非常欢迎参与项目贡献，我们致力于维护一个互相帮助的快乐社区。

贡献方式​

在 argusDBM 社区，贡献方式有很多:

  • 💻代码：可以帮助社区完成一些任务、编写新的feature或者是修复一些bug；

  • ⚠️测试：可以来参与测试代码的编写，包括了单元测试、集成测试、e2e测试；

  • 📖文档：可以编写或完善文档，来帮助用户更好地了解和使用 argusDBM；

  • 📝博客：可以撰写 argusDBM 的相关文章，来帮助社区更好地推广；

  • 🤔讨论：可以参与 argusDBM 新的feature的讨论，将您的想法跟 argusDBM 融合；

  • 💡布道：可以帮助宣传或推广 argusDBM 社区，在 meetup 或 summit 中演讲；

  • 💬建议：也可以对项目或者社区提出一些建议，促进社区的良性发展；

更多贡献方式参见 Contribution Types

即便是小到错别字的修正我们也都非常欢迎 :)

让 argusDBM 运行起来​

让 argusDBM 的代码在您的开发工具上运行起来，并且能够断点调试。
此为前后端分离项目，本地代码启动需将后端 manager 和前端 web-app 分别启动生效。

  • 后端启动
  1. 部署启动依赖服务MYSQL和TDengine数据库
  2. 需要maven3+, java8+和lombok环境
  3. 修改配置文件的依赖服务地址等信息-manager/src/main/resources/application.yml
  4. 启动springboot manager服务 manager/src/main/java/com/usthe/manager/Manager.java
  • 前端启动
  1. 需要nodejs npm angular-cli环境
  2. 安装yarn npm install -g yarn
  3. 在前端工程目录web-app下执行 yarn install
  4. 全局安装angular-cli npm install -g @angular/cli@12 --registry=https://registry.npm.taobao.org
  5. 待本地后端启动后，在web-app目录下启动本地前端 ng serve --open
  6. 浏览器访问 localhost:4200 即可开始，默认账号密码 admin/argusDBM

寻找任务​

寻找您感兴趣的Issue！在我们的GitHub仓库和邮件列表中，我们经常会发布一些带有 good first issue 或者 status: volunteer wanted 标签的issue，这些issue都欢迎贡献者的帮助。 其中good first issue往往门槛较低、适合新手。

当然，如果您有好的想法，也可以直接在GitHub Discussion 中提出或者联系社区。

提交 Pull Request​

  1. 首先您需要 Fork 目标仓库 argusDBM repository.
  2. 然后 用git命令 将代码下载到本地:
git clone git@github.com:${YOUR_USERNAME}/argusDBM.git #Recommended
  1. 下载完成后，请参考目标仓库的入门指南或者 README 文件对项目进行初始化。
  2. 接着，您可以参考如下命令进行代码的提交, 切换新的分支, 进行开发:
git checkout -b a-feature-branch #Recommended
  1. 提交 commit , commit 描述信息需要符合约定格式: [module name or type name]feature or bugfix or doc: custom message.
git add <modified file/path> 
git commit -m '[docs]feature: necessary instructions' #Recommended
  1. 推送到远程仓库
git push origin a-feature-branch
  1. 然后您就可以在 GitHub 上发起新的 PR (Pull Request)。

请注意 PR 的标题需要符合我们的规范，并且在 PR 中写上必要的说明，来方便 Committer 和其他贡献者进行代码审查。

等待PR代码被合并​

在提交了 PR 后，Committer 或者社区的小伙伴们会对您提交的代码进行审查（Code Review），会提出一些修改建议，或者是进行一些讨论，请及时关注您的PR。

若后续需要改动，不需要发起一个新的 PR，在原有的分支上提交 commit 并推送到远程仓库后，PR会自动更新。

另外，我们的项目有比较规范和严格的 CI 检查流程，在提交 PR 之后会触发 CI，请注意是否通过 CI 检查。

最后，Committer 可以将 PR 合并入DEV主分支。

代码被合并后​

在代码被合并后，您就可以在本地和远程仓库删除这个开发分支了：

git branch -d a-dev-branch
git push origin --delete a-dev-branch

在主分支上，您可以执行以下操作来同步上游仓库：

git remote add upstream https://github.com/zmops/argusDBM.git #Bind the remote warehouse, if it has been executed, it does not need to be executed again
git checkout master 
git pull upstream master

如何成为Committer？​

通过上述步骤，您就是 argusDBM 的贡献者了。重复前面的步骤，在社区中保持活跃，坚持下去，您就能成为 Committer！

加入讨论交流​

Github Discussion

加微信号 tan-cloud 拉您进微信交流群