marcelmaatkamp/spring-boot-actuators

Spring Boot Actuator示例镜像

源码地址：https://github.com/marcelmaatkamp/spring-boot-actuators

本镜像为Spring Boot Actuator的使用示例，旨在展示如何利用Actuator提供的监控指标、健康检查等功能，并演示在Kubernetes环境中通过这些信号实现应用的自动恢复。

相关参考资料：

• https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/#define-a-liveness-command
• https://cloud.google.com/blog/products/gcp/kubernetes-best-practices-setting-up-health-checks-with-readiness-and-liveness-probes
• [***]

前提条件

• Java
• Gradle
• Docker

macOS环境安装前提

bash
$ brew install sdkman jq
$ sdk install java 
$ sdk install gradle

安装步骤

bash
$ git clone https://github.com/marcelmaatkamp/spring-boot-actuators.git &&\
  cd spring-boot-actuators &&\
  gradle bootRun

核心功能

1. 提供应用健康检查接口（/actuator/health）
2. 展示应用运行指标（/actuator/metrics）
3. 支持线程dump、堆dump等调试功能
4. 暴露应用配置、环境变量等信息
5. 为Kubernetes提供存活（liveness）和就绪（readiness）探针信号

使用场景

1. 开发人员学习Spring Boot Actuator的基础使用
2. 测试环境中验证应用监控配置
3. Kubernetes集群中配置应用自动恢复策略的参考示例

运行方式

独立运行

bash
$ gradle bootRun
# 查看Actuator接口列表
$ curl -s localhost:8081/actuator | jq --indent 1
# 查看健康状态
$ curl -s localhost:8081/actuator/health | jq --indent 1

Docker容器运行

bash
# 构建镜像
$ gradle jibDockerBuild
# 启动容器
$ docker run -p 8080:8080 marcelmaatkamp/spring-boot-actuators
# 访问Actuator接口
$ curl -s http://localhost:8080/actuator | jq --indent 1

Kubernetes集群运行

（需先安装helm和kubectl工具）

bash
$ brew install kubernetes-helm
$ helm create helm 
$ helm template helm \
  --name spring-boot-actuators \
  --set image.repository=marcelmaatkamp/spring-boot-actuators \
  --set image.tag=latest \
  --set image.pullPolicy=Always | kubectl apply -f -
# 查看Pod状态
$ kubectl get pods