feat: 新增 JDK 8 系列镜像与示例(runtime-jdk8 / jre8 / tomcat9 / compile-maven3-jdk8,springboot-jar8 / spring-war8)
This commit is contained in:
@@ -0,0 +1,3 @@
|
||||
target/
|
||||
.git/
|
||||
.DS_Store
|
||||
@@ -0,0 +1,3 @@
|
||||
target/
|
||||
.idea/
|
||||
*.iml
|
||||
@@ -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
|
||||
@@ -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
|
||||
```
|
||||
Executable
+11
@@ -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
|
||||
@@ -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
|
||||
@@ -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>
|
||||
Executable
+4
@@ -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>
|
||||
Executable
+4
@@ -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
|
||||
@@ -0,0 +1,3 @@
|
||||
target/
|
||||
.git/
|
||||
.DS_Store
|
||||
@@ -0,0 +1,3 @@
|
||||
target/
|
||||
.idea/
|
||||
*.iml
|
||||
@@ -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"]
|
||||
@@ -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
|
||||
```
|
||||
Executable
+11
@@ -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
|
||||
@@ -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>
|
||||
Executable
+4
@@ -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>
|
||||
Executable
+4
@@ -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
|
||||
Reference in New Issue
Block a user