Jenkins基础教程（38）配置Jenkins 服务器之配置Maven：Jenkins大冒险：给Maven插上自动化的翅膀

最新推荐文章于 2025-11-24 20:51:43 发布

原创最新推荐文章于 2025-11-24 20:51:43 发布 · 310 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#jenkins #服务器 #maven

Jenkins基础教程专栏收录该内容

199 篇文章

订阅专栏

每次手动构建Java项目就像重复煮泡面，明明料包齐全却还要一次次加水、放料、等待。今天，让Jenkins这位智能厨房管家解放你的双手。

一、为什么需要配置Jenkins中的Maven？

设想一下，团队中有5个开发者，每个人都在自己的电脑上构建项目。尽管使用相同的代码，却可能因为JDK版本、Maven配置、环境变量的细微差别，导致构建结果不一致。这就是所谓的 "在我电脑上是好的" 综合征。

通过在Jenkins中统一配置Maven，我们可以：

保证一致性：每个构建都使用相同的Maven版本和配置
减少重复工作：无需在每个构建节点手动安装配置Maven
提升可追溯性：每个构建使用的工具版本都有明确记录
简化新节点配置：新增构建节点时，无需手动设置环境

Jenkins配置Maven的核心原理很简单：集中管理，自动分发。就像给整个团队配备标准化厨具，每个人炒出来的菜味道都一致。

二、准备工作：安装Jenkins

在开始配置Maven之前，我们首先需要一个正在运行的Jenkins实例。这里介绍最快捷的Docker安装方式：

docker run \
  --rm \
  -u root \
  -p 8080:8080 \
  -v jenkins-data:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v "$HOME":/home \
  jenkinsci/blueocean

执行完毕后，打开浏览器访问http://localhost:8080，按照提示解锁Jenkins并完成初始设置。

系统资源建议：Jenkins本身不需要太多资源，但考虑到后续的构建任务，建议准备至少2GB内存和10GB硬盘空间。如果你的项目较大，或者需要同时运行多个构建任务，适当增加资源会更顺畅。

三、配置Maven的三种方法

方法一：自动安装（推荐新手）

自动安装是Jenkins的一大特色功能，它能够在需要时自动下载并安装指定版本的Maven。

在Jenkins首页，点击 "Manage Jenkins" → "Global Tool Configuration"
找到 "Maven" 部分，点击 "Maven Installations..." 按钮
点击 "Add Maven" 按钮，勾选 "Install automatically"
在 "Name" 字段中输入 mvn-3.9.6（名称可自定义，但要有意义）
在 "Version" 下拉框中选择最新稳定版（如3.9.6）

图：自动安装Maven的配置界面

这种方法的优势：无需在Jenkins服务器上手动安装Maven，版本切换方便，特别适合在多个项目需要使用不同Maven版本的场景。

方法二：手动安装（推荐生产环境）

对于生产环境，手动安装并提供路径通常更稳定可靠：

在Jenkins服务器上安装Maven：

# 下载Maven
wget https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz

# 解压到/opt目录
sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt

# 创建软链接
sudo ln -s /opt/apache-maven-3.9.6 /opt/maven

在Jenkins的Maven配置中，取消 "Install automatically"，在 "Name" 字段中输入 mvn-3.9.6-manual，在 "MAVEN_HOME" 字段中输入 /opt/maven。
配置环境变量（可选但推荐）：在Jenkins的 "Manage Jenkins" → "Configure System" → "Global properties" 中，添加环境变量 MAVEN_HOME=/opt/maven 并添加到 PATH 中。

生产环境选择手动安装的原因：版本完全可控，不依赖外部网络下载，避免因网络问题导致的构建失败。

方法三：使用容器（适合云原生环境）

如果你在Kubernetes环境中运行Jenkins，可以考虑使用包含Maven的容器镜像作为构建环境：

apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven-builder
    image: maven:3.9.6-jdk-11
    command: ['cat']
    tty: true

这种方法在Jenkins的Kubernetes插件中配置，适合高动态性、需要快速扩展的构建环境。

四、同样重要：配置JDK

Maven离不开JDK，配置JDK的方法与Maven类似：

在 "Global Tool Configuration" 页面找到 "JDK" 部分
点击 "Add JDK" 按钮，可以选择自动安装或指定本地JAVA_HOME
对于自动安装，选择适合的版本（如Java 11或17）

图：JDK自动安装配置界面

JDK版本选择建议：目前推荐选择Java 11或17这些长期支持版本，避免使用过于陈旧或过于新的版本。

五、实战：创建一个Maven项目

现在让我们创建一个实际的Maven项目来验证配置：

点击Jenkins首页的 "New Item"
输入项目名称 java-maven-demo，选择 "Pipeline" 类型
在Pipeline部分，选择 "Pipeline script"，并输入以下内容：

pipeline {
    agent any
    tools {
        // 这里的'mvn-3.9.6'必须与Global Tool Configuration中配置的名称一致
        maven 'mvn-3.9.6'
        jdk 'jdk-11'
    }
    stages {
        stage('Checkout') {
            steps {
                git 'https://github.com/jenkins-docs/simple-java-maven-app.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn -B clean compile'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit 'target/surefire-reports/*.xml'
                }
            }
        }
        stage('Package') {
            steps {
                sh 'mvn package -DskipTests'
            }
        }
    }
    post {
        always {
            emailext (
                subject: "构建结果: ${currentBuild.fullDisplayName}",
                body: "项目${env.JOB_NAME}构建${currentBuild.result}，详情请查看: ${env.BUILD_URL}",
                to: "developer@example.com"
            )
        }
    }
}

这个Pipeline脚本完成了以下任务：

Checkout阶段：从Git仓库拉取代码
Build阶段：编译Java源代码
Test阶段：运行单元测试并生成测试报告
Package阶段：打包项目（跳过测试，因为测试已在上一阶段完成）

tools指令是这里的关键，它告诉Jenkins自动安装或使用已配置的Maven和JDK，并将其加入到PATH中，这样我们就可以直接使用mvn命令。

六、高级配置技巧

1. 使用镜像仓库加速下载

对于国内用户，可以通过配置Maven镜像大幅提升依赖下载速度：

在Jenkins首页，进入 "Manage Jenkins" → "Manage Files and Configurations" → "Custom Config Files"
添加一个新的Maven settings.xml配置：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 
                              http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
        <mirror>
            <id>aliyun-maven</id>
            <mirrorOf>central</mirrorOf>
            <name>Aliyun Maven Mirror</name>
            <url>https://maven.aliyun.com/repository/central</url>
        </mirror>
    </mirrors>
</settings>