diff --git a/README.md b/README.md index acf5a4b..4bba869 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ ``` image/ 自建镜像:每个目录 = Dockerfile + build.sh,目录名即镜像 tag 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 前端,均为两阶段构建) demo/plateform/ 平台类示例(tengine3 反向代理) ``` @@ -27,12 +27,15 @@ demo/plateform/ 平台类示例(tengine3 反向代理) | 目录 | 镜像 tag | 基础镜像 / 版本 | 说明 | | ------------------------------ | -------------------------------- | --------------------------------- | ------------------------------------------------------------------------ | | `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-jdk17` | `kenaito:runtime-jdk17` | 上者 / JDK 17 | 运行环境,仅 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-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-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-dotnet6` | `kenaito:runtime-dotnet6` | 上者 / ASP.NET Core 运行时 6.0.35 | 运行环境,仅运行时 | | `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-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-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-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 目标时用 | @@ -104,6 +108,8 @@ demo/plateform/ 平台类示例(tengine3 反向代理) | [`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/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/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 两阶段构建示例 | @@ -124,9 +130,10 @@ demo/plateform/ 平台类示例(tengine3 反向代理) - 编译:`runtime-dotnet*` 之上的 `compile-dotnet*` - 运行:`runtime-dotnet*` - java 适用于 java 应用 - - 编译:`compile-maven3-jdk17` / `-jdk21` / `-jdk25`(JDK + Maven,按目标字节码版本选) - - 运行:`runtime-jdk*`(仅 JDK,直接 `java -jar` 或作为外置 Tomcat 的基础镜像) - - war 包运行:`runtime-tomcat10`(JDK 17 + Tomcat 10.1,兼容 Spring 6 / Servlet 6) + - 编译:`compile-maven3-jdk8` / `-jdk17` / `-jdk21` / `-jdk25`(JDK + Maven,按目标字节码版本选) + - 运行:`runtime-jdk*`(仅 JDK,直接 `java -jar` 或作为外置 Tomcat 的基础镜像);仅需运行时可用更精简的 `runtime-jre8` + - 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 应用 - 编译与运行:`runtime-python310`(已配置 pip 镜像源);另有 `runtime-python315` 作为 node / ansible 镜像的基础,不单独用于示例 - go 适用于 go 应用 diff --git a/demo/app/spring-war8/.dockerignore b/demo/app/spring-war8/.dockerignore new file mode 100644 index 0000000..5c3ba1e --- /dev/null +++ b/demo/app/spring-war8/.dockerignore @@ -0,0 +1,3 @@ +target/ +.git/ +.DS_Store diff --git a/demo/app/spring-war8/.gitignore b/demo/app/spring-war8/.gitignore new file mode 100644 index 0000000..ec10551 --- /dev/null +++ b/demo/app/spring-war8/.gitignore @@ -0,0 +1,3 @@ +target/ +.idea/ +*.iml diff --git a/demo/app/spring-war8/Dockerfile b/demo/app/spring-war8/Dockerfile new file mode 100644 index 0000000..b97defe --- /dev/null +++ b/demo/app/spring-war8/Dockerfile @@ -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 diff --git a/demo/app/spring-war8/README.md b/demo/app/spring-war8/README.md new file mode 100644 index 0000000..c0b5086 --- /dev/null +++ b/demo/app/spring-war8/README.md @@ -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 +``` diff --git a/demo/app/spring-war8/build.sh b/demo/app/spring-war8/build.sh new file mode 100755 index 0000000..c7d6e8c --- /dev/null +++ b/demo/app/spring-war8/build.sh @@ -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 diff --git a/demo/app/spring-war8/docker-compose.yml b/demo/app/spring-war8/docker-compose.yml new file mode 100644 index 0000000..a51da8b --- /dev/null +++ b/demo/app/spring-war8/docker-compose.yml @@ -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 diff --git a/demo/app/spring-war8/pom.xml b/demo/app/spring-war8/pom.xml new file mode 100644 index 0000000..f35390c --- /dev/null +++ b/demo/app/spring-war8/pom.xml @@ -0,0 +1,80 @@ + + + 4.0.0 + + cn.odboy + spring-war8 + 1.0.0 + + war + spring-war8 + Spring MVC 5.3 + 外置 Tomcat 9 的 war 包示例(Java 8 / javax.servlet) + + + 1.8 + 1.8 + 1.8 + UTF-8 + + 5.3.39 + 3.0.15.RELEASE + 2.13.5 + 4.0.1 + + + + + + org.springframework + spring-webmvc + ${spring.version} + + + org.thymeleaf + thymeleaf-spring5 + ${thymeleaf-spring5.version} + + + + + com.fasterxml.jackson.core + jackson-databind + ${jackson.version} + + + + javax.servlet + javax.servlet-api + ${javax.servlet-api.version} + provided + + + + + + ${project.artifactId} + + + org.apache.maven.plugins + maven-compiler-plugin + 3.13.0 + + 1.8 + 1.8 + + + + + org.apache.maven.plugins + maven-war-plugin + 3.4.0 + + false + + + + + + diff --git a/demo/app/spring-war8/shutdown.sh b/demo/app/spring-war8/shutdown.sh new file mode 100755 index 0000000..706168c --- /dev/null +++ b/demo/app/spring-war8/shutdown.sh @@ -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 diff --git a/demo/app/spring-war8/src/main/java/cn/odboy/demo/DemoController.java b/demo/app/spring-war8/src/main/java/cn/odboy/demo/DemoController.java new file mode 100644 index 0000000..59f23f9 --- /dev/null +++ b/demo/app/spring-war8/src/main/java/cn/odboy/demo/DemoController.java @@ -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 info() { + Runtime runtime = Runtime.getRuntime(); + long uptimeMillis = ManagementFactory.getRuntimeMXBean().getUptime(); + + Map 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 hello(@PathVariable String name) { + Map 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"; + } + } +} diff --git a/demo/app/spring-war8/src/main/java/cn/odboy/demo/PageController.java b/demo/app/spring-war8/src/main/java/cn/odboy/demo/PageController.java new file mode 100644 index 0000000..be3dc0a --- /dev/null +++ b/demo/app/spring-war8/src/main/java/cn/odboy/demo/PageController.java @@ -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 info = demoController.info(); + model.addAttribute("info", info); + return "index"; + } +} diff --git a/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebAppInitializer.java b/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebAppInitializer.java new file mode 100644 index 0000000..b77ece4 --- /dev/null +++ b/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebAppInitializer.java @@ -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/*"}; + } +} diff --git a/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebConfig.java b/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebConfig.java new file mode 100644 index 0000000..1755e12 --- /dev/null +++ b/demo/app/spring-war8/src/main/java/cn/odboy/demo/WebConfig.java @@ -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); + } +} diff --git a/demo/app/spring-war8/src/main/resources/templates/index.html b/demo/app/spring-war8/src/main/resources/templates/index.html new file mode 100644 index 0000000..9b06139 --- /dev/null +++ b/demo/app/spring-war8/src/main/resources/templates/index.html @@ -0,0 +1,27 @@ + + + + + spring-war8 运行信息 + + + +

