Files
kenaito-lab/demo/app/springboot-jar8/README.md
T

89 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# springboot-jar8 示例
演示如何用 `compile-maven3-jdk8` + `runtime-jdk8` 两阶段构建并运行一个 **Spring Boot 2.7** Web 应用,产物是**可执行 jar**(内嵌 Tomcat)。这是 Java 8 版本的 `springboot-jar17` 对照示例。
> Spring Boot 3.x 要求 JDK 17+,Java 8 只能用 **2.7.x**(本例 2.7.18,最后一条支持 Java 8 的 Boot 线);Spring Framework 也随之降到 5.3.x。
| 阶段 | 镜像 | 说明 |
| --- | --- | --- |
| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8` | JDK 8(Dragonwell)+ Maven 3.9.9 + 阿里云 Maven 源(见 `image/compile-maven3-jdk8`) |
| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk8` | 仅 JDK 8(见 `image/runtime-jdk8`) |
运行阶段只拷贝 `spring-boot-maven-plugin` 重打包后的 jar,镜像里不含 Maven、源码和 `~/.m2`。
### 示例内容
```
springboot-jar8/
├── pom.xml # Spring Boot 2.7.18,java.version=1.8,parent 统一管版本
├── src/main/java/cn/odboy/demo/
│ ├── DemoApplication.java # @SpringBootApplication 入口
│ ├── DemoController.java # @RestController:/ 、/api/info、/api/hello/{name}
│ └── PageController.java # @Controller:/page 渲染 Thymeleaf 模板
├── src/main/resources/
│ ├── application.yml # 端口 8094、优雅停机、actuator 只开 health
│ └── templates/index.html # /page 页面
├── Dockerfile # 两阶段:compile-maven3-jdk8 -> runtime-jdk8
├── build.sh # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml # 部署编排(端口 8094,固定 IP 172.30.3.20)
├── startup.sh # docker-compose up -d
└── shutdown.sh # docker-compose down
```
### 构建与部署
```shell
sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-springboot-jar8 .
PUSH=1 sh build.sh # 构建并推送
sh startup.sh # docker-compose -f docker-compose.yml -p springboot-jar8-demo up -d
```
访问:
```shell
curl http://127.0.0.1:8094/ # {"message":"springboot-jar8 is running","java":"1.8.0_502",...}
curl http://127.0.0.1:8094/api/info # 同上,等价入口
curl http://127.0.0.1:8094/api/hello/demo # {"message":"Hello, demo!","time":"..."}
curl http://127.0.0.1:8094/actuator/health # {"status":"UP"}
```
浏览器打开 http://127.0.0.1:8094/page 可看到渲染后的运行信息页面。
### 关键点
**Java 8 的版本选择**:Spring Boot 2.7.18 + Spring Framework 5.3.39(由 Boot parent 管理),是支持 Java 8 的最后一条稳定线。`pom.xml` 不需要显式声明各 Spring 依赖版本,parent 已统一管理。
**依赖层缓存**:先只 `COPY pom.xml` 执行 `mvn dependency:go-offline`,再 `COPY src` 编译。只改源码时不会重新下载依赖;镜像源已在 `compile-maven3-jdk8` 的 `settings.xml` 里指向阿里云。
**两阶段构建**:Maven 仓库、编译中间产物都留在 build 阶段,最终镜像只多一个 jar。这也是 `runtime-jdk*` 与 `compile-maven3-*` 分开的原因。
**监听地址**:容器内 8094(`server.port=${APP_PORT:8094}`),避开 springboot-jar17(8084)、spring-war17(8085)及其它 demo(8080-8093)。
**时区**:启动参数带 `-Duser.timezone=Asia/Shanghai`,compose 再声明 `TZ`;接口里额外按 UTC+8 输出时间,双保险。
**优雅停机**:`server.shutdown=graceful`(Boot 2.3+ 支持),`ENTRYPOINT` 用 exec 形式,`docker stop` 的 SIGTERM 直接到 JVM。
**内存**:`-XX:MaxRAMPercentage=75.0` 让 JVM 按容器内存上限算堆。
### 运维命令
```shell
docker logs -f springboot-jar8-demo # 应用日志
docker exec springboot-jar8-demo java -version # 确认 JDK 版本(应显示 1.8.0_502 / Dragonwell)
docker exec springboot-jar8-demo sh -c 'ls -lh /home/admin'
```
### 调试时直接在编译镜像里运行
```shell
docker run --rm -it -p 8094:8094 -v "$PWD":/src -w /src \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8 \
mvn spring-boot:run
```
### 停止
```shell
sh shutdown.sh
```