https://github.com/jenkinsci/p4-plugin
Perforce plugin for Jenkins
https://github.com/jenkinsci/p4-plugin
p4 perforce scm version-control-system versioning
Last synced: 9 months ago
JSON representation
Perforce plugin for Jenkins
- Host: GitHub
- URL: https://github.com/jenkinsci/p4-plugin
- Owner: jenkinsci
- License: bsd-2-clause
- Created: 2014-07-03T16:12:05.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2025-05-02T11:49:15.000Z (10 months ago)
- Last Synced: 2025-05-02T12:39:20.261Z (10 months ago)
- Topics: p4, perforce, scm, version-control-system, versioning
- Language: Java
- Homepage: https://plugins.jenkins.io/p4/
- Size: 83 MB
- Stars: 84
- Watchers: 117
- Forks: 162
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# P4 Plugin
[](https://jenkins.io/download/)
[](https://www.perforce.com/products/helix-core)
[](https://www.perforce.com/products/helix-swarm)
Jenkins plugin for a Perforce Helix Core Server (P4D).
## Contents
* [Release notes](https://github.com/jenkinsci/p4-plugin/blob/master/RELEASE.md)
* [FreeStyle setup guide](docs/SETUP.md)
* [Pipeline setup guide](docs/WORKFLOW.md)
* [Pipeline libraries](docs/LIBRARY.md)
* [MultiBranch guide](docs/MULTI.md)
* [Building Jobs](docs/BUILDINGJOBS.md)
* [Post Build Actions](docs/POSTBUILD.md)
* [Advanced scripting](docs/P4GROOVY.md)
* [Notes page](docs/NOTES.md)
* [Jenkins page](https://plugins.jenkins.io/p4)
## Requirements
* Jenkins 2.462.3 or greater.
* Helix Core Server 2020.1 or greater.
* Minimum Perforce Protection of `open` for the Jenkins user.
* Review Build feature requires Helix Swarm 2022.1 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
- The change summary for a concurrent build may report additional changes if that build is already in progress, [JENKINS-57901](https://issues.jenkins.io/browse/JENKINS-57901).
## Installation
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. Select the check 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.
The latest SNAPSHOT builds are available [here](https://ci.jenkins.io/blue/organizations/jenkins/Plugins%2Fp4-plugin/branches).
## Manual install
1. Open Jenkins in a browser; for example 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).