4.2 KiB
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
构建与部署
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
访问:
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 按容器内存上限算堆。
运维命令
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'
调试时直接在编译镜像里运行
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
停止
sh shutdown.sh