opbeans-java

概述

opbeans-java是Opbeans Demo应用的Java实现，基于Spring Boot框架开发。它使用与Node版本相同的数据库模式，默认情况下采用预填充的内存H2数据库。

核心功能与特性

• 基于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

测试基于bats框架编写，测试文件位于tests目录下。

本地发布到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功能演示。