Installation

This chapter covers the installation of the P4 for Jenkins.

Requirements

  • Jenkins 2.462.3 or greater.
  • P4 Server 2020.1 or greater.
  • Minimum Perforce Protection of open for the Jenkins user.
  • Review Build feature requires P4 Code Review 2022.1 or greater.

Known Limitations

  • One Jenkins job per P4 Code Review branch.

  • P4 Build Farm servers are not supported, they were superseded byP4 Commit-Edge servers in 2013.2

  • The change summary for a concurrent build may report additional changes if that build is already in progress, JENKINS-57901.

Installation

  1. Open Jenkins in a browser.
  2. Go to Manage Jenkins.
  3. In System Configuration, click Plugins.
  4. In the side bar menu, click Available plugins.
  5. Search for P4 Plugin.
  6. Select the check box and click Install (found in the top right corner of the page).

If you are unable to find the plugin, you may need to refresh the update site.

  1. Select the Advanced tab (under Manage Plugins)
  2. Click the Check now button at the bottom of the page.
  3. When Done go back to the update center and try again.

Building

To build the plugin and run the tests use the following:

mvn package

For the tests to run you must have p4d in your PATH, to skip tests use the -DskipTests flag.

Manual installation

  1. Open Jenkins in a browser.
  2. Go to Manage Jenkins.
  3. In System Configuration, click Plugins.
  4. In the side bar menu, click Advanced settings.
  5. In the Deploy Plugin section, click the Browse.
  6. Click Deploy.

P4 for Jenkins will start to install in Jenkins.

Useful links