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.
Version¶
Available from version 1.0
Examples¶
1<labeller type="defaultlabeller">
2 <initialBuildLabel>1</initialBuildLabel>
3 <prefix>Foo-1-</prefix>
4 <incrementOnFailure>true</incrementOnFailure>
5 <labelFormat>00000</labelFormat>
6</labeller>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