openunison-jib-builder 镜像文档

镜像概述

openunison-jib-builder 是一个专为 Jib 项目设计的构建器镜像，旨在简化 Java 应用的容器化构建流程。Jib 是 Google 开发的 Java 容器化工具，支持无需编写 Dockerfile 即可构建优化的 Docker 镜像。本镜像集成了 Jib 工具及相关依赖，提供了便捷的构建环境，帮助开发者快速实现 Java 应用的容器化。

核心功能与特性

• Jib 工具集成：内置 Jib 构建工具，支持与 Maven 或 Gradle 等主流 Java 构建工具无缝配合
• 简化构建流程：无需手动配置 Docker 环境，直接在容器内完成 Java 应用的镜像构建
• 标准化构建环境：包含 Java 开发工具链及构建依赖，确保跨环境构建一致性
• 轻量级设计：优化镜像体积，减少构建环境资源占用

使用场景与适用范围

• Java 开发者使用 Jib 工具构建 Docker 镜像时的专用构建环境
• CI/CD 流水线中集成 Jib 构建步骤，实现自动化容器化
• 需要简化 Java 应用容器化流程、避免编写 Dockerfile 的开发场景

使用方法与配置说明

基本使用方式

通过 docker run 命令启动容器，挂载 Java 项目目录并执行 Jib 构建命令。

基础构建命令示例

bash
docker run -v $(pwd):/app -w /app openunison-jib-builder jib build -t my-java-app:latest

• -v $(pwd):/app：将本地当前目录（Java 项目根目录）挂载到容器内 /app 工作目录
• -w /app：设置容器工作目录为 /app
• jib build -t my-java-app:latest：执行 Jib 构建命令，生成标签为 my-java-app:latest 的镜像

与构建工具集成

Maven 项目构建

在 Maven 项目中，通过容器执行 Maven 命令触发 Jib 构建：

bash
docker run -v $(pwd):/app -w /app openunison-jib-builder mvn compile jib:build -Dimage=my-java-app:latest

Gradle 项目构建

在 Gradle 项目中，通过容器执行 Gradle 命令触发 Jib 构建：

bash
docker run -v $(pwd):/app -w /app openunison-jib-builder gradle jib --image=my-java-app:latest

高级配置

• 自定义 Jib 配置：通过项目中的 jib-maven-plugin（Maven）或 jib-gradle-plugin（Gradle）配置文件调整构建参数（如基础镜像、暴露端口、环境变量等）
• 镜像推送：添加镜像仓库认证信息（如 Docker Hub、私有仓库），通过 -Ddocker.username 和 -Ddocker.password（Maven）或 --docker-username 和 --docker-password（Gradle）参数实现自动推送

注意事项

• 确保本地 Docker 服务已启动并正常运行
• 挂载目录需保证容器对其有读写权限（可通过 chmod 调整本地目录权限）
• 详细 Jib 配置参数可参考 Jib ***文档