Default Labeller

By default, CCNet uses a plain incrementing build number as a build label. Some source controls (e.g. Perforce Source Control Block) require you to use a different naming scheme if you want CCNet to apply labels to source control on successful builds.

You can do this by specifying your own configuration of the default labeller in your project.


Available from version 1.0


1<labeller type="defaultlabeller">
2  <initialBuildLabel>1</initialBuildLabel>
3  <prefix>Foo-1-</prefix>
4  <incrementOnFailure>true</incrementOnFailure>
5  <labelFormat>00000</labelFormat>

Configuration Elements

Element Description Type Required Default Version
dynamicValues The dynamic values to use for the labeller. Dynamic Values array No None 1.5
incrementOnFailure If true, the label will be incremented even if the build fails. Otherwise it will only be incremented if the build succeeds. Boolean No false 1.1
initialBuildLabel Allows you to set the initial build number. This will only be used when on the first build of a project, meaning that when you change this value, you'll have to stop the CCNet service and delete the state file. Int32 No 1 1.5
labelFormat A format applied to the buildnumber. String No 0 1.0
postfix Any string to be put at the end of all labels. String No None 1.0
prefix Any string to be put in front of all labels. String No None 1.0
labelPrefixFile The location to a file which contains the prefix to be used. If this is filled in, the LabelPrefix setting is ignored, and the value from the file is used instead. This allows other people to set the prefix, without them needing to adjust CCNet.config, or bother a person who has access. Tip : place this file in a separate folder that is shared, so that others do not have direct access to the build server. String No None 1.7
labelPrefixFileSearchPattern A reg-ex expression to enforce the data of the contents in LabelPrefixFile. The first match is taken. This allows a bit more userfriendlyness. (skip whitespace, extra lines and so) example : \d\+\.\d\+\.\d\+\. This will enforce a layout of 3 numbers separated by a period ideal for a version prefix String No

Automatically Generated

Documentation generated on Monday, 26 May 2014 at 7:18:00 AM