desiato/jenkins-gradle

docker-jenkins-gradle 镜像文档

镜像概述和主要用途

docker-jenkins-gradle是一个预集成Gradle构建工具的Jenkins镜像，通过sdkman包管理器安装Gradle，旨在简化需要使用Gradle进行项目构建的CI/CD流程。该镜像基于Jenkins官方基础镜像，保留Jenkins核心功能的同时，省去手动安装配置Gradle的步骤，可直接用于依赖Gradle的项目构建任务。

核心功能和特性

• 完整Jenkins功能：包含Jenkins官方镜像的全部核心功能，支持插件扩展、任务配置、构建流程管理等
• 预安装Gradle：通过sdkman安装Gradle，无需额外配置即可在Jenkins任务中直接使用gradle命令
• 标准端口支持：默认开放Jenkins Web界面端口(8080)和代理通信端口(50000)
• 数据持久化：支持通过数据卷挂载/var/jenkins_home目录，确保Jenkins配置、插件和构建数据持久化存储

使用场景和适用范围

适用于需要使用Gradle作为构建工具的项目的CI/CD流程，尤其适合：

• Java、Kotlin等基于JVM的项目构建
• 依赖Gradle任务的自动化测试、打包和部署流程
• 需要快速搭建包含Gradle环境的Jenkins服务的场景

使用方法和配置说明

基本运行命令

通过以下命令启动容器：

bash
docker run -p 8080:8080 -p 50000:50000 \
-v jenkins:/var/jenkins_home \
docker.xuanyuan.run/desiato/jenkins-gradle

参数说明

• -p 8080:8080：将容器内Jenkins Web界面端口映射到主机8080端口，用于访问Jenkins管理界面
• -p 50000:50000：将容器内Jenkins代理通信端口映射到主机50000端口，用于Jenkins节点与主服务通信
• -v jenkins:/var/jenkins_home：创建并挂载名为jenkins的数据卷到容器内/var/jenkins_home目录，用于持久化存储Jenkins配置、插件和构建数据

访问和配置

1. 容器启动后，通过http://<主机IP>:8080访问Jenkins Web界面
2. 首次启动需输入初始管理员密码，可通过以下命令从容器日志获取：

   bash
   docker logs <容器ID或容器名称>
   

3. 完成初始化配置后，即可在Jenkins任务中直接使用gradle命令执行构建任务（如gradle build、gradle test等）

数据持久化注意事项

使用数据卷jenkins:/var/jenkins_home可确保容器重启或重建后，Jenkins的配置、插件和历史构建记录不丢失。如需备份数据，可通过以下命令导出数据卷内容：

bash
docker volume inspect jenkins  # 获取数据卷存储路径
cp -r <数据卷路径> <备份目录>