Jenkins plugins declare a minimum supported Jenkins version. The minimum Jenkins version is a good way for plugin developers to indicate the range of Jenkins versions they are willing to support and test. See the developer documentation for the recommended minimum Jenkins version.
In a local copy of your fork of the plugin repository create a git branch for your work with the command:
git checkout -b require-newer-core master
Update the minimum required Jenkins version by setting a jenkins.version
value in the properties section of the pom.xml
file:
<properties>
<jenkins.version>2.452.4</jenkins.version>
</properties>
If the plugin is already using the plugin bill of materials, then the bill of materials also needs to be updated with the matching artifactId
for the minimum required Jenkins version.
The version
may also need an upgrade see the developer documentation.
The git diff
might look like this:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.jenkins.tools.bom</groupId>
- <artifactId>bom-2.375.x</artifactId>
+ <artifactId>bom-2.440.x</artifactId>
- <version>2179.v0884e842b_859</version>
+ <version>3387.v0f2773fa_3200</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Use Apache Maven to compile the plugin and run its automated tests with the command:
mvn clean verify
Commit that change:
git add pom.xml
git commit -m "Require 2.452.4 as minimum Jenkins version"
Push the change to GitHub:
git push origin --set-upstream require-newer-core
Total 0 (delta 0), reused 0 (delta 0), pack-reused 0 remote: remote: Create a pull request for '{task-identifier}' on GitHub by visiting: remote: https://github.com/user/your-plugin/pull/new/{task-identifier} remote: To github.com:user/your-plugin.git * [new branch] {task-identifier} -> {task-identifier} Branch '{task-identifier}' tracking remote branch '{task-identifier}'.
Notice that the output of the command includes the URL, which can be used to open a pull request. Copy that URL in your web browser and submit a pull request.