brollydev/jsonnet-maven

镜像概述和主要用途

本Docker镜像集成了Java运行环境、Maven构建工具和Jsonnet数据模板语言，旨在为开发和构建流程提供统一的环境支持。通过整合这三类工具，可有效避免因本地环境依赖差异导致的构建或运行问题，适用于Java项目开发、Maven构建流程及Jsonnet模板处理等场景。

核心功能和特性

• 集成Java环境：包含指定版本的Java运行时环境，支持Java应用的编译、运行及调试。
• 内置Maven：集成Maven构建工具，支持Java项目的依赖管理、编译、打包（如生成JAR/WAR文件）等标准流程。
• 内置Jsonnet：预装Jsonnet工具，支持解析Jsonnet模板文件并生成JSON数据，满足配置模板化、数据动态生成等需求。
• 环境一致性：提供标准化的开发和构建环境，确保不同机器、CI/CD流水线中执行的操作结果一致，减少"本地可运行，线上有问题"的情况。

使用场景和适用范围

• Java项目开发与构建：适用于需要使用Maven进行依赖管理、代码编译、单元测试及打包的Java项目，尤其是多开发者协作或跨环境部署的场景。
• Jsonnet模板处理：用于需要通过Jsonnet生成JSON配置文件的场景，如Kubernetes资源配置、服务配置模板化、多环境配置生成等。
• CI/CD流程集成：可作为CI/CD流水线（如Jenkins、GitLab CI）中的构建节点，自动化执行Java项目构建、Jsonnet模板渲染等任务。
• 多工具协同场景：需要同时使用Java（运行应用）、Maven（构建项目）和Jsonnet（处理配置）的复合任务，如"构建Java应用并通过Jsonnet生成其运行时配置"。

使用方法和配置说明

1. 获取镜像

假设镜像已发布至Docker仓库（如Docker Hub），通过以下命令拉取：

bash
docker pull [镜像仓库地址]/[镜像名称]:[标签]
# 示例：docker pull myrepo/java-maven-jsonnet:latest

2. 验证工具版本

运行容器并验证Java、Maven、Jsonnet是否正常安装：

bash
docker run --rm [镜像名称]:[标签] sh -c "java -version && mvn -version && jsonnet --version"

输出应包含各工具的版本信息，确认环境可用。

3. Maven项目构建示例

将本地Java项目目录挂载到容器中，执行Maven构建命令：

bash
# 假设当前目录为Java项目根目录（包含pom.xml）
docker run -v $(pwd):/app -w /app [镜像名称]:[标签] mvn clean package

• -v $(pwd):/app：将本地项目目录挂载到容器内的/app目录；
• -w /app：设置容器的工作目录为/app，确保Maven命令在项目根目录执行；
• mvn clean package：执行Maven清理并打包，构建产物（如JAR文件）将保存在本地项目的target/目录下（因目录挂载，容器内生成的文件会同步到本地）。

4. Jsonnet模板处理示例

使用容器内的Jsonnet工具解析本地模板文件并生成JSON：

bash
# 假设本地有Jsonnet模板文件 template.jsonnet
docker run -v $(pwd):/data -w /data [镜像名称]:[标签] jsonnet template.jsonnet -o output.json

• -v $(pwd):/data：挂载本地目录到容器的/data；
• jsonnet template.jsonnet -o output.json：解析template.jsonnet，将生成的JSON数据保存到output.json，文件将同步到本地目录。

5. 配置参数与环境变量

常用环境变量

• MAVEN_OPTS：设置Maven运行参数，如指定本地仓库路径（加速依赖下载）：

  bash
  docker run -e MAVEN_OPTS="-Dmaven.repo.local=/m2/repo" -v $(pwd)/m2:/m2/repo [镜像名称]:[标签] mvn clean package
  

  上述命令通过-v挂载本地Maven仓库目录./m2到容器内/m2/repo，避免重复下载依赖。

• JAVA_HOME：默认已配置，指向容器内Java安装路径，如需自定义可通过-e覆盖（需确保路径与镜像内Java实际位置匹配）。

注意事项

• 镜像标签：建议使用特定版本标签（如java17-maven3.9-jsonnet0.20）而非latest，确保环境版本稳定。
• 数据持久化：构建产物、Maven依赖等需通过目录挂载（-v）保存到本地，否则容器销毁后数据丢失。
• 权限问题：若挂载目录出现权限错误，可通过-u $(id -u):$(id -g)指定容器内用户ID，与本地用户保持一致：

  bash
  docker run -u $(id -u):$(id -g) -v $(pwd):/app -w /app [镜像名称]:[标签] mvn clean package