spring-war8 运行信息

+ + + + + +
keyvalue
+

+ 其他接口:api/info、api/hello/{name} +

+ + diff --git a/demo/app/spring-war8/src/main/webapp/WEB-INF/web.xml b/demo/app/spring-war8/src/main/webapp/WEB-INF/web.xml new file mode 100644 index 0000000..b71da55 --- /dev/null +++ b/demo/app/spring-war8/src/main/webapp/WEB-INF/web.xml @@ -0,0 +1,20 @@ + + + + + spring-war8 + + + 30 + + + diff --git a/demo/app/spring-war8/startup.sh b/demo/app/spring-war8/startup.sh new file mode 100755 index 0000000..ee4ab23 --- /dev/null +++ b/demo/app/spring-war8/startup.sh @@ -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 diff --git a/demo/app/springboot-jar8/.dockerignore b/demo/app/springboot-jar8/.dockerignore new file mode 100644 index 0000000..5c3ba1e --- /dev/null +++ b/demo/app/springboot-jar8/.dockerignore @@ -0,0 +1,3 @@ +target/ +.git/ +.DS_Store diff --git a/demo/app/springboot-jar8/.gitignore b/demo/app/springboot-jar8/.gitignore new file mode 100644 index 0000000..ec10551 --- /dev/null +++ b/demo/app/springboot-jar8/.gitignore @@ -0,0 +1,3 @@ +target/ +.idea/ +*.iml diff --git a/demo/app/springboot-jar8/Dockerfile b/demo/app/springboot-jar8/Dockerfile new file mode 100644 index 0000000..6edcf14 --- /dev/null +++ b/demo/app/springboot-jar8/Dockerfile @@ -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"] diff --git a/demo/app/springboot-jar8/README.md b/demo/app/springboot-jar8/README.md new file mode 100644 index 0000000..ebc1667 --- /dev/null +++ b/demo/app/springboot-jar8/README.md @@ -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 +``` diff --git a/demo/app/springboot-jar8/build.sh b/demo/app/springboot-jar8/build.sh new file mode 100755 index 0000000..867575d --- /dev/null +++ b/demo/app/springboot-jar8/build.sh @@ -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 diff --git a/demo/app/springboot-jar8/docker-compose.yml b/demo/app/springboot-jar8/docker-compose.yml new file mode 100644 index 0000000..eead866 --- /dev/null +++ b/demo/app/springboot-jar8/docker-compose.yml @@ -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 diff --git a/demo/app/springboot-jar8/pom.xml b/demo/app/springboot-jar8/pom.xml new file mode 100644 index 0000000..ea838fb --- /dev/null +++ b/demo/app/springboot-jar8/pom.xml @@ -0,0 +1,53 @@ + + + 4.0.0 + + + + org.springframework.boot + spring-boot-starter-parent + 2.7.18 + + + + cn.odboy + springboot-jar8 + 1.0.0 + springboot-jar8 + Spring Boot 2.7 + 内嵌 Tomcat,打成可执行 jar(Java 8) + + + 1.8 + UTF-8 + + + + + + org.springframework.boot + spring-boot-starter-web + + + org.springframework.boot + spring-boot-starter-thymeleaf + + + org.springframework.boot + spring-boot-starter-actuator + + + + + ${project.artifactId} + + + + org.springframework.boot + spring-boot-maven-plugin + + + + + diff --git a/demo/app/springboot-jar8/shutdown.sh b/demo/app/springboot-jar8/shutdown.sh new file mode 100755 index 0000000..df36f04 --- /dev/null +++ b/demo/app/springboot-jar8/shutdown.sh @@ -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 diff --git a/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoApplication.java b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoApplication.java new file mode 100644 index 0000000..a941ddc --- /dev/null +++ b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoApplication.java @@ -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); + } +} diff --git a/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoController.java b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoController.java new file mode 100644 index 0000000..ad4b41a --- /dev/null +++ b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/DemoController.java @@ -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 info() { + Runtime runtime = Runtime.getRuntime(); + long uptimeMillis = ManagementFactory.getRuntimeMXBean().getUptime(); + + Map 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 hello(@PathVariable String name) { + Map 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"; + } + } +} diff --git a/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/PageController.java b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/PageController.java new file mode 100644 index 0000000..69f91c0 --- /dev/null +++ b/demo/app/springboot-jar8/src/main/java/cn/odboy/demo/PageController.java @@ -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 info = demoController.info(); + model.addAttribute("info", info); + return "index"; + } +} diff --git a/demo/app/springboot-jar8/src/main/resources/application.yml b/demo/app/springboot-jar8/src/main/resources/application.yml new file mode 100644 index 0000000..be297d2 --- /dev/null +++ b/demo/app/springboot-jar8/src/main/resources/application.yml @@ -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 diff --git a/demo/app/springboot-jar8/src/main/resources/templates/index.html b/demo/app/springboot-jar8/src/main/resources/templates/index.html new file mode 100644 index 0000000..fbf5a80 --- /dev/null +++ b/demo/app/springboot-jar8/src/main/resources/templates/index.html @@ -0,0 +1,27 @@ + + + + + springboot-jar8 运行信息 + + + +

