Jenkins plugin for a Perforce Helix Core Server (P4D).
open
for the Jenkins user.If you are unable to find the plugin, you may need to refresh the 'Update Site'.
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.
# P4 Plugin [![Jenkins Version](https://img.shields.io/badge/Jenkins-2.138.4%2B-green.svg)](https://jenkins.io/download/) [![Helix Core](https://img.shields.io/badge/Helix%20Core-2019.1%2B-green.svg)](https://www.perforce.com/products/helix-core) [![Helix Swarm](https://img.shields.io/badge/Helix%20Swarm-2019.1%2B-green.svg)](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.138.4 or greater. * Helix Core Server 2019.1 or greater. * Minimum Perforce Protection of `open` for the Jenkins user. * Review Build feature requires Helix Swarm 2019.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).
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#35 | 30263 | Sandeep Kumar | Update minimum supported jenkins version. | ||
#34 | 30151 | Sandeep Kumar | Update README.md for P4 1.15.1 | ||
#33 | 29482 | Paul Allen | Update required version of Jenkins | ||
#32 | 28971 | Paul Allen |
Merge pull request #156 from p4sonika/patch-1 Update README.md |
||
#31 | 25082 | Paul Allen | Added a shields for min version. | ||
#30 | 24643 | Paul Allen | Update Release notes for 1.9.0 | ||
#29 | 24489 | Paul Allen | Updated min requirements. | ||
#28 | 24174 | Paul Allen | Deprecated Helix 'Build Farm' servers. | ||
#27 | 24139 | Paul Allen |
Merge pull request #72 from p4kevin/master Updates to Freestyle documentation. |
||
#26 | 23013 | Paul Allen | Add new pages for Pipeline. | ||
#25 | 22823 | Paul Allen |
Update URLs in README. Minor find bug fix. |
||
#24 | 21856 | Paul Allen | Update min Jenkins version | ||
#23 | 17835 | Paul Allen |
Draft: documentation notes page. Hints and Tips from Jenkins Users. |
||
#22 | 17834 | Paul Allen | Helix branding update. | ||
#21 | 16541 | Paul Allen | Document unshelve step and DSL | ||
#20 | 16540 | Paul Allen | Split up README to separate docs. | ||
#19 | 16539 | Paul Allen | Update release notes for 1.3.3 | ||
#18 | 16187 | Paul Allen | Update release notes | ||
#17 | 15858 | Paul Allen | Docs: Workflow setup | ||
#16 | 15696 | Paul Allen | Update release notes | ||
#15 | 15671 | Paul Allen | Added Parallel & Custom Parallel builds to the README. | ||
#14 | 15527 | Paul Allen | Update release notes and docs. | ||
#13 | 15493 | Paul Allen | Update Swarm URLs in README | ||
#12 | 15419 | Paul Allen | Updates README with 'change' vs 'P4_CHANGELIST' issue | ||
#11 | 15363 | Paul Allen |
Update POM and release notes for next release. Latest: 1.2.7 |
||
#10 | 15329 | Paul Allen | Update release notes. | ||
#9 | 14915 | Paul Allen | Update release notes. | ||
#8 | 13956 | Paul Allen |
Update README Update Troubleshooting section for Edge/Commit issue. Added release notes for 1.2.4 and 1.2.3 releases. |
||
#7 | 13619 | Paul Allen |
Document building at a change. JENKINS-28301 |
||
#6 | 12468 | Karl Wirth |
Documenting solution for overcoming Java 128bit encryption restriction. Error seen: Unable to connect: com.perforce.p4java.exception.ConnectionException: Error occurred during the SSL handshake: invalid SSL session Due to current US export control restrictions for some countries, the standard JDK package only comes with 128 bit encryption level cyphers. In order to use P4Java to connect to an SSL-enabled Perforce server, those living in eligible countries may download the unlimited strength JCE (Java Cryptography Extension) package and replace the current default cryptography jar files with the unlimited strength files. |
||
#5 | 11235 | Paul Allen | MarkDown for Publish Asset. | ||
#4 | 10014 | Paul Allen | Added doc warning for reserved environment vars. | ||
#3 | 9704 | Paul Allen | Tidy up README and pushed out a new release 1.0.3 for null/empty params | ||
#2 | 9696 | Paul Allen | Updated install notes and removed old ref to p4-client | ||
#1 | 9690 | Paul Allen |
[Branching using p4-jenkins] Release 1.0.1 |
||
//guest/paul_allen/dev/p4-jenkins/p4-client/README.md | |||||
#1 | 9645 | Paul Allen | Markdown file |