Install Notes
-------------

* Requires **[Git Plugin][wiki-git]**,
  **[Mercurial Plugin][wiki-hg]** or **[Subversion Plugin][wiki-svn]**. Additionally the "Poll SCM" build trigger needs to be enabled. No polling schedule is required.
  In order to make Subversion Plugin work, it's required to add jenkins credentials to the request (e.g. `http://username:token@ci.jenkins-ci.org/`) or enable "Allow anonymous read access" option in "Configure Global Security" section.
* "Jenkins Url" is the base URL of your [Jenkins][] server. For example: `http://ci.jenkins-ci.org/`.

Details
-------

[Jenkins][] is a popular continuous integration server.

If you're using the standard [Jenkins Git Plugin][wiki-git],
[Jenkins Mercurial Plugin][wiki-hg] or [Jenkins Subversion Plugin][wiki-svn] to poll & check out your repository,
you can quickly and easily switch to a push model using this service.

It will send a request to your Jenkins instance telling it about the
repositories and branches that changed. Jenkins will then poll the repository
and build if needed. See push notification from repository for [Git][wiki-push-git]
or [Mercurial][wiki-push-hg] on the Jenkins wiki for information.

*When using the hook together with the Jenkins Mercurial Plugin, please note
that the hook always uses the HTTPS clone URL of the configured repository to trigger
builds in Jenkins. This in turn means that you should always configure your targeted
Jenkins jobs with the same exact HTTPS clone URL. This is due to the fact that unlike
the Jenkins Git or Subversion Plugin, the Jenkins Mercurial Plugin doesn't do loose clone URL
matching across protocols.*

Further Integration
-------

In order to get build notifications from Jenkins to P4 DAM's project activity, please install [P4 DAM Jenkins Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Deveo+Plugin).


[jenkins]: http://jenkins-ci.org/ "Jenkins CI Server"
[wiki-git]: https://wiki.jenkins-ci.org/display/JENKINS/Git+plugin
[wiki-hg]: https://wiki.jenkins-ci.org/display/JENKINS/Mercurial+Plugin
[wiki-svn]: https://wiki.jenkins-ci.org/display/JENKINS/Subversion+Plugin
[wiki-push-git]: https://wiki.jenkins-ci.org/display/JENKINS/Git+plugin#GitPlugin-Pushnotificationfromrepository
[wiki-push-hg]: https://wiki.jenkins-ci.org/display/JENKINS/Mercurial+Plugin#MercurialPlugin-PushNotifications
