This plugin adds the Subversion support (via SVNKit) to Hudson. This plugin is bundled inside hudson.war if you download it from hudson-ci.org.

Plugin Information

Basic Usage

Once this plugin is installed, you'll see Subversion as one of the options in the SCM. See inline help for more information about how to use it.

Usage with Server Certificates

An important note for those wanting to use client certificates to authenticate to your subversion server.   Your PKCS12 cert file must not have a blank passphrase or a blank export password as it will cause authentication to fail.    Refer to SVNKit:0000271 for more details.

Advanced Features/Configurations

Post-commit hook

Hudson can poll Subversion repositories for changes, and while this is reasonably efficient, this can only happen up to every once a minute, so you may still have to wait a full minute before Hudson detects a change.

To reduce this delay, you can set up a post commit hook so the Subversion repository can notify Hudson whenever a change is made to that repository. To do this, put the following script in your post-commit file:

REPOS="$1"
REV="$2"
UUID=`svnlook uuid $REPOS`
/usr/bin/wget \
  --header "Content-Type:text/plain;charset=UTF-8" \
  --post-data "`svnlook changed --revision $REV $REPOS`" \
  --output-document "-" \
  http://server/hudson/subversion/${UUID}/notifyCommit?rev=$REV

Jobs on Hudson need to be configured with the SCM polling option to benefit from this behavior. This is so that you can have some jobs that are never triggered by the post-commit hook, such as release related tasks, by omitting the SCM polling option. The configured polling can have any schedule (probably infrequent like monthly or yearly). The net effect is as if polling happens out of their usual cycles.

For this to work, your Hudson has to allow anonymous read access to the system. If access control to your Hudson is more restrictive, you may need to specify the username and password, depending on how your authentication is configured.

If your Hudson uses the "Prevent Cross Site Request Forgery exploits" security option, the above request will be rejected with 403 errors ("No valid crumb was included"). The crumb needed in this request can be obtained from the URL http://server/hudson/crumbIssuer/api/xml (or /api/json). This can be included in the wget call above with something like this: --header `wget -q --output-document - \ 'http://server/hudson/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)'`

Windows specific post-commit hook

The above script is difficult under the Windows command processor seeing as there is no support for backtick output extraction and there is no built in wget command. Instead the following contents can be added to post-commit.bat:

SET REPOS=%1
SET REV=%2
SET CSCRIPT=C:\WINDOWS\system32\cscript.exe
SET VBSCRIPT=C:\Repositories\post-commit-hook-hudson.vbs
SET SVNLOOK=C:\Subversion\svnlook.exe
SET HUDSON=http://server/hudson/
"%CSCRIPT%" "%VBSCRIPT%" "%REPOS%" %2 "%SVNLOOK%" %HUDSON%

The batch file relies on the following VBScript being available in the file designated by the VBSCRIPT variable above:

repos   = WScript.Arguments.Item(0)
rev     = WScript.Arguments.Item(1)
svnlook = WScript.Arguments.Item(2)
hudson  = WScript.Arguments.Item(3)

Set shell = WScript.CreateObject("WScript.Shell")

Set uuidExec = shell.Exec(svnlook & " uuid " & repos)
Do Until uuidExec.StdOut.AtEndOfStream
  uuid = uuidExec.StdOut.ReadLine()
Loop
Wscript.Echo "uuid=" & uuid

Set changedExec = shell.Exec(svnlook & " changed --revision " & rev & " " & repos)
Do Until changedExec.StdOut.AtEndOfStream
  changed = changed + changedExec.StdOut.ReadLine() + Chr(10)
Loop
Wscript.Echo "changed=" & changed

url = hudson + "subversion/" + uuid + "/notifyCommit?rev=" + rev
Wscript.Echo url

Set http = CreateObject("Microsoft.XMLHTTP")
http.open "POST", url, False
http.setRequestHeader "Content-Type", "text/plain;charset=UTF-8"
http.send changed

Change Log

Version 1.17 (Apr 21, 2010)

• Failure to retrieve remote revisions shouldn't result in a new build (issue #6136)
• Updated German & Japanese localization.
• Fixed that "svn log copier thread" is nerver destoryed if exception is thrown while checking out.(issue #6144)

Version 1.16 (Mar 23, 2010)

• Fixed issue #6030, where the new includedRegions feature broke the excludedRegions.

Version 1.15 (Mar 22, 2010)

• Added Spanish translation.

Version 1.14 (Mar 17, 2010)

• Add includedRegions feature, analogous to the excludedRegions feature (issue #5954).

Version 1.13 (Mar 8, 2010)

• Fixing polling for projects where last build was run on Hudson 1.345+ with Subversion plugin 1.11 or older (issue #5827)

Version 1.12 (Mar 3, 2010)

• Polling period can be set shorter than the quiet period now. (issue #2180)
• Exposed properties to the remote API. (report)
• Validation for "excluded users" field was too restrictive. (issue #5684)
• Avoid ClassCastException in change log computation if job SCM is changed from Subversion to something else. (issue #5705)

Version 1.11 (Feb 11, 2010)

• Allow commit comment to be provided when tagging. (issue #1725)
• Fix display of existing tags when there are multiple repositories.
• Minor updates to aid in debugging problems triggering jobs from a post-commit hook.

Version 1.10 (Jan 27, 2010)

• SSL client certificate authentication was not working (issue #5349)
• Make all links from help text open a new window/tab, to avoid leaving the config page when there are unsaved changes (issue #5348)
• Export tag information via remote API (issue #882)

Version 1.9 (Jan 16, 2010)

• SSL client certificate authentication was not working (issue #5230)
• Tagging UI allows users to specify one-time credential for tagging (issue #2053)
• Fix a bug in the notifyCommit post-commit hook wrt a commit spanning multiple jobs (issue #4741)

Version 1.8 (Dec 23, 2009)

• Polling can now ignore commits based on configurable keywords in the commit messages. (patch)
• Several minor bug fixes

Version 1.7 (Sep 3, 2009)

• Fixed a bug in the exclusion pattern matching
• Fixed a bug in an interaction with the Trac plugin.
• Fixed a bug in the interaction of concurrent builds and Subversion polling (issue #4270)

Version 1.6 (Aug 28, 2009)

• Fixed a bug in polling on slaves (issue #4299)
• Fixed "authentication cancelled error" problem (issue #3936)

Version 1.5 (Aug 19, 2009)

• Polling is performed on the slaves now (report)
• "Tag this Build" fails for 1.311+ with SVN Plugin (issue #4018)

Version 1.3 (July 8, 2009)

• Subversion checkouts created files for symlinks (issue #3949)

Version 1.2 (June 24, 2009)

• Fixed "endless authentication to SVN when invalid user/password" issue (issue #2909)

Version 1.0 (June 15, 2009)

• Initial version split off from the core, to isolate SVNKit that has a commercial-unfriendly license.