springboot-jar8 运行信息

+ + + + + +
keyvalue
+

+ 其他接口:/api/info、/api/hello/{name}、/actuator/health +

+ + diff --git a/demo/app/springboot-jar8/startup.sh b/demo/app/springboot-jar8/startup.sh new file mode 100755 index 0000000..56fc459 --- /dev/null +++ b/demo/app/springboot-jar8/startup.sh @@ -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 diff --git a/image/compile-maven3-jdk8/.dockerignore b/image/compile-maven3-jdk8/.dockerignore new file mode 100644 index 0000000..ccc6575 --- /dev/null +++ b/image/compile-maven3-jdk8/.dockerignore @@ -0,0 +1,5 @@ +# 由 build.sh 预下载的 Maven 压缩包经 ADD 解压进镜像, +# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略 +build.sh +.git/ +.DS_Store diff --git a/image/compile-maven3-jdk8/.gitignore b/image/compile-maven3-jdk8/.gitignore new file mode 100644 index 0000000..9a1bb28 --- /dev/null +++ b/image/compile-maven3-jdk8/.gitignore @@ -0,0 +1,3 @@ +# 构建产物 / 本地缓存 +*.tar.gz +.DS_Store diff --git a/image/compile-maven3-jdk8/Dockerfile b/image/compile-maven3-jdk8/Dockerfile new file mode 100644 index 0000000..461dcf4 --- /dev/null +++ b/image/compile-maven3-jdk8/Dockerfile @@ -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 diff --git a/image/compile-maven3-jdk8/build.sh b/image/compile-maven3-jdk8/build.sh new file mode 100755 index 0000000..1a8844a --- /dev/null +++ b/image/compile-maven3-jdk8/build.sh @@ -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}" diff --git a/image/compile-maven3-jdk8/settings.xml b/image/compile-maven3-jdk8/settings.xml new file mode 100644 index 0000000..8b40fed --- /dev/null +++ b/image/compile-maven3-jdk8/settings.xml @@ -0,0 +1,77 @@ + + + + + + + + aliyun-public + central + Aliyun public + https://maven.aliyun.com/repository/public + + + aliyun-spring + spring-milestones,spring-snapshots + Aliyun spring + https://maven.aliyun.com/repository/spring + + + + + + + aliyun + + + central + https://maven.aliyun.com/repository/public + + true + + + false + + + + spring-milestones + https://maven.aliyun.com/repository/spring + + + spring-snapshots + https://maven.aliyun.com/repository/spring + + true + + + + + + central + https://maven.aliyun.com/repository/public + + true + + + false + + + + + + + + aliyun + + + diff --git a/image/runtime-jdk8/.dockerignore b/image/runtime-jdk8/.dockerignore new file mode 100644 index 0000000..6fe465e --- /dev/null +++ b/image/runtime-jdk8/.dockerignore @@ -0,0 +1,6 @@ +# 由 prepare-jdk.sh 生成的 jdk-8.tar.gz 经 ADD 解压进镜像, +# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略 +build.sh +prepare-jdk.sh +.git/ +.DS_Store diff --git a/image/runtime-jdk8/.gitignore b/image/runtime-jdk8/.gitignore new file mode 100644 index 0000000..9a1bb28 --- /dev/null +++ b/image/runtime-jdk8/.gitignore @@ -0,0 +1,3 @@ +# 构建产物 / 本地缓存 +*.tar.gz +.DS_Store diff --git a/image/runtime-jdk8/Dockerfile b/image/runtime-jdk8/Dockerfile new file mode 100644 index 0000000..59239b5 --- /dev/null +++ b/image/runtime-jdk8/Dockerfile @@ -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; diff --git a/image/runtime-jdk8/build.sh b/image/runtime-jdk8/build.sh new file mode 100755 index 0000000..c9ed98a --- /dev/null +++ b/image/runtime-jdk8/build.sh @@ -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}" diff --git a/image/runtime-jdk8/prepare-jdk.sh b/image/runtime-jdk8/prepare-jdk.sh new file mode 100755 index 0000000..9b8cfad --- /dev/null +++ b/image/runtime-jdk8/prepare-jdk.sh @@ -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 diff --git a/image/runtime-jre8/.dockerignore b/image/runtime-jre8/.dockerignore new file mode 100644 index 0000000..6647f85 --- /dev/null +++ b/image/runtime-jre8/.dockerignore @@ -0,0 +1,6 @@ +# 由 prepare-jre.sh 生成的 jre-8.tar.gz 经 ADD 解压进镜像, +# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略 +build.sh +prepare-jre.sh +.git/ +.DS_Store diff --git a/image/runtime-jre8/.gitignore b/image/runtime-jre8/.gitignore new file mode 100644 index 0000000..9a1bb28 --- /dev/null +++ b/image/runtime-jre8/.gitignore @@ -0,0 +1,3 @@ +# 构建产物 / 本地缓存 +*.tar.gz +.DS_Store diff --git a/image/runtime-jre8/Dockerfile b/image/runtime-jre8/Dockerfile new file mode 100644 index 0000000..2e804cd --- /dev/null +++ b/image/runtime-jre8/Dockerfile @@ -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; diff --git a/image/runtime-jre8/build.sh b/image/runtime-jre8/build.sh new file mode 100755 index 0000000..c9ce076 --- /dev/null +++ b/image/runtime-jre8/build.sh @@ -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}" diff --git a/image/runtime-jre8/prepare-jre.sh b/image/runtime-jre8/prepare-jre.sh new file mode 100755 index 0000000..939775f --- /dev/null +++ b/image/runtime-jre8/prepare-jre.sh @@ -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 diff --git a/image/runtime-tomcat9/.dockerignore b/image/runtime-tomcat9/.dockerignore new file mode 100644 index 0000000..d3f5903 --- /dev/null +++ b/image/runtime-tomcat9/.dockerignore @@ -0,0 +1,5 @@ +# 由 build.sh 预下载的 Tomcat 压缩包经 ADD 解压进镜像, +# ADD 的源文件必须在构建上下文内,因此 *.tar.gz 不能在这里忽略 +build.sh +.git/ +.DS_Store diff --git a/image/runtime-tomcat9/.gitignore b/image/runtime-tomcat9/.gitignore new file mode 100644 index 0000000..901b252 --- /dev/null +++ b/image/runtime-tomcat9/.gitignore @@ -0,0 +1,4 @@ +# 构建产物 / 本地缓存 +*.tar.gz +*.sha512 +.DS_Store diff --git a/image/runtime-tomcat9/Dockerfile b/image/runtime-tomcat9/Dockerfile new file mode 100644 index 0000000..0e7c016 --- /dev/null +++ b/image/runtime-tomcat9/Dockerfile @@ -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"] diff --git a/image/runtime-tomcat9/build.sh b/image/runtime-tomcat9/build.sh new file mode 100755 index 0000000..e0fcd04 --- /dev/null +++ b/image/runtime-tomcat9/build.sh @@ -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 文件格式: *<文件名>) + 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}"