From 59c26df5e049537c17d3139e0c1f43e87227d426 Mon Sep 17 00:00:00 2001 From: windyboy Date: Fri, 18 Sep 2026 14:35:00 +0800 Subject: [PATCH] Add standalone Podman build script with dedicated Maven cache --- .dockerignore | 9 ++++++ README.md | 2 ++ build.sh | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++ docs/build.md | 26 ++++++++++++++++ pom.xml | 7 +++++ 5 files changed, 127 insertions(+) create mode 100644 .dockerignore create mode 100755 build.sh create mode 100644 docs/build.md diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..e088401 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,9 @@ +.git +.idea +.settings +.cache +logs +src +docs +target/* +!target/*.jar diff --git a/README.md b/README.md index 46b5873..2b76226 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,8 @@ > **Java 版本要求：JDK 8。** 项目基于 Spring Boot 1.5 和 JAXB 生成代码构建，未验证 JDK 11+；请使用 JDK 8 进行本地开发、构建和运行。 +**Podman 测试镜像构建**：见 [构建说明](docs/build.md)，使用 `./build.sh -t localhost/admin-api:1.2.1-pg-test`，Maven 缓存默认放在 `../chengdu-repository`。 + **定位：只读数据服务层。** 本服务不生产业务数据，OMMS 主数据由 Oracle 侧系统维护，本服务只做查询与对外暴露；仅 MySQL 侧的 UI 设置为本服务自有写数据。 **不在本服务职责内**：航班动态实时推送、航班保障流程、报文收发与解析落库（由 AODB/消息中间件侧负责）。本服务不保存航班数据，历史航班从 Elasticsearch 读取。 diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..8ef5d12 --- /dev/null +++ b/build.sh @@ -0,0 +1,83 @@ +#!/usr/bin/env bash +set -euo pipefail + +PROJECT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)" +REPOSITORY="$PROJECT_DIR/../chengdu-repository" +IMAGE='localhost/admin-api:1.2.1-pg-test' +JAR_FILE='target/admin-api-1.2.1-SNAPSHOT.jar' + +usage() { + cat <<'EOF' +用法：./build.sh [-t 镜像名称:tag] [-r Maven缓存目录] + + -t 默认 localhost/admin-api:1.2.1-pg-test，不读取 Maven 版本 + -r 默认项目旁的 ../chengdu-repository；相对路径以项目目录为基准 + -h 显示帮助 + +需要 JAVA_HOME 指向 JDK 8、Maven（或完整的 Maven Wrapper）和 Podman。 +脚本编译 JAR、检查 PostgreSQL 驱动，然后构建镜像；不会推送或启动服务。 +EOF +} + +die() { printf '错误：%s\n' "$*" >&2; exit 1; } + +while getopts ':t:r:h' option; do + case "$option" in + t) IMAGE="$OPTARG" ;; + r) REPOSITORY="$OPTARG" ;; + h) usage; exit 0 ;; + :) die "选项 -$OPTARG 缺少参数" ;; + \?) die "未知选项 -$OPTARG" ;; + esac +done +shift $((OPTIND - 1)) +[[ $# -eq 0 ]] || die '不支持额外的位置参数' +[[ -n "$IMAGE" && -n "$REPOSITORY" ]] || die '镜像名和缓存目录不能为空' + +cd "$PROJECT_DIR" +[[ -n "${JAVA_HOME:-}" ]] || die '请先设置 JAVA_HOME，指向 JDK 8' +for tool in java javac jar; do + [[ -x "$JAVA_HOME/bin/$tool" ]] || die "JAVA_HOME 中缺少 bin/$tool" +done +JAVA_VERSION="$("$JAVA_HOME/bin/javac" -version 2>&1)" +[[ "$JAVA_VERSION" == 'javac 1.8.'* ]] || die "必须使用 JDK 8，当前为 $JAVA_VERSION" +export PATH="$JAVA_HOME/bin:$PATH" +command -v podman >/dev/null 2>&1 || die '找不到 podman' + +if [[ -f mvnw && -f .mvn/wrapper/maven-wrapper.properties && -f .mvn/wrapper/maven-wrapper.jar ]]; then + MAVEN=(bash ./mvnw) +else + command -v mvn >/dev/null 2>&1 || die 'Maven Wrapper 不完整，请安装 Maven 3（支持 JDK 8）' + MAVEN=(mvn) +fi + +mkdir -p -- "$REPOSITORY" +REPOSITORY="$(cd -- "$REPOSITORY" && pwd)" +printf 'Maven 缓存：%s\n镜像：%s\n' "$REPOSITORY" "$IMAGE" +"${MAVEN[@]}" "-Dmaven.repo.local=$REPOSITORY" -DskipTests package + +[[ -f "$JAR_FILE" ]] || die "未生成 $JAR_FILE；若修改项目版本，请同步更新脚本中的 JAR_FILE" +# 先完整读取列表，避免 pipefail 下 grep 提前退出造成误报。 +JAR_CONTENTS="$("$JAVA_HOME/bin/jar" tf "$JAR_FILE")" +if ! grep -E '^BOOT-INF/lib/postgresql-[^/]+\.jar$' <<< "$JAR_CONTENTS"; then + die '应用 JAR 中缺少 PostgreSQL JDBC 驱动，停止镜像构建' +fi + +# Dockerfile 内嵌，通过标准输入传给 Podman，无需单独维护文件。 +podman build --pull=always \ + -f - \ + --build-arg "JAR_FILE=$JAR_FILE" \ + -t "$IMAGE" \ + . <<'DOCKERFILE' +FROM docker.io/library/eclipse-temurin:8-jre-jammy + +ENV TZ=Asia/Shanghai +RUN ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \ + && echo 'Asia/Shanghai' > /etc/timezone + +EXPOSE 8080 +ARG JAR_FILE +COPY ${JAR_FILE} /usr/local/adminapi/myapp.jar +ENTRYPOINT ["java", "-jar", "/usr/local/adminapi/myapp.jar"] +DOCKERFILE +printf '构建完成：%s\n' "$IMAGE" diff --git a/docs/build.md b/docs/build.md new file mode 100644 index 0000000..578270f --- /dev/null +++ b/docs/build.md @@ -0,0 +1,26 @@ +# Podman 测试镜像构建 + +在 `admin-api` 目录执行，先把 `JAVA_HOME` 设置为本机 **JDK 8** 路径： + +```bash +export JAVA_HOME=/path/to/jdk8 +./build.sh -t localhost/admin-api:1.2.1-pg-test +``` + +- Maven 依赖、插件及其元数据默认缓存到 **`../chengdu-repository`**，以脚本所在的项目目录为基准，不受调用位置影响，也不修改全局 Maven 配置。 +- 等效 Maven 参数是 `-Dmaven.repo.local=/absolute/path/to/chengdu-repository`。可以用 `./build.sh -r /other/repository -t localhost/admin-api:1.2.1-pg-test` 覆盖目录。 +- 应用构建产物仍是 `target/admin-api-1.2.1-SNAPSHOT.jar`，不会放进依赖缓存目录。修改项目版本后需同步脚本中的 `JAR_FILE`。 +- 镜像默认名为 `localhost/admin-api:1.2.1-pg-test`；`-t` 指定完整镜像名和 tag，**不会自动读取 Maven 版本**。 +- 使用完整 Maven Wrapper；仓库当前 Wrapper 不完整时回退到本机 `mvn`，请使用支持 JDK 8 的 Maven 3。 +- 编译使用 `package -DskipTests`，成功后检查 `BOOT-INF/lib/postgresql-*.jar`；驱动缺失立即停止。 +- 编译、驱动检查和镜像构建统一由 `build.sh` 完成，Dockerfile 内嵌在脚本中，通过标准输入传给 Podman，无需单独的 `Dockerfile.podman`。基础镜像为公开的 `docker.io/library/eclipse-temurin:8-jre-jammy`。`--pull=always` 强制从仓库拉取基础镜像，不依赖预先存在的本地镜像，也不访问旧私有镜像仓库；构建机器需能访问 Docker Hub 和配置的 Maven 仓库。 +- 原 `Dockerfile` 保留不变，仍属于旧的私有镜像构建流程。 +- 脚本只构建，不推送、不启动容器；中间件 Compose 不会自动启动此 API。加入 PostgreSQL 驱动不等于切换数据源，数据库配置和 SQL 兼容性仍需单独验证。 + +只编译、不构建镜像时： + +```bash +mvn -Dmaven.repo.local="$(pwd)/../chengdu-repository" package -DskipTests +``` + +参考：[Temurin 官方镜像](https://hub.docker.com/_/eclipse-temurin)、[PostgreSQL JDBC 下载与 Java 兼容性](https://jdbc.postgresql.org/download/)。 diff --git a/pom.xml b/pom.xml index 27b8d16..812387d 100644 --- a/pom.xml +++ b/pom.xml @@ -42,6 +42,13 @@ spring-boot-starter-jdbc + + org.postgresql + postgresql + 42.7.9 + runtime + + mysql mysql-connector-java