garystafford/hello-world

Hello-World Spring Boot Docker镜像

镜像概述

一个简单的Spring Boot Hello-World应用程序，用于通用DevOps测试，包括CI/CD、部署、容器化、PaaS等场景。

核心功能与特性

• 提供多种HTTP端点，支持基础功能测试和错误场景模拟
• 集成Spring Actuator，提供丰富的监控端点
• 通过Spring AOP实现方法执行时间日志记录
• 支持容器化部署，可在Docker和PaaS平台运行

端点说明

除了Spring Actuator提供的标准端点（如mappings、health、info、metrics、env和configprops）外，该服务还包含以下HTTP端点：

HTTP GET端点

• / - 返回指示活动Spring配置文件的基本文本消息
• /sample - 返回包含多个示例数据字段的单个序列化JSON对象
• /sample/{count} - 返回多个序列化JSON对象（用于测试大型响应）
• /oops - 故意抛出内部服务器错误（500）并返回Java运行时异常堆栈跟踪（多行日志条目）

HTTP POST端点

• /logger - 将logEntry值记录到INFO级日志输出

使用示例：

• HTTPie: http http://localhost:8080/logger logEntry="This is a test"
• cURL: curl -d '{"logEntry":"This is a test"}' -H "Content-Type: application/json" -X POST http://localhost:8080/logger

AOP日志记录

所有HelloController方法调用都会生成INFO级别的日志条目，包含大致执行时间，示例如下：

text
2017-10-04 20:14:02.388  INFO 29463 --- [nio-8080-exec-5] com.example.helloworld.HelloController   : Execution Time: ResponseEntity com.example.helloworld.HelloController.getSample() executed in 23 ms

2017-10-04 20:13:59.034  INFO 29463 --- [nio-8080-exec-3] com.example.helloworld.HelloController   : Execution Time: ResponseEntity com.example.helloworld.HelloController.getSamples(int) executed in 38 ms

本地构建

可使用以下命令在本地构建服务：

bash
./gradlew clean build

Docker镜像信息

该服务的Docker镜像可在Docker Hub获取：garystafford/hello-world:latest

Docker运行方法

可使用以下Docker Compose配置运行镜像：

yaml
hello-world:
  image: garystafford/hello-world:latest
  ports:
  - "8080:8080/tcp" # 可选
  command: "java \
    -Dspring.profiles.active=dev \
    -Djava.security.egd=file:/dev/./urandom \
    -jar hello-world.jar"

在Pivotal Cloud Foundry上运行

PCF应用配置位于manifest.yml文件中，部署命令：

bash
./gradlew build && cf push