ajxb/p4-plugin

Perforce plugin for Jenkins

P4 Plugin

Jenkins plugin for a Perforce Helix Core Server (P4D).

Contents

• Release notes
• FreeStyle setup guide
• Pipeline setup guide
• Pipeline libraries
• MultiBranch guide
• Building Jobs
• Post Build Actions
• Advanced scripting
• Notes page
• Jenkins page

Requirements

• Jenkins 2.89.1 or greater.
• Helix Core Server 2016.2 or greater.
• Minimum Perforce Protection of open for the Jenkins user.
• Review Build feature requires Helix Swarm 2016.2 or greater.

Known Limitations

• One Jenkins job per Helix Swarm branch.
• Helix 'Build Farm' servers are not supported, they were superseded by Helix Commit-Edge servers back in 2013.2

Install

1. Open Jenkins in a browser; for example http://jenkins_host:8080
2. Browse to 'Manage Jenkins' --> 'Manage Plugins' and select the Available tab.
3. Find the 'P4 Plugin' or use the Filter if needed
4. Check the box and click the Install without restart button

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 centre and try again.

Building

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

mvn package

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

Lastest SNAPSHOT builds available here.

Manual install

1. Open Jenkins in a browser; e.g. http://jenkins_host:8080
2. Browse to 'Manage Jenkins' --> 'Manage Plugins’ and select the Advanced tab.
3. Click the Browse button in the 'Upload Plugin' section.
4. Find the location of the 'p4.hpi' file and click the Open button.
5. Click the Download now and install after restart button (this might be different on the newer version).