Breki CCNet Utilities

File Release Notes and Changelog

Release Name: CruiseControlUtils-1.7.314.3

Notes: A new version of BrekiLabeller for CruiseControl.NET is released. It contains some new options, contributed by Tobias Jahn. 1. Installation: - copy ccnet.Breki.plugin.dll to the CC.net "server" subdirectory - modify CC.net configuration file and save it 2. Configuration: Version format: "M.m.b.r" M - major number m - minor number b - build number r - release number Parameters: - BuildNumberScheme: defines the algorithm for generating build numbers. Possible values: "Increment": increments an existing build number "NoIncrement: uses an existing build number "MonthDaySinceReleaseStart": (default) generates build number based on the release start date and formula: number of months since release start * 100 + current day in month "FromVersionFile": uses the build number from the version file - RevisionNumberScheme: defines the algorithm for generating release numbers. Possible values: "DailyIncremental": (default) increment an existing revision number if the previous build was on the same day as the new one or reset to 0 if those days differ "SecondsSinceMidnight": number of seconds since the start of today / 10 "FromVersionFile": uses the build number from the version file "FromExternalApp": uses the output of an external application (needs RevisionAppPath and RevisionAppArgs). - MajorNumber: major number to use (not required, default is 1) - MinorNumber: minor number to use (not required, default is 0) - ReleaseStartDate: start date of the release (not required). Has to be in the MM/DD/YYYY format. - VersionFilePath: (not required) path to the file containing the version information. The file should only contain version, which should be in the format "M.m.b.r" (NOTE: build and release numbers are ignored) This information is used to extract the following: - major number - minor number - build number (only needed if "BuildNumberScheme" is set to "FromVersionFile") - release start date: labeller uses last modified time of the file as a release start date When VersionFilePath parameter is used, MajorNumber, MinorNumber and ReleaseStartDate are ignored. - Prefix: (not required, default is empty string) prefix for the label - RevisionAppPath: Path to external application (only needed if "RevisionNumberScheme" is set to "FromExternalApp") - RevisionAppArgs: Arguments passed to external application (only needed if "RevisionNumberScheme" is set to "FromExternalApp") Example of the CCNet labeller configuration block: <labeller type="BrekiLabeller"> <BuildNumberScheme>MonthDaySinceReleaseStart</BuildNumberScheme> <RevisionNumberScheme>DailyIncremental</RevisionNumberScheme> <VersionFilePath>ProjectVersion.txt</VersionFilePath> <MajorNumber>1</MajorNumber> <MinorNumber>1</MinorNumber> <ReleaseStartDate>07/18/2006</ReleaseStartDate> <Prefix>MyProject-</Prefix> </labeller> Example for a labeller which takes the build number from a file and uses an external application for the revision: <labeller type="BrekiLabeller"> <BuildNumberScheme>FromVersionFile</BuildNumberScheme> <RevisionNumberScheme>FromExternalApp</RevisionNumberScheme> <VersionFilePath>...somepath...\Version.txt</VersionFilePath> <RevisionAppPath>...somepath...\CvsCommitCount.exe</RevisionAppPath> <RevisionAppArgs>some arguments</RevisionAppArgs> </labeller>