opbeans/opbeans-java

opbeans-java

概述

opbeans-java是Opbeans Demo应用的Java实现，基于Spring Boot框架开发。它使用与https://github.com/opbeat/opbeans%E7%9B%B8%E5%90%8C%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E6%A8%A1%E5%BC%8F%EF%BC%8C%E9%BB%98%E8%AE%A4%E6%83%85%E5%86%B5%E4%B8%8B%E9%87%87%E7%94%A8%E9%A2%84%E5%A1%AB%E5%85%85%E7%9A%84%E5%86%85%E5%AD%98H2%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

核心功能与特性

• 基于Spring Boot构建，易于部署和扩展
• 默认集成预填充的H2内存数据库，无需额外配置即可快速启动
• 支持自定义数据库（如PostgreSQL），可通过系统属性或配置文件覆盖默认设置
• 提供Docker Compose配置，支持本地完整环境（包含Server、Kibana和Elasticsearch）
• 内置可触发的演示bug，用于APM功能验证

使用场景

• Elastic APM功能测试与演示
• 本地开发环境中Opbeans应用的快速部署
• Elastic Cloud环境下的APM集成验证

使用方法

本地运行

如需在本地运行完整环境（包含Server、Kibana和Elasticsearch），可使用提供的Docker Compose文件：

bash
docker-compose up

使用Elastic Cloud运行

1. 如无Elastic Cloud账号，先启动试用
2. 设置环境变量：
   • ELASTIC_CLOUD_ID：Elastic Cloud ID
   • ELASTIC_CLOUD_CREDENTIALS：格式为login:password的认证信息
3. 运行以下命令启动：

bash
docker-compose -f docker-compose-elastic-cloud.yml up

本地测试

最简单的测试方式是执行：

bash
make test

测试基于https://github.com/sstephenson/bats%E6%A1%86%E6%9E%B6%E7%BC%96%E5%86%99%EF%BC%8C%E6%B5%8B%E8%AF%95%E6%96%87%E4%BB%B6%E4%BD%8D%E4%BA%8E%60tests%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E3%80%82

本地发布到DockerHub

使用以下命令发布Docker镜像：

bash
VERSION=1.2.3 make publish

注意：VERSION指将发布到镜像仓库的Docker镜像标签。

自定义数据库

可通过系统属性覆盖应用配置文件中的值来自定义数据库，例如：

bash
./mvnw spring-boot:run -Dspring.jpa.database=POSTGRESQL -Dspring.datasource.driverClassName=org.postgresql.Driver -Dspring.datasource.url=jdbc:postgresql://localhost/opbeans?user=postgres&password=verysecure

另一种方式是创建自定义配置文件（如application-customdb.properties），并通过profile启用：

bash
./mvnw spring-boot:run -Dspring.profiles.active=customdb

演示说明

应用内置一个可触发的bug，通过访问路径/is-it-coffee-time即可触发，用于APM功能演示。