stevenacoffman/prometheus-spring-actuator

Spring Boot Actuator + Prometheus示例应用镜像（Kubernetes支持）

本镜像为Spring Boot Actuator与Prometheus集成的示例应用，基于Alpine构建，支持Kubernetes部署，参考了多个开源项目（如reflectoring.io的监控指南、Prometheus Java客户端等）。注意：该镜像暂不兼容Spring Boot 2.x版本（如2.0.0.M6）。

核心功能

• 支持Spring Profiles配置
• 自定义JAVA_OPTS参数
• 内置健康检查机制
• 调试模式与JMX模式切换
• 轻量级Alpine基础镜像
• Kubernetes部署支持及Prometheus自动发现配置

可用环境变量

使用场景

1. 开发测试：快速搭建Spring Boot应用监控环境
2. 学习实践：了解Actuator与Prometheus的集成方式
3. Kubernetes环境：验证Prometheus自动发现功能的示例应用

配置与部署说明

1. 构建镜像

使用Maven构建：

bash
mvn package
# 或显式执行构建命令
mvn dockerfile:build

2. 部署方式

Docker CLI部署

bash
docker run -d -p 8080:8080 -e JAVA_OPTS="-Xms256m -Xmx512m" stevenacoffman/prometheus-spring-actuator

Docker Compose部署

使用仓库中的compose/docker-compose.yml文件：

bash
docker-compose -f compose/docker-compose.yml up

配合.env配置文件（示例）：

env
IMAGE_NAME=stevenacoffman/prometheus-spring-actuator
SERVER_PORT=8080
SPRING_PROFILES_ACTIVE=dev
DEBUG=false
JAVA_OPTS=
HOST_SERVER_PORT=8080

Kubernetes部署

bash
kubectl apply -f ./k8s

3. 特殊模式配置

调试模式

在.env中设置DEBUG=true后启动：

bash
docker-compose -f compose/docker-compose.yml up

默认调试端口为8000。

JMX模式

在.env中设置JMX=true后启动：

bash
docker-compose -f compose/docker-compose.yml up

默认JMX端口为9010。

4. Prometheus自动发现（Kubernetes）

在Deployment注解中添加以下配置：

yaml
metadata:
  annotations:
    prometheus.io/scrape: "true"
    prometheus.io/port: "8888"