如何在 Jenkins 中为每个单独的 Slave 节点配置 Maven 安装？

Question

Symptom

If I create a Maven job in Jenkins ( New Item => Maven project , using the maven plugin) with all defaults and run it, I get this error:

Started by user anonymous
Building on master in workspace /var/lib/jenkins/jobs/job_name/workspace
ERROR: A Maven installation needs to be available for this project to be built.Either your server has no Maven installations defined, or the requested Maven version does not exist.
Finished: FAILURE

Maven runs perfectly from command line with just mvn .

Unacceptable Workaround

There is a system-wide Jenkins configuration for Maven installation: Manage Jenkins => Configure System => Maven / Maven installations . And if I add Maven installation using this web UI (by providing pre-installed path in MAVEN_HOME as /usr/share/maven ), the job runs SUCCESSFULLY.

Question: Why is it global Jenkins config and not Slave-specific one?

The global Jenkins config does not make sense: Maven is run per Slave, not per Jenkins.

The zoo of Slaves where Jenkins runs jobs may contain Slaves with various platforms, OSes, environments where different versions of Maven are installed in different locations.

Question: How would I configure Maven installation per Slave node?

Setting environment variables like MAVEN_HOME and M2_HOME to the same path for entire system on Slave node didn't work.

Versions

Both Jenkins Master and Slave are Linux hosts. Jenkins version: 1.598

Answer 1

Assuming you have Java and Maven installed on your slave:

1. Go to Manage Jenkins -> Manage Nodes
2. Click configure icon on the node you wish to configure
3. Scroll down to 'Node Properties' and tick the 'Tool Locations' checkbox
4. Fill in the options for Java and Maven.

It should now work (even if you have configured a Maven installation on the master).

Answer 2

For me, the solution was to go to Manage Jenkins -> Global Tool Configuration, and set up maven there. You can access this via /configureTools (ex: http://your-ip:8080/jenkins/configureTools )

Example: Maven installations

• Name: my_maven_3.3.9
• MAVEN_HOME: /usr/share/maven

Additional configurations for other common tools at /configureTools :

Git installations

• Name: my_git_2.11.0
• Path to Git executable: /usr/bin/git

JDK installations

• Name: my_jdk_1.8.0_161
• JAVA_HOME: /opt/jdk/jdk1.8.0_161

Answer 3

If you do NOT add Maven to the Master configuration and you just install it on every slave with their own possibly different environment variables (example with version 3.2.5)

M2_HOME=C:\apache-maven-3.2.5
M2=C:\apache-maven-3.2.5\bin
Path+=;C:\apache-maven-3.2.5\bin

then every Jenkins slave will just use Maven with local settings.

Answer 4

To make it simple, just use my public docker image

docker push chiraggupta95/jenkinswithmvn:v1

In case you want to customize your own image, just check out my git repo for complete instructions.

 https://github.com/chiraggupta95apr/jenkins

Happy Coding :)