feat: 新增 JDK 8 系列镜像与示例(runtime-jdk8 / jre8 / tomcat9 / compile-maven3-jdk8,springboot-jar8 / spring-war8)

This commit is contained in:
2026-11-16 21:30:00 +08:00
parent 5dc02feeed
commit 1d7fe81c74
49 changed files with 1183 additions and 4 deletions
+11 -4
View File
@@ -5,7 +5,7 @@
``` ```
image/ 自建镜像:每个目录 = Dockerfile + build.sh,目录名即镜像 tag image/ 自建镜像:每个目录 = Dockerfile + build.sh,目录名即镜像 tag
deploy/ 部署编排:三方镜像 + 自研的 docker-compose / 配置,每个目录 = docker-compose.yml + startup.sh / shutdown.sh + README.md(+demo.png) deploy/ 部署编排:三方镜像 + 自研的 docker-compose / 配置,每个目录 = docker-compose.yml + startup.sh / shutdown.sh + README.md(+demo.png)
demo/app/ 构建示例:基于 image/ 下的镜像做构建与运行演示(dotnet6/8/9、python310-flask、springboot-jar17、spring-war17、 demo/app/ 构建示例:基于 image/ 下的镜像做构建与运行演示(dotnet6/8/9、python310-flask、springboot-jar8/war8、springboot-jar17/war17、
go、rust、node-backend,以及 node-frontend-vue2/vue3/vite5 与 react-function/react-class 前端,均为两阶段构建) go、rust、node-backend,以及 node-frontend-vue2/vue3/vite5 与 react-function/react-class 前端,均为两阶段构建)
demo/plateform/ 平台类示例(tengine3 反向代理) demo/plateform/ 平台类示例(tengine3 反向代理)
``` ```
@@ -27,12 +27,15 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
| 目录 | 镜像 tag | 基础镜像 / 版本 | 说明 | | 目录 | 镜像 tag | 基础镜像 / 版本 | 说明 |
| ------------------------------ | -------------------------------- | --------------------------------- | ------------------------------------------------------------------------ | | ------------------------------ | -------------------------------- | --------------------------------- | ------------------------------------------------------------------------ |
| `image/system-alinux3` | `kenaito:system-alinux3` | 阿里云 alinux3 3.13.3 | 系统基础镜像,其余镜像均基于它 | | `image/system-alinux3` | `kenaito:system-alinux3` | 阿里云 alinux3 3.13.3 | 系统基础镜像,其余镜像均基于它 |
| `image/runtime-jdk8` | `kenaito:runtime-jdk8` | 上者 / Dragonwell 8.30.29(1.8.0_502) | 运行环境,完整 JDK;用阿里 Dragonwell Extended 包(jdk.java.net 无 JDK 8 官方包) |
| `image/runtime-jre8` | `kenaito:runtime-jre8` | 上者 / Dragonwell 8.30.29(1.8.0_502) | 运行环境,仅 JRE;用阿里 Dragonwell Standard 包 |
| `image/runtime-jdk11` | `kenaito:runtime-jdk11` | 上者 / JDK 11 | 运行环境,仅 JDK | | `image/runtime-jdk11` | `kenaito:runtime-jdk11` | 上者 / JDK 11 | 运行环境,仅 JDK |
| `image/runtime-jdk17` | `kenaito:runtime-jdk17` | 上者 / JDK 17 | 运行环境,仅 JDK | | `image/runtime-jdk17` | `kenaito:runtime-jdk17` | 上者 / JDK 17 | 运行环境,仅 JDK |
| `image/runtime-jdk21` | `kenaito:runtime-jdk21` | 上者 / JDK 21.0.2 | 运行环境,仅 JDK | | `image/runtime-jdk21` | `kenaito:runtime-jdk21` | 上者 / JDK 21.0.2 | 运行环境,仅 JDK |
| `image/runtime-jdk25` | `kenaito:runtime-jdk25` | 上者 / JDK 25.0.2 | 运行环境,仅 JDK;编 Java 25 目标时作为 `compile-maven3-jdk25` 的基础镜像 | | `image/runtime-jdk25` | `kenaito:runtime-jdk25` | 上者 / JDK 25.0.2 | 运行环境,仅 JDK;编 Java 25 目标时作为 `compile-maven3-jdk25` 的基础镜像 |
| `image/runtime-python310` | `kenaito:runtime-python310` | 上者 / Python 3.10.0 | 运行环境,Python + pip 源(`pip.conf`) | | `image/runtime-python310` | `kenaito:runtime-python310` | 上者 / Python 3.10.0 | 运行环境,Python + pip 源(`pip.conf`) |
| `image/runtime-python315` | `kenaito:runtime-python315` | 上者 / Python 3.15.2 | 运行环境,Python + pip 源(`pip.conf`);node / ansible 镜像均基于它 | | `image/runtime-python315` | `kenaito:runtime-python315` | 上者 / Python 3.15.2 | 运行环境,Python + pip 源(`pip.conf`);node / ansible 镜像均基于它 |
| `image/runtime-tomcat9` | `kenaito:runtime-tomcat9` | `runtime-jdk8` / Tomcat 9.0.124 | 运行环境,JDK 8 + Tomcat(war 包部署用),javax.servlet / Servlet 4.0,兼容 Spring 5 |
| `image/runtime-tomcat10` | `kenaito:runtime-tomcat10` | `runtime-jdk17` / Tomcat 10.1.34 | 运行环境,JDK 17 + Tomcat(war 包部署用),兼容 Spring 6 | | `image/runtime-tomcat10` | `kenaito:runtime-tomcat10` | `runtime-jdk17` / Tomcat 10.1.34 | 运行环境,JDK 17 + Tomcat(war 包部署用),兼容 Spring 6 |
| `image/runtime-dotnet6` | `kenaito:runtime-dotnet6` | 上者 / ASP.NET Core 运行时 6.0.35 | 运行环境,仅运行时 | | `image/runtime-dotnet6` | `kenaito:runtime-dotnet6` | 上者 / ASP.NET Core 运行时 6.0.35 | 运行环境,仅运行时 |
| `image/runtime-dotnet8` | `kenaito:runtime-dotnet8` | 上者 / ASP.NET Core 运行时 8.0.x | 运行环境,仅运行时 | | `image/runtime-dotnet8` | `kenaito:runtime-dotnet8` | 上者 / ASP.NET Core 运行时 8.0.x | 运行环境,仅运行时 |
@@ -40,6 +43,7 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
| `image/compile-dotnet6` | `kenaito:compile-dotnet6` | 上者 / .NET SDK 6.0.427 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet6` | | `image/compile-dotnet6` | `kenaito:compile-dotnet6` | 上者 / .NET SDK 6.0.427 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet6` |
| `image/compile-dotnet8` | `kenaito:compile-dotnet8` | 上者 / .NET SDK 8.0.403 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet8` | | `image/compile-dotnet8` | `kenaito:compile-dotnet8` | 上者 / .NET SDK 8.0.403 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet8` |
| `image/compile-dotnet9` | `kenaito:compile-dotnet9` | 上者 / .NET SDK 9.0.100-rc.2 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet9` | | `image/compile-dotnet9` | `kenaito:compile-dotnet9` | 上者 / .NET SDK 9.0.100-rc.2 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/app/dotnet9` |
| `image/compile-maven3-jdk8` | `kenaito:compile-maven3-jdk8` | `runtime-jdk8` / Maven 3.9.9 | 编译环境(JDK 8 + Maven + git/gcc/make),`settings.xml` 走阿里云源;编 Java 8 目标时用 |
| `image/compile-maven3-jdk17` | `kenaito:compile-maven3-jdk17` | `runtime-jdk17` / Maven 3.9.9 | 编译环境(JDK 17 + Maven + git/gcc/make),`settings.xml` 走阿里云源 | | `image/compile-maven3-jdk17` | `kenaito:compile-maven3-jdk17` | `runtime-jdk17` / Maven 3.9.9 | 编译环境(JDK 17 + Maven + git/gcc/make),`settings.xml` 走阿里云源 |
| `image/compile-maven3-jdk21` | `kenaito:compile-maven3-jdk21` | `runtime-jdk21` / Maven 3.9.9 | 同上,JDK 换 21;编 Java 21 目标时用 | | `image/compile-maven3-jdk21` | `kenaito:compile-maven3-jdk21` | `runtime-jdk21` / Maven 3.9.9 | 同上,JDK 换 21;编 Java 21 目标时用 |
| `image/compile-maven3-jdk25` | `kenaito:compile-maven3-jdk25` | `runtime-jdk25` / Maven 3.9.9 | 同上,JDK 换 25;编 Java 25 目标时用 | | `image/compile-maven3-jdk25` | `kenaito:compile-maven3-jdk25` | `runtime-jdk25` / Maven 3.9.9 | 同上,JDK 换 25;编 Java 25 目标时用 |
@@ -104,6 +108,8 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
| [`demo/app/dotnet8`](demo/app/dotnet8/README.md) | `compile-dotnet8` / `runtime-dotnet8` | 8081 | .NET 8 两阶段构建示例 | | [`demo/app/dotnet8`](demo/app/dotnet8/README.md) | `compile-dotnet8` / `runtime-dotnet8` | 8081 | .NET 8 两阶段构建示例 |
| [`demo/app/dotnet9`](demo/app/dotnet9/README.md) | `compile-dotnet9` / `runtime-dotnet9` | 8082 | .NET 9 两阶段构建示例 | | [`demo/app/dotnet9`](demo/app/dotnet9/README.md) | `compile-dotnet9` / `runtime-dotnet9` | 8082 | .NET 9 两阶段构建示例 |
| [`demo/app/python310-flask`](demo/app/python310-flask/README.md) | `runtime-python310` | 8083 | Python 3.10 + Flask 3.0 单阶段构建示例 | | [`demo/app/python310-flask`](demo/app/python310-flask/README.md) | `runtime-python310` | 8083 | Python 3.10 + Flask 3.0 单阶段构建示例 |
| [`demo/app/springboot-jar8`](demo/app/springboot-jar8/README.md) | `compile-maven3-jdk8` / `runtime-jdk8` | 8094 | Spring Boot 2.7 可执行 jar 两阶段构建示例(Java 8)|
| [`demo/app/spring-war8`](demo/app/spring-war8/README.md) | `compile-maven3-jdk8` / `runtime-tomcat9` | 8095 | Spring MVC 5 war 包 + 外置 Tomcat 9 两阶段构建示例(Java 8)|
| [`demo/app/springboot-jar17`](demo/app/springboot-jar17/README.md) | `compile-maven3-jdk17` / `runtime-jdk17` | 8084 | Spring Boot 3.4 可执行 jar 两阶段构建示例 | | [`demo/app/springboot-jar17`](demo/app/springboot-jar17/README.md) | `compile-maven3-jdk17` / `runtime-jdk17` | 8084 | Spring Boot 3.4 可执行 jar 两阶段构建示例 |
| [`demo/app/spring-war17`](demo/app/spring-war17/README.md) | `compile-maven3-jdk17` / `runtime-tomcat10` | 8085 | Spring MVC 6 war 包 + 外置 Tomcat 10.1 两阶段构建示例 | | [`demo/app/spring-war17`](demo/app/spring-war17/README.md) | `compile-maven3-jdk17` / `runtime-tomcat10` | 8085 | Spring MVC 6 war 包 + 外置 Tomcat 10.1 两阶段构建示例 |
| [`demo/app/go`](demo/app/go/README.md) | `compile-go123` / `runtime-go123` | 8086 | Go 1.23 标准库 Web 两阶段构建示例 | | [`demo/app/go`](demo/app/go/README.md) | `compile-go123` / `runtime-go123` | 8086 | Go 1.23 标准库 Web 两阶段构建示例 |
@@ -124,9 +130,10 @@ demo/plateform/ 平台类示例(tengine3 反向代理)
- 编译:`runtime-dotnet*` 之上的 `compile-dotnet*` - 编译:`runtime-dotnet*` 之上的 `compile-dotnet*`
- 运行:`runtime-dotnet*` - 运行:`runtime-dotnet*`
- java 适用于 java 应用 - java 适用于 java 应用
- 编译:`compile-maven3-jdk17` / `-jdk21` / `-jdk25`(JDK + Maven,按目标字节码版本选) - 编译:`compile-maven3-jdk8` / `-jdk17` / `-jdk21` / `-jdk25`(JDK + Maven,按目标字节码版本选)
- 运行:`runtime-jdk*`(仅 JDK,直接 `java -jar` 或作为外置 Tomcat 的基础镜像) - 运行:`runtime-jdk*`(仅 JDK,直接 `java -jar` 或作为外置 Tomcat 的基础镜像);仅需运行时可用更精简的 `runtime-jre8`
- war 包运行:`runtime-tomcat10`(JDK 17 + Tomcat 10.1,兼容 Spring 6 / Servlet 6) - JDK 8 说明:`jdk.java.net/archive` 官方归档最早只到 JDK 9,JDK 8 无官方 GA 二进制,故用阿里 Dragonwell 8.30.29(Extended 作 JDK、Standard 作 JRE)
- war 包运行:`runtime-tomcat9`(JDK 8 + Tomcat 9.0,兼容 Spring 5 / javax.servlet / Servlet 4.0)、`runtime-tomcat10`(JDK 17 + Tomcat 10.1,兼容 Spring 6 / Servlet 6)
- python 适用于 python 应用 - python 适用于 python 应用
- 编译与运行:`runtime-python310`(已配置 pip 镜像源);另有 `runtime-python315` 作为 node / ansible 镜像的基础,不单独用于示例 - 编译与运行:`runtime-python310`(已配置 pip 镜像源);另有 `runtime-python315` 作为 node / ansible 镜像的基础,不单独用于示例
- go 适用于 go 应用 - go 适用于 go 应用
+3
View File
@@ -0,0 +1,3 @@
target/
.git/
.DS_Store
+3
View File
@@ -0,0 +1,3 @@
target/
.idea/
*.iml
+18
View File
@@ -0,0 +1,18 @@
# 编译阶段:compile-maven3-jdk8(JDK 8 + Maven 3.9.9 + 阿里云 Maven 源)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8 AS build
WORKDIR /src
# 先只拷贝 POM 预热依赖层:源码改动不会让依赖缓存失效
COPY pom.xml ./
RUN mvn -B -q dependency:go-offline
COPY src ./src
RUN mvn -B -q clean package -DskipTests
# 运行阶段:自建 runtime-tomcat9(runtime-jdk8 + Tomcat 9.0.124,Servlet 4.0 / javax.servlet,对应 Spring 5)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-tomcat9 AS runtime
LABEL MAINTAINER="tianjun@odboy.cn"
WORKDIR /home/admin
# 带版本号的 war 改名后部署,上下文路径 = /spring-war8
# 基础镜像已清空 webapps/*,时区、curl、EXPOSE 8080、ENTRYPOINT catalina.sh run 均由基础镜像提供
COPY --from=build /src/target/spring-war8.war ${CATALINA_HOME}/webapps/spring-war8.war
+90
View File
@@ -0,0 +1,90 @@
# spring-war8 示例
演示如何用 `compile-maven3-jdk8` 打出 **war 包**,再部署到外置 Tomcat 9 运行。与
[`demo/app/springboot-jar8`](../springboot-jar8/README.md) 对照:应用代码几乎一样,区别只在打包方式与运行容器。这是 Java 8 版本的 `spring-war17` 对照示例。
> Java 8 era 用 **Spring 5.3 + javax.servlet + Tomcat 9**(Servlet 4.0)。Spring 6 / Jakarta EE 要求 JDK 17+,只适用于 `spring-war17`;Tomcat 9(`javax.servlet`)跑不了 war17 的包,反之 Tomcat 10(`jakarta.servlet`)也跑不了本示例。
| 阶段 | 镜像 | 说明 |
| --- | --- | --- |
| 编译 | `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-tomcat9` | 自建镜像:JDK 8 + Tomcat 9.0.124(Servlet 4.0 / javax.servlet,对应 Spring 5),见 `image/runtime-tomcat9` |
### 示例内容
```
spring-war8/
├── pom.xml # packaging=war,Spring 5.3.39 + thymeleaf-spring5 3.0.15 + javax.servlet 4.0.1,不依赖 Boot
├── src/main/java/cn/odboy/demo/
│ ├── WebAppInitializer.java # 替代 web.xml,注册 DispatcherServlet(映射 /api/*)
│ ├── WebConfig.java # @EnableWebMvc + Thymeleaf 视图解析 + Jackson
│ ├── DemoController.java # @RestController:/ 、/info、/hello/{name}(在 /api 前缀下)
│ └── PageController.java # @Controller:/api/page 渲染模板
├── src/main/resources/templates/index.html
├── src/main/webapp/WEB-INF/web.xml # Servlet 4.0 描述符,仅声明 metadata-complete=false 与会话超时,无 servlet 映射
├── Dockerfile # 两阶段:compile-maven3-jdk8 -> runtime-tomcat9
├── build.sh # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml # 部署编排(8095 -> 容器 8080,固定 IP 172.30.4.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-spring-war8 .
PUSH=1 sh build.sh # 构建并推送
sh startup.sh # docker-compose -f docker-compose.yml -p spring-war8-demo up -d
```
war 部署后上下文路径为 **`/spring-war8`**,接口都在该前缀下:
```shell
curl http://127.0.0.1:8095/spring-war8/api/ # {"message":"spring-war8 is running","java":"1.8.0_502",...}
curl http://127.0.0.1:8095/spring-war8/api/info # 同上
curl http://127.0.0.1:8095/spring-war8/api/hello/demo
```
浏览器打开 http://127.0.0.1:8095/spring-war8/api/page 可看到渲染后的运行信息页面。
### 关键点
**Java 8 的版本选择**:Spring 5.3.39(最后支持 Java 8 的 Spring 5 线)+ thymeleaf-spring5 3.0.15 + Jackson 2.13.5 + javax.servlet 4.0.1。这套组合与 `spring-war17` 的 Spring 6 / Jakarta 一一对应,便于对照迁移差异。
**没有 servlet 映射的 web.xml**:`WebAppInitializer` 继承 `AbstractAnnotationConfigDispatcherServletInitializer`,Tomcat 9 通过 Servlet 3+ 的 `ServletContainerInitializer` 机制自动发现它并注册 DispatcherServlet。`web.xml` 只声明 `metadata-complete="false"` 和会话超时,不写任何 servlet 映射;`maven-war-plugin` 设置了 `failOnMissingWebXml=false`,即使删掉它也能打包。
**DispatcherServlet 只映射 `/api/*`**:`/api` 前缀外的请求仍由 Tomcat 默认 Servlet 处理(404 或欢迎页),避免传统 war 里 DispatcherServlet 抢占 `/` 后静态资源失效。
**上下文路径**:war 文件名即上下文路径,`finalName` 固定为 `spring-war8`,所以是 `/spring-war8`。想让应用直接挂在根路径 `/`,把 war 改名为 `ROOT.war` 即可。
**两阶段构建**:build 阶段在 `compile-maven3-jdk8` 里 `mvn package`,runtime 阶段只把 war 拷进 `runtime-tomcat9`,运行镜像不含 Maven/源码。
**端口**:容器内 Tomcat 仍是 8080(基础镜像默认),宿主机映射到 8095(避开 spring-war17 的 8085 及其它 demo)。
**JSON 输出**:非 Boot 项目里 `@EnableWebMvc` 不会自动带入 Jackson,所以 `pom.xml` 显式声明了 `jackson-databind`;Spring 检测到它会自动注册 `MappingJackson2HttpMessageConverter`,`/api/*` 返回 `Map` 即得 JSON。缺了它会返回 `HTTP 406 Not Acceptable`。
**健康检查**:compose 用 `curl` 探测 `/spring-war8/api/info`,`start_period: 30s` 覆盖 war 解压与 Spring 初始化;`curl` 由 `runtime-tomcat9` 基座(`runtime-jdk8`)自带,镜像构建时不做任何 yum 联网安装。
### 运维命令
```shell
docker logs -f spring-war8-demo # catalina.out 日志
docker exec spring-war8-demo ls /usr/local/tomcat/webapps # 查看已部署应用(war 与解包目录)
docker exec spring-war8-demo java -version # 确认 JDK 版本(1.8.0_502 / Dragonwell)
```
### 调试时直接在编译镜像里跑
```shell
docker run --rm -it -v "$PWD":/src -w /src \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8 \
mvn -B clean package
```
得到的 `target/spring-war8.war` 可以拷到任意 Tomcat 9 的 `webapps/` 下部署。
### 停止
```shell
sh shutdown.sh
```
+11
View File
@@ -0,0 +1,11 @@
#!/usr/bin/env bash
# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成)
set -euo pipefail
cd "$(dirname "$0")"
IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-spring-war8}
docker build -t "${IMAGE}" .
if [ "${PUSH:-0}" = "1" ]; then
docker push "${IMAGE}"
fi
+30
View File
@@ -0,0 +1,30 @@
version: '3.8'
networks:
spring-war8-demo:
ipam:
driver: default
config:
- subnet: "172.30.4.0/24"
services:
demo:
image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-spring-war8 # 镜像由 build.sh 构建
container_name: spring-war8-demo
restart: unless-stopped
ports: # 映射端口:8095 -> 容器内 Tomcat 8080
- "8095:8080"
environment: # 设置环境变量,相当于docker run命令中的-e
TZ: Asia/Shanghai
JAVA_OPTS: "-Xms128m -Xmx256m -Duser.timezone=Asia/Shanghai"
CATALINA_OPTS: "-Djava.security.egd=file:/dev/./urandom"
healthcheck:
# runtime-tomcat9 已装 curl,直接探测健康页面;start_period 覆盖 war 解压与 Spring 初始化
test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8080/spring-war8/api/info > /dev/null"]
interval: 30s
timeout: 5s
retries: 3
start_period: 30s
networks:
spring-war8-demo:
ipv4_address: 172.30.4.20
+80
View File
@@ -0,0 +1,80 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>cn.odboy</groupId>
<artifactId>spring-war8</artifactId>
<version>1.0.0</version>
<!-- war 包,部署到外置 Tomcat 9;不用 Boot 父 POM,版本全部显式声明 -->
<packaging>war</packaging>
<name>spring-war8</name>
<description>Spring MVC 5.3 + 外置 Tomcat 9 的 war 包示例(Java 8 / javax.servlet)</description>
<properties>
<java.version>1.8</java.version>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- Spring 5.3.x 是最后支持 Java 8 的线;javax.servlet 4.0 对应 Tomcat 9 -->
<spring.version>5.3.39</spring.version>
<thymeleaf-spring5.version>3.0.15.RELEASE</thymeleaf-spring5.version>
<jackson.version>2.13.5</jackson.version>
<javax.servlet-api.version>4.0.1</javax.servlet-api.version>
</properties>
<dependencies>
<!-- spring-webmvc 已传递 spring-core/beans/context/web/aop/expression -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf-spring5</artifactId>
<version>${thymeleaf-spring5.version}</version>
</dependency>
<!-- JSON 序列化:非 Boot 项目不会自动带入 Jackson,@RestController 返回 Map 必须显式声明 -->
<!-- 2.13.x 是最后支持 Java 8 的 Jackson 线(2.14+ 要求 Java 8 但部分模块升到 17,这里取稳) -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<!-- Servlet API 由 Tomcat 提供,编译期需要,不打进 war -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>${javax.servlet-api.version}</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<!-- spring-war8.war,部署后上下文路径即 /spring-war8(也可改名) -->
<finalName>${project.artifactId}</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<!-- 去掉版本号,war 文件名与 upstream/ 部署名一致 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.4.0</version>
<configuration>
<failOnMissingWebXml>false</failOnMissingWebXml>
</configuration>
</plugin>
</plugins>
</build>
</project>
+4
View File
@@ -0,0 +1,4 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p spring-war8-demo down
@@ -0,0 +1,76 @@
package cn.odboy.demo;
import java.lang.management.ManagementFactory;
import java.net.InetAddress;
import java.time.Duration;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.LinkedHashMap;
import java.util.Map;
import javax.servlet.ServletContext;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.SpringVersion;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
/**
* 运行时信息接口。与 springboot-jar8 里的同名类保持一致的输出结构,方便对比 jar 与 war 两种打包方式。
*/
@RestController
public class DemoController {
private static final ZoneId TZ8 = ZoneId.of("Asia/Shanghai");
private static final DateTimeFormatter TIME_FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss XXX");
@Autowired(required = false)
private ServletContext servletContext;
@GetMapping({"/", "/info"})
public Map<String, Object> info() {
Runtime runtime = Runtime.getRuntime();
long uptimeMillis = ManagementFactory.getRuntimeMXBean().getUptime();
Map<String, Object> body = new LinkedHashMap<>();
body.put("message", "spring-war8 is running");
body.put("java", System.getProperty("java.version"));
body.put("javaHome", System.getProperty("java.home"));
body.put("vm", System.getProperty("java.vm.name") + " " + System.getProperty("java.vm.version"));
body.put("spring", SpringVersion.getVersion());
body.put("application", "Spring MVC " + SpringVersion.getVersion() + " + " + servletContextName());
body.put("os", System.getProperty("os.name") + " " + System.getProperty("os.arch"));
body.put("hostname", hostname());
body.put("contextPath", servletContext == null ? "" : servletContext.getContextPath());
body.put("zoneId", ZoneId.systemDefault().getId());
body.put("time", ZonedDateTime.now(TZ8).format(TIME_FMT));
body.put("uptime", Duration.ofMillis(uptimeMillis).toString());
body.put("memory", runtime.totalMemory() / 1024 / 1024 + "MB / max " + runtime.maxMemory() / 1024 / 1024 + "MB");
return body;
}
@GetMapping("/hello/{name}")
public Map<String, Object> hello(@PathVariable String name) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("message", "Hello, " + name + "!");
body.put("time", ZonedDateTime.now(TZ8).format(TIME_FMT));
return body;
}
private String servletContextName() {
if (servletContext == null) {
return "Tomcat";
}
return servletContext.getServerInfo();
}
private static String hostname() {
try {
return InetAddress.getLocalHost().getHostName();
} catch (Exception e) {
return "unknown";
}
}
}
@@ -0,0 +1,28 @@
package cn.odboy.demo;
import java.util.Map;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
/**
* 页面路由,模板见 src/main/resources/templates/index.html。
*/
@Controller
public class PageController {
private final DemoController demoController;
public PageController(DemoController demoController) {
this.demoController = demoController;
}
/** 渲染 templates/index.html;/api/page 返回页面,其它 /api/* 仍返回 JSON */
@GetMapping("/page")
public String page(Model model) {
Map<String, Object> info = demoController.info();
model.addAttribute("info", info);
return "index";
}
}
@@ -0,0 +1,25 @@
package cn.odboy.demo;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
/**
* 替代 web.xml:Tomcat 9 启动时通过 Servlet 3+ 的 ServiceLoader 发现本类,
* 由它注册 DispatcherServlet 与根容器。前缀 /api 的请求进 Spring MVC,其余请求交给 Tomcat 默认 Servlet。
*/
public class WebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
@Override
protected Class<?>[] getRootConfigClasses() {
return null;
}
@Override
protected Class<?>[] getServletConfigClasses() {
return new Class<?>[]{WebConfig.class};
}
@Override
protected String[] getServletMappings() {
return new String[]{"/api/*"};
}
}
@@ -0,0 +1,40 @@
package cn.odboy.demo;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ViewResolverRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.thymeleaf.spring5.SpringTemplateEngine;
import org.thymeleaf.spring5.view.ThymeleafViewResolver;
import org.thymeleaf.templateresolver.ClassLoaderTemplateResolver;
/**
* Spring MVC 配置。@EnableWebMvc 已注册包括 Jackson JSON 在内的默认消息转换器,
* 这里只额外加上 Thymeleaf 视图解析(Spring 5 用 thymeleaf-spring5 包)。
*/
@Configuration
@EnableWebMvc
@ComponentScan("cn.odboy.demo")
public class WebConfig implements WebMvcConfigurer {
@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
ClassLoaderTemplateResolver resolver = new ClassLoaderTemplateResolver();
// 与 springboot-jar8 保持同一套模板路径:src/main/resources/templates/*.html
resolver.setPrefix("templates/");
resolver.setSuffix(".html");
resolver.setTemplateMode("HTML");
resolver.setCharacterEncoding("UTF-8");
resolver.setCacheable(true);
SpringTemplateEngine engine = new SpringTemplateEngine();
engine.setTemplateResolver(resolver);
ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
viewResolver.setTemplateEngine(engine);
viewResolver.setCharacterEncoding("UTF-8");
viewResolver.setOrder(1);
registry.viewResolver(viewResolver);
}
}
@@ -0,0 +1,27 @@
<!DOCTYPE html>
<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>spring-war8 运行信息</title>
<style>
body { font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; margin: 40px; color: #222; }
h1 { font-size: 20px; }
table { border-collapse: collapse; min-width: 520px; }
th, td { border: 1px solid #ddd; padding: 6px 12px; text-align: left; }
th { background: #f5f5f5; width: 160px; }
code { background: #f5f5f5; padding: 1px 4px; }
</style>
</head>
<body>
<h1>spring-war8 运行信息</h1>
<table>
<tr th:each="entry : ${info}">
<th th:text="${entry.key}">key</th>
<td th:text="${entry.value}">value</td>
</tr>
</table>
<p>
其他接口:<code>api/info</code>、<code>api/hello/{name}</code>
</p>
</body>
</html>
@@ -0,0 +1,20 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Tomcat 部署描述符,不影响 Spring 初始化。当前版本没有用 web.xml 写 servlet 映射,
由 WebAppInitializer(ServletContainerInitializer)注册 DispatcherServlet。
这里用 Servlet 2.5 的 DOCTYPE 兼容写法之外的 schema:javax.servlet 4.0 对应 Java 8 / Tomcat 9。
要改会话超时或 MIME 类型时才需要改这里。
-->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0"
metadata-complete="false">
<display-name>spring-war8</display-name>
<session-config>
<session-timeout>30</session-timeout>
</session-config>
</web-app>
+4
View File
@@ -0,0 +1,4 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p spring-war8-demo up -d
+3
View File
@@ -0,0 +1,3 @@
target/
.git/
.DS_Store
+3
View File
@@ -0,0 +1,3 @@
target/
.idea/
*.iml
+22
View File
@@ -0,0 +1,22 @@
# 编译阶段:compile-maven3-jdk8(JDK 8 + Maven 3.9.9 + 阿里云 Maven 源)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8 AS build
WORKDIR /src
# 先只拷贝 POM 预热依赖层:源码改动不会让依赖缓存失效
COPY pom.xml ./
RUN mvn -B -q dependency:go-offline
COPY src ./src
RUN mvn -B -q clean package -DskipTests \
&& cp target/springboot-jar8.jar /src/app.jar
# 运行阶段:runtime-jdk8(仅 JDK,不含 Maven)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk8 AS runtime
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV APP_PORT=8094
WORKDIR /home/admin
COPY --from=build /src/app.jar ./
EXPOSE 8094
# exec 形式,保证 docker stop 的 SIGTERM 能被 JVM 收到,触发 Spring 优雅停机
ENTRYPOINT ["java", "-XX:MaxRAMPercentage=75.0", "-Duser.timezone=Asia/Shanghai", "-jar", "/home/admin/app.jar"]
+88
View File
@@ -0,0 +1,88 @@
# 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
```
+11
View File
@@ -0,0 +1,11 @@
#!/usr/bin/env bash
# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成)
set -euo pipefail
cd "$(dirname "$0")"
IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-springboot-jar8}
docker build -t "${IMAGE}" .
if [ "${PUSH:-0}" = "1" ]; then
docker push "${IMAGE}"
fi
@@ -0,0 +1,30 @@
version: '3.8'
networks:
springboot-jar8-demo:
ipam:
driver: default
config:
- subnet: "172.30.3.0/24"
services:
demo:
image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-springboot-jar8 # 镜像由 build.sh 构建
container_name: springboot-jar8-demo
restart: unless-stopped
ports: # 映射端口
- "8094:8094"
environment: # 设置环境变量,相当于docker run命令中的-e
TZ: Asia/Shanghai
APP_PORT: "8094"
JAVA_OPTS: "-Xms128m -Xmx256m"
healthcheck:
# 运行镜像自带 net-tools,直接用端口探测,不额外安装 curl
test: ["CMD-SHELL", "netstat -tln | grep -q ':8094 '"]
interval: 30s
timeout: 5s
retries: 3
start_period: 30s
networks:
springboot-jar8-demo:
ipv4_address: 172.30.3.20
+53
View File
@@ -0,0 +1,53 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<!-- 父 POM 锁 Spring Boot 2.7.18:这是最后一条支持 Java 8 的 Boot 线(3.x 要求 JDK 17+),与 compile-maven3-jdk8 对应 -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.18</version>
<relativePath/>
</parent>
<groupId>cn.odboy</groupId>
<artifactId>springboot-jar8</artifactId>
<version>1.0.0</version>
<name>springboot-jar8</name>
<description>Spring Boot 2.7 + 内嵌 Tomcat,打成可执行 jar(Java 8)</description>
<properties>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<!-- Web MVC + Jackson + 内嵌 Tomcat(jar 包,可直接 java -jar 启动) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
</dependencies>
<build>
<finalName>${project.artifactId}</finalName>
<plugins>
<!-- repackage 生成 BOOT-INF 结构的可执行 jar,Main-Class 为 JarLauncher -->
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
+4
View File
@@ -0,0 +1,4 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p springboot-jar8-demo down
@@ -0,0 +1,12 @@
package cn.odboy.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
@@ -0,0 +1,73 @@
package cn.odboy.demo;
import java.lang.management.ManagementFactory;
import java.net.InetAddress;
import java.time.Duration;
import java.time.ZoneId;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.util.LinkedHashMap;
import java.util.Map;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringBootVersion;
import org.springframework.core.SpringVersion;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
/**
* 运行时信息接口,用于确认镜像里的 JDK / 时区 / 端口等是否符合预期。
*/
@RestController
public class DemoController {
private static final ZoneId TZ8 = ZoneId.of("Asia/Shanghai");
private static final DateTimeFormatter TIME_FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss XXX");
@Value("${app.name:spring demo}")
private String appName;
@Value("${server.port:0}")
private int port;
/** 返回 JDK、Spring 版本、主机名、时区与运行时长,浏览器可直接看 JSON */
@GetMapping({"/", "/api/info"})
public Map<String, Object> info() {
Runtime runtime = Runtime.getRuntime();
long uptimeMillis = ManagementFactory.getRuntimeMXBean().getUptime();
Map<String, Object> body = new LinkedHashMap<>();
body.put("message", appName + " is running");
body.put("java", System.getProperty("java.version"));
body.put("javaHome", System.getProperty("java.home"));
body.put("vm", System.getProperty("java.vm.name") + " " + System.getProperty("java.vm.version"));
body.put("spring", SpringVersion.getVersion());
body.put("application", "Spring Boot " + SpringBootVersion.getVersion());
body.put("os", System.getProperty("os.name") + " " + System.getProperty("os.arch"));
body.put("hostname", hostname());
body.put("port", port);
body.put("zoneId", ZoneId.systemDefault().getId());
body.put("time", ZonedDateTime.now(TZ8).format(TIME_FMT));
body.put("uptime", Duration.ofMillis(uptimeMillis).toString());
body.put("memory", runtime.totalMemory() / 1024 / 1024 + "MB / max " + runtime.maxMemory() / 1024 / 1024 + "MB");
return body;
}
/** 带路径参数的示例接口 */
@GetMapping("/api/hello/{name}")
public Map<String, Object> hello(@PathVariable String name) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("message", "Hello, " + name + "!");
body.put("time", ZonedDateTime.now(TZ8).format(TIME_FMT));
return body;
}
private static String hostname() {
try {
return InetAddress.getLocalHost().getHostName();
} catch (Exception e) {
return "unknown";
}
}
}
@@ -0,0 +1,28 @@
package cn.odboy.demo;
import java.util.Map;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
/**
* 页面路由,模板见 src/main/resources/templates/index.html。
*/
@Controller
public class PageController {
private final DemoController demoController;
public PageController(DemoController demoController) {
this.demoController = demoController;
}
/** 渲染 templates/index.html;只有 /page 返回页面,接口仍返回 JSON */
@GetMapping("/page")
public String page(Model model) {
Map<String, Object> info = demoController.info();
model.addAttribute("info", info);
return "index";
}
}
@@ -0,0 +1,26 @@
server:
port: ${APP_PORT:8094}
shutdown: graceful
spring:
application:
name: springboot-jar8
lifecycle:
timeout-per-shutdown-phase: 20s
app:
name: springboot-jar8
# 健康检查只需要端口探测,actuator 只暴露 health
management:
endpoints:
web:
exposure:
include: health
endpoint:
health:
show-details: never
logging:
level:
root: INFO
@@ -0,0 +1,27 @@
<!DOCTYPE html>
<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>springboot-jar8 运行信息</title>
<style>
body { font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; margin: 40px; color: #222; }
h1 { font-size: 20px; }
table { border-collapse: collapse; min-width: 520px; }
th, td { border: 1px solid #ddd; padding: 6px 12px; text-align: left; }
th { background: #f5f5f5; width: 160px; }
code { background: #f5f5f5; padding: 1px 4px; }
</style>
</head>
<body>
<h1>springboot-jar8 运行信息</h1>
<table>
<tr th:each="entry : ${info}">
<th th:text="${entry.key}">key</th>
<td th:text="${entry.value}">value</td>
</tr>
</table>
<p>
其他接口:<code>/api/info</code>、<code>/api/hello/{name}</code>、<code>/actuator/health</code>
</p>
</body>
</html>
+4
View File
@@ -0,0 +1,4 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p springboot-jar8-demo up -d
+5
View File
@@ -0,0 +1,5 @@
# 由 build.sh 预下载的 Maven 压缩包经 ADD 解压进镜像,
# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略
build.sh
.git/
.DS_Store
+3
View File
@@ -0,0 +1,3 @@
# 构建产物 / 本地缓存
*.tar.gz
.DS_Store
+25
View File
@@ -0,0 +1,25 @@
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk8
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV MAVEN_HOME=/usr/local/maven3
ENV PATH="${MAVEN_HOME}/bin:$PATH"
WORKDIR /home/admin
# https://archive.apache.org/dist/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz
# 由 build.sh 预先下载到本目录;bin.tar.gz 解包即为 apache-maven-3.9.9/
ADD apache-maven-3.9.9-bin.tar.gz /usr/local/
# make/gcc:编译含 jni/本地库的依赖;git:maven-scm / jgit 插件;
# sysstat/net-tools:排障;tar/wget 若基础镜像未带也一并装上
RUN set -e && yum install \
make \
gcc \
git \
tar \
wget \
sysstat \
net-tools -y; \
mv /usr/local/apache-maven-3.9.9 ${MAVEN_HOME}; \
chmod +x ${MAVEN_HOME}/bin/*; \
mvn -v;
# 阿里云 Maven 镜像(覆盖 central),构建时不依赖 repo1.maven.org 的公网速度
# 用 COPY 而非 ADD/ONBUILD:放在 Maven 安装之后,避免覆盖安装包自带的 conf/settings.xml
COPY settings.xml ${MAVEN_HOME}/conf/settings.xml
+16
View File
@@ -0,0 +1,16 @@
#!/usr/bin/env bash
# 先下载 Maven 到当前目录,再基于本地文件构建镜像
set -euo pipefail
cd "$(dirname "$0")"
DIST=apache-maven-3.9.9-bin.tar.gz
# 每个版本发布后都会留在 archive 上,用它比 dlcdn 稳定(dlcdn 只保留最新版本)
URL=https://archive.apache.org/dist/maven/maven-3/3.9.9/binaries/${DIST}
if [ ! -f "${DIST}" ]; then
curl -fL -o "${DIST}" "${URL}"
fi
IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-maven3-jdk8
docker build -t "${IMAGE}" .
docker push "${IMAGE}"
+77
View File
@@ -0,0 +1,77 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Maven 全局配置(镜像内 ${MAVEN_HOME}/conf/settings.xml)。
只改镜像源,其余保持 Maven 默认行为;本地仓库仍是 ~/.m2/repository,
构建时挂载 -v ~/.m2:/home/admin/.m2 即可复用宿主机缓存。
可选环境变量:
MAVEN_OPTS JVM 参数,如 -Xmx2g
MAVEN_ARGS Maven 4 的通用参数;Maven 3.9 起也支持(如 -B)
-->
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
<!-- 阿里云镜像同时代理 central 与几个常用仓库;<mirrorOf>*</mirrorOf> 会连项目里自建的
private 仓库一起劫持,这里只代理 central,其余仓库仍按项目本身的配置访问 -->
<mirrors>
<mirror>
<id>aliyun-public</id>
<mirrorOf>central</mirrorOf>
<name>Aliyun public</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<mirror>
<id>aliyun-spring</id>
<mirrorOf>spring-milestones,spring-snapshots</mirrorOf>
<name>Aliyun spring</name>
<url>https://maven.aliyun.com/repository/spring</url>
</mirror>
</mirrors>
<profiles>
<!-- 保留 Maven 内建的默认 profile 名,让 aliyun 镜像对 central 生效并优先于内置配置 -->
<profile>
<id>aliyun</id>
<repositories>
<repository>
<id>central</id>
<url>https://maven.aliyun.com/repository/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
<repository>
<id>spring-milestones</id>
<url>https://maven.aliyun.com/repository/spring</url>
</repository>
<repository>
<id>spring-snapshots</id>
<url>https://maven.aliyun.com/repository/spring</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>central</id>
<url>https://maven.aliyun.com/repository/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>aliyun</activeProfile>
</activeProfiles>
</settings>
+6
View File
@@ -0,0 +1,6 @@
# 由 prepare-jdk.sh 生成的 jdk-8.tar.gz 经 ADD 解压进镜像,
# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略
build.sh
prepare-jdk.sh
.git/
.DS_Store
+3
View File
@@ -0,0 +1,3 @@
# 构建产物 / 本地缓存
*.tar.gz
.DS_Store
+18
View File
@@ -0,0 +1,18 @@
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:system-alinux3
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV JAVA_HOME=/usr/local/java
ENV PATH="${JAVA_HOME}/bin:$PATH"
WORKDIR /home/admin
# 阿里 Dragonwell 8(Extended 完整 JDK),版本 8.30.29 / 1.8.0_502
# jdk.java.net 官方归档最早只到 JDK 9,JDK 8 无官方 GA 二进制,改用 Dragonwell 发行版
# 由 prepare-jdk.sh 下载并去掉体积大的 lib/src.zip 后重新打包
ADD jdk-8.tar.gz ./
RUN set -e && yum install \
tar \
wget \
net-tools \
bind-utils -y; \
mv ./dragonwell-8.30.29 ${JAVA_HOME}; \
chmod +x ${JAVA_HOME}/bin/*; \
java -version;
+10
View File
@@ -0,0 +1,10 @@
#!/usr/bin/env bash
# 先运行 prepare-jdk.sh 生成 jdk-8.tar.gz,再基于本地文件构建镜像
set -euo pipefail
cd "$(dirname "$0")"
./prepare-jdk.sh
IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk8
docker build -t "${IMAGE}" .
docker push "${IMAGE}"
+38
View File
@@ -0,0 +1,38 @@
#!/usr/bin/env bash
# 生成 jdk-8.tar.gz 供 Dockerfile 中 ADD 使用:
# 下载 Dragonwell 8(Extended,完整 JDK)→ 解包 → 删除体积大的 lib/src.zip → 重新打包 → 清理解包目录
# jdk.java.net 官方归档最早只到 JDK 9,JDK 8 没有官方 GA 二进制,故改用阿里 Dragonwell 发行版
# 下载的原包 SRC_PKG 保留在本地,重复执行时直接复用、不再重新下载
# 打包时不写入 macOS 扩展属性/ACL:BSD tar 会把 xattr 编码成 AppleDouble(./._*)条目放进包里,
# BuildKit 的 ADD 解包这种包会报 lsetxattr ... xattr "com.apple.provenance": no such file or directory
# 产物已存在时直接复用,重复执行不会重新下载
set -euo pipefail
cd "$(dirname "$0")"
# https://dragonwell.oss-cn-shanghai.aliyuncs.com/8.30.29/
VERSION=8.30.29
PKG=jdk-8.tar.gz
SRC_DIR=dragonwell-${VERSION}
SRC_PKG=Alibaba_Dragonwell_Extended_${VERSION}_x64_linux.tar.gz
URL=https://dragonwell.oss-cn-shanghai.aliyuncs.com/${VERSION}/${SRC_PKG}
if [ -f "${PKG}" ]; then
echo "${PKG} 已存在,跳过"
exit 0
fi
if [ ! -f "${SRC_PKG}" ]; then
curl -fL -o "${SRC_PKG}" "${URL}"
fi
tar -xzf "${SRC_PKG}"
rm -f "${SRC_DIR}/lib/src.zip"
# macOS 解包会给文件带上 com.apple.provenance 等扩展属性,BSD tar 会把它们编码成 AppleDouble
# (./._*)条目写进包内,BuildKit 的 ADD 解包时就报 lsetxattr ... no such file or directory
# 注意:xattr -c 对 JDK 内 0444 的 legal/* 文件无权限清不掉,且清掉后也会再次被 macOS 打上,
# 所以不能靠清 xattr,必须让 tar 不写扩展属性:--no-xattrs 不够,还要 COPYFILE_DISABLE=1
COPYFILE_DISABLE=1 tar --no-xattrs --no-acls -czf "${PKG}" "${SRC_DIR}"
# 只清理解包出来的目录,保留下载的原包 SRC_PKG 以便复用
rm -rf "${SRC_DIR}"
./build.sh
+6
View File
@@ -0,0 +1,6 @@
# 由 prepare-jre.sh 生成的 jre-8.tar.gz 经 ADD 解压进镜像,
# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略
build.sh
prepare-jre.sh
.git/
.DS_Store
+3
View File
@@ -0,0 +1,3 @@
# 构建产物 / 本地缓存
*.tar.gz
.DS_Store
+18
View File
@@ -0,0 +1,18 @@
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:system-alinux3
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV JAVA_HOME=/usr/local/java
ENV PATH="${JAVA_HOME}/bin:$PATH"
WORKDIR /home/admin
# 阿里 Dragonwell 8(Standard 运行时包),版本 8.30.29 / 1.8.0_502
# jdk.java.net 官方归档最早只到 JDK 9,JDK 8 无官方 GA 二进制,改用 Dragonwell 发行版
# 由 prepare-jre.sh 下载并去掉体积大的 lib/src.zip 后重新打包
ADD jre-8.tar.gz ./
RUN set -e && yum install \
tar \
wget \
net-tools \
bind-utils -y; \
mv ./dragonwell-8.30.29 ${JAVA_HOME}; \
chmod +x ${JAVA_HOME}/bin/*; \
java -version;
+10
View File
@@ -0,0 +1,10 @@
#!/usr/bin/env bash
# 先运行 prepare-jre.sh 生成 jre-8.tar.gz,再基于本地文件构建镜像
set -euo pipefail
cd "$(dirname "$0")"
./prepare-jre.sh
IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jre8
docker build -t "${IMAGE}" .
docker push "${IMAGE}"
+38
View File
@@ -0,0 +1,38 @@
#!/usr/bin/env bash
# 生成 jre-8.tar.gz 供 Dockerfile 中 ADD 使用:
# 下载 Dragonwell 8(Standard,运行时包)→ 解包 → 删除体积大的 lib/src.zip → 重新打包 → 清理解包目录
# jdk.java.net 官方归档最早只到 JDK 9,JDK 8 没有官方 GA 二进制,故改用阿里 Dragonwell 发行版
# 下载的原包 SRC_PKG 保留在本地,重复执行时直接复用、不再重新下载
# 打包时不写入 macOS 扩展属性/ACL:BSD tar 会把 xattr 编码成 AppleDouble(./._*)条目放进包里,
# BuildKit 的 ADD 解包这种包会报 lsetxattr ... xattr "com.apple.provenance": no such file or directory
# 产物已存在时直接复用,重复执行不会重新下载
set -euo pipefail
cd "$(dirname "$0")"
# https://dragonwell.oss-cn-shanghai.aliyuncs.com/8.30.29/
VERSION=8.30.29
PKG=jre-8.tar.gz
SRC_DIR=dragonwell-${VERSION}
SRC_PKG=Alibaba_Dragonwell_Standard_${VERSION}_x64_linux.tar.gz
URL=https://dragonwell.oss-cn-shanghai.aliyuncs.com/${VERSION}/${SRC_PKG}
if [ -f "${PKG}" ]; then
echo "${PKG} 已存在,跳过"
exit 0
fi
if [ ! -f "${SRC_PKG}" ]; then
curl -fL -o "${SRC_PKG}" "${URL}"
fi
tar -xzf "${SRC_PKG}"
rm -f "${SRC_DIR}/lib/src.zip"
# macOS 解包会给文件带上 com.apple.provenance 等扩展属性,BSD tar 会把它们编码成 AppleDouble
# (./._*)条目写进包内,BuildKit 的 ADD 解包时就报 lsetxattr ... no such file or directory
# 注意:xattr -c 对 JDK 内 0444 的 legal/* 文件无权限清不掉,且清掉后也会再次被 macOS 打上,
# 所以不能靠清 xattr,必须让 tar 不写扩展属性:--no-xattrs 不够,还要 COPYFILE_DISABLE=1
COPYFILE_DISABLE=1 tar --no-xattrs --no-acls -czf "${PKG}" "${SRC_DIR}"
# 只清理解包出来的目录,保留下载的原包 SRC_PKG 以便复用
rm -rf "${SRC_DIR}"
./build.sh
+5
View File
@@ -0,0 +1,5 @@
# 由 build.sh 预下载的 Tomcat 压缩包经 ADD 解压进镜像,
# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略
build.sh
.git/
.DS_Store
+4
View File
@@ -0,0 +1,4 @@
# 构建产物 / 本地缓存
*.tar.gz
*.sha512
.DS_Store
+23
View File
@@ -0,0 +1,23 @@
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-jdk8
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV CATALINA_HOME=/usr/local/tomcat
ENV CATALINA_BASE=/usr/local/tomcat
ENV PATH="${CATALINA_HOME}/bin:$PATH"
WORKDIR /home/admin
# https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.124/bin/apache-tomcat-9.0.124.tar.gz
# Tomcat 9 用 javax.servlet / Servlet 4.0 / JSP 2.3,兼容 Spring 5(war 部署用)
# 由 build.sh 预先下载并校验 sha512 到本目录,ADD 直接解包得到 apache-tomcat-9.0.124/
ADD apache-tomcat-9.0.124.tar.gz /usr/local/
# 不在这里装任何包:runtime-jdk8 基座已带 curl(健康检查)与 netstat(排障端口),够用。
# nmap-ncat / sysstat 仅排障可选,却位于 alinux3-plus 源,该源元数据在内网/慢网下常下载超时,
# 而基座 dnf 配了 minrate=200k,低于该速率会直接判失败;为避免构建被网络拖垮,这里纯本地操作。
# 需要 nc/sar 时可在基座镜像或运行容器里按需临时安装。
RUN set -e && \
mv /usr/local/apache-tomcat-9.0.124 ${CATALINA_HOME}; \
rm -rf ${CATALINA_HOME}/webapps/*; \
chmod +x ${CATALINA_HOME}/bin/*.sh; \
catalina.sh version;
EXPOSE 8080
# exec 形式:catalina.sh run 前台运行,docker stop 的 SIGTERM 可触发 Tomcat 优雅停机
ENTRYPOINT ["catalina.sh", "run"]
+21
View File
@@ -0,0 +1,21 @@
#!/usr/bin/env bash
# 先下载 Tomcat 9.0.124 到当前目录并校验官方 sha512,再基于本地文件构建镜像
# 官方包直接 ADD 解压,不解包重打:镜像内部与 Tomcat 发行版完全一致,便于对照文档排障
set -euo pipefail
cd "$(dirname "$0")"
VERSION=9.0.124
PKG=apache-tomcat-${VERSION}.tar.gz
URL=https://archive.apache.org/dist/tomcat/tomcat-9/v${VERSION}/bin/${PKG}
if [ ! -f "${PKG}" ]; then
curl -fL -o "${PKG}" "${URL}"
curl -fL -o "${PKG}.sha512" "${URL}.sha512"
# 校验官方 sha512,下载损坏或中间人改写时直接失败(sha512 文件格式:<hash> *<文件名>)
echo "$(awk '{print $1}' "${PKG}.sha512") ${PKG}" | shasum -a 512 -c -
rm -f "${PKG}.sha512"
fi
IMAGE=registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-tomcat9
docker build -t "${IMAGE}" .
docker push "${IMAGE}"