Projects settings (ccpy.conf)
Example config file
<ccpy>
<!-- *************************** CoolProduct version 2 *************************** -->
<project name="CoolProduct v2">
<failOnError>yes</failOnError>
<tasks>
<sourcecontrol type="git">
<url>https://company.com/repos/coolproductv2/Trunk/Import</url>
<workingDirectory>/CoolProductBuilds/Import</workingDirectory>
<preCleanWorkingDirectory>true</preCleanWorkingDirectory>
</sourcecontrol>
<sourcecontrol type="svn">
<url>https://company.com/repos/coolproductv2/Trunk/</url>
<workingDirectory>/CoolProductBuilds/SysInfra</workingDirectory>
</sourcecontrol>
<make>
<workingDirectory>/CoolProductBuilds/core</workingDirectory>
<args>clean release</args>
<timeout>140</timeout>
</make>
<make>
<workingDirectory>/CoolProductBuilds/ui</workingDirectory>
<args>clean release</args>
<timeout>140</timeout>
</make>
<make>
<workingDirectory>/CoolProductBuilds/tests</workingDirectory>
<args>cleanthis</args>
<timeout>20</timeout>
</make>
<exec>
<executable>coretests</executable>
<workingDirectory>/CoolProductBuilds/tests/coretests</workingDirectory>
<timeout>30</timeout>
</exec>
<exec>
<executable>taLoggingTests</executable>
<args>--xmlout</args>
<workingDirectory>/CoolProductBuilds/tests/uitests</workingDirectory>
<timeout>30</timeout>
<warningExitCode>2</warningExitCode>
</exec>
</tasks>
<emailNotification>
<from>buildserver@company.com</from>
<to>developer@company.com, buildmaster@company.com</to>
</emailNotification>
</project>
<!-- *************************** CoolProduct version 3 *************************** -->
<project name="CoolProduct v3">
<tasks>
<sourcecontrol type="svn">
<url>https://company.com/repos/coolproductv3/Trunk/Import</url>
<workingDirectory>/CoolProductBuilds/Import</workingDirectory>
</sourcecontrol>
<sourcecontrol type="svn">
<url>https://company.com/repos/coolproductv3/Trunk/</url>
<workingDirectory>/CoolProductBuilds/SysInfra</workingDirectory>
</sourcecontrol>
<make>
<workingDirectory>/CoolProductBuildsv3/core</workingDirectory>
<args>clean release</args>
</make>
</tasks>
<emailNotification>
<from>buildserver@company.com</from>
<to>buildmaster@company.com</to>
<format>attachment</format>
<server>smtp.mail.com</server>
<port>2525</port>
<username>tom</username>
<password>secret</password>
</emailNotification>
</project>
</ccpy>
Elements description
Projects config file contains the ordered list of projectsts, each project contains the ordered list of tasks.
The following task types are supported: "svn", "make" and "execute".
| Node | Parent element | Description | Type | Default | Required | Notes |
|---|
| project | ccpy | Project settings element | Element with project name attribute and subelements | N/A | no | |
| name | attribute of project | Project name | string | N/A | yes | |
| sourcecontrol | tasks | Source control settings element | Element with sourcecontrol type attribute and subelements | N/A | no | |
| type | attribute of sourcecontrol | Source control type | string. Supported source control types are "svn" and "git" | N/A | yes | |
| url | sourcecontrol | URL of the remote repository (checkout URL for subversion, clone URL for git) | string | N/A | yes | |
| workingDirectory | sourcecontrol | Directory holding local checkout | string | current directory | no | |
| preCleanWorkingDirectory | sourcecontrol | Clean working directory before checking out | boolean (on/yes/true or off/no/false) | no | no | |
| make | tasks | make settings element used to execute makefiles | Element with subelements | N/A | no | |
| workingDirectory | make | The working directory for make | string | current directory | no | |
| args | make | make arguments | string | empty | no | |
| timeout | make | Number of seconds to wait before assuming that the make has hung and should be killed | Non-negative integer | 600 (10 minutes) | no | |
| exec | tasks | Element used to launch executables | Element with subelements | N/A | no | |
| executable | exec | Executable to launch. | string | no | yes | |
| args | exec | Executable arguments | string | empty | no | |
| workingDirectory | exec | The working directory for the executable | string | current directory | no | |
| timeout | exec | Number of seconds to wait before assuming that the executable has hung and should be killed | Non-negative integer | 600 (10 minutes) | no | |
| warningExitCode | exec | by default executable exit code 0 render the build as successful and <>0 is considered as failed build. You can use this tag to specify extra exit code that still renders the build successful but set status to "WARNING" instead of "OK" | integer | N/A | no | |
| emailNotification | project | Contains settings for sending email notifications with integration results | Element with subelements | N/A | no | |
| from | emailNotification | Sender's email address | string | empty | no | |
| to | emailNotification | Contains correspondents to receive email notifications with integration results | Comma-separated list of strings | empty | no | |
| format | emailNotification | Email format for build results | String: 'attachment', 'html' or 'plain' | 'attachment' | no | |
| attachment | emailNotification | Path to the file to attach to the email report. Can be more than one. Notice that it is not related to the format the build results are emailed with. | no | |
| server | emailNotification | SMTP server host | string | 'localhost' | no | |
| port | emailNotification | SMTP server port | integer | 25 | no | |
| username | emailNotification | SMTP server username | string | Not supplied | no | |
| password | emailNotification | SMTP server password | string | Not supplied | no | |
