跳到主要内容
版本：v1.5.x

贡献指南

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

贡献方式​

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

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

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

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

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

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

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

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

更多贡献方式参见 Contribution Types

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

让 HertzBeat 运行起来​

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

后端启动​

  1. 需要 maven3+, java17 和 lombok 环境

  2. (可选)修改配置文件配置信息-manager/src/main/resources/application.yml

  3. 在项目根目录运行编译: mvn clean install -DskipTests

  4. 启动springboot manager服务 manager/src/main/java/org/apache/hertzbeat/hertzbeat-manager/Manager.java

前端启动​

  1. 需要 nodejs yarn 环境, Make sure Node.js >= 18

  2. 进入 web-app 目录: cd web-app

  3. 安装yarn: npm install -g yarn

  4. 在前端工程目录 web-app 下执行: yarn install or yarn install --registry=https://registry.npmmirror.com in web-app

  5. 全局安装 angular-cli: yarn global add @angular/cli@15 or yarn global add @angular/cli@15 --registry=https://registry.npmmirror.com

  6. 待本地后端启动后，在web-app目录下启动本地前端 ng serve --open

  7. 浏览器访问 localhost:4200 即可开始，默认账号密码 admin/hertzbeat**

寻找任务​

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

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

提交 Pull Request​

  1. 首先您需要 Fork 目标仓库 hertzbeat repository.

  2. 然后 用git命令 将代码下载到本地:

    git clone git@github.com:${YOUR_USERNAME}/hertzbeat.git #Recommended

  3. 下载完成后，请参考目标仓库的入门指南或者 README 文件对项目进行初始化。

  4. 接着，您可以参考如下命令进行代码的提交, 切换新的分支, 进行开发:

    git checkout -b a-feature-branch #Recommended

  5. 提交 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

  6. 推送到远程仓库

    git push origin a-feature-branch

  7. 然后您就可以在 GitHub 上发起新的 PR (Pull Request)。

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

等待PR代码被合并​

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

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

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

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

代码被合并后​

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

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

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

git remote add upstream https://github.com/apache/hertzbeat.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？​

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

加入讨论交流​

Github Discussion

加微信号 ahertzbeat 拉您进微信交流群

模块​

  • manager 提供监控管理,系统管理基础服务

提供对监控的管理，监控应用配置的管理，系统用户租户后台管理等。

  • collector 提供监控数据采集服务 使用通用协议远程采集获取对端指标数据。
  • warehouse 提供监控数据仓储服务 采集指标结果数据管理，数据落盘，查询，计算统计。
  • alerter 提供告警服务 告警计算触发，任务状态联动，告警配置，告警通知。
  • web-app 提供可视化控制台页面 监控告警系统可视化控制台前端

hertzBeat