Jenkins 配置 Maven

在 Jenkins 容器中安装并配置 Maven 构建工具

下载 Maven

从 Apache Maven 官网 下载最新稳定版，例如 apache-maven-3.9.9-bin.tar.gz。

安装步骤

1. 进入容器创建目录

docker exec -it jenkins bash
mkdir -p /home/soft
exit

2. 在宿主机准备安装包

mkdir -p /home/soft/pkg

3. 拷贝安装包到容器

docker cp /home/soft/pkg/apache-maven-3.9.9-bin.tar.gz jenkins:/home/soft/

4. 容器内解压

docker exec -it jenkins bash
cd /home/soft
tar -xzvf apache-maven-3.9.9-bin.tar.gz
# 确认解压后的路径
ls /home/soft/apache-maven-3.9.9
exit

5. Jenkins 中配置环境变量

1. 进入 Jenkins：系统管理 → 系统配置
2. 找到 全局属性，勾选 环境变量
3. 点击 新增，添加：

键	值
PATH	$PATH:/home/soft/apache-maven-3.9.9/bin

4. 点击 保存

6. （可选）配置全局 settings.xml

使用 Config File Provider 插件统一管理 Maven 的 settings.xml，无需在每个项目中重复配置。

安装插件

系统管理 → 插件管理 → 可选插件 → 搜索 Config File Provider → 安装

添加配置文件

1. 系统管理 → Managed files → Add a new Config → Maven settings.xml
2. 填写内容（以下为整合阿里云镜像的最小配置）：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0
                              https://maven.apache.org/xsd/settings-1.2.0.xsd">

    <!-- 本地仓库路径 -->
    <localRepository>/repo/maven</localRepository>

    <!-- 镜像：阿里云 Maven 仓库 -->
    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <mirrorOf>*</mirrorOf>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>

    <!-- 全局 JDK 版本配置示例 -->
    <profiles>
        <profile>
            <id>jdk-17</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <maven.compiler.source>17</maven.compiler.source>
                <maven.compiler.target>17</maven.compiler.target>
                <maven.compiler.release>17</maven.compiler.release>
            </properties>
        </profile>
    </profiles>
</settings>

在 Pipeline 中引用

pipeline {
    agent any
    tools {
        maven 'Maven3'  // 全局工具配置中定义的 Maven 名称
    }
    stages {
        stage('Build') {
            steps {
                // configFileProvider 会自动应用 settings.xml
                configFileProvider(
                    [configFile(fileId: 'maven-settings-aliyun', variable: 'MAVEN_SETTINGS')]
                ) {
                    sh "mvn clean package -s $MAVEN_SETTINGS"
                }
            }
        }
    }
}

7. 验证配置

创建一个测试任务，添加构建步骤 Invoke Maven，执行 mvn --version 确认 Maven 已正确配置。

参考链接

• Maven 下载页
• 阿里云 Maven 镜像
• Config File Provider 插件