-
Notifications
You must be signed in to change notification settings - Fork 225
/
Build Publisher.html
104 lines (92 loc) · 5.4 KB
/
Build Publisher.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>CruiseControl.NET : Build Publisher</title>
<link rel="stylesheet" href="styles/site.css" type="text/css" />
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
<tr>
<td valign="top" class="pagebody">
<div class="pageheader">
<span class="pagetitle">
CruiseControl.NET : Build Publisher
</span>
</div>
<div class="pagesubheading">
This page last changed on Aug 08, 2008 by <font color="#0050B2">williams</font>.
</div>
<p>The <b>Build Publisher</b> lets you copy any arbitrary files on a <b>successful</b> build.<br/>
You can set alwaysPublish to true, if you want the copy always to happen.</p>
<h4><a name="BuildPublisher-Example"></a>Example</h4>
<p><br clear="all" />
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag"><buildpublisher></span>
<span class="code-tag"><sourceDir></span>C:\myprojects\project1<span class="code-tag"></sourceDir></span>
<span class="code-tag"><publishDir></span>\\myfileserver\project1<span class="code-tag"></publishDir></span>
<span class="code-tag"><useLabelSubDirectory></span>false<span class="code-tag"></useLabelSubDirectory></span>
<span class="code-tag"><alwaysPublish></span>false<span class="code-tag"></alwaysPublish></span>
<span class="code-tag"></buildpublisher></span></pre>
</div></div><br clear="all" />
<br clear="all" /></p>
<p>This will copy the contents of <b>C:\myprojects\project1</b> to the network share <b>\\myfileserver\project1</b>.</p>
<p><b>Minimal Configuration Example</b></p>
<p><div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag"><buildpublisher /></span></pre>
</div></div><br clear="all" />
<br clear="all" /></p>
<p>This will copy the contents of the project's working directory to a new label subdirectory under the project's artifact directory (i.e. <artifact_dir>\<label_dir>)</p>
<h4><a name="BuildPublisher-ConfigurationElements%3A"></a>Configuration Elements:</h4>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Node </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Required </th>
<th class='confluenceTh'> Default </th>
</tr>
<tr>
<td class='confluenceTd'> sourceDir </td>
<td class='confluenceTd'> The source directory to copy files from. This path can be absolute or can be relative to the project's working directory. If unspecified, the project's working directory will be used as the source directory. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> n/a </td>
</tr>
<tr>
<td class='confluenceTd'> publishDir </td>
<td class='confluenceTd'> The directory to copy the files to. This path can be absolute or can be relative to the project's artifact directory. If <b>useLabelSubDirectory</b> is true (default) a subdirectory with the current build's label will be created, and the contents of sourceDir will be copied to it. If unspecified, the project's artifact directory will be used as the publish directory. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> n/a </td>
</tr>
<tr>
<td class='confluenceTd'> useLabelSubDirectory </td>
<td class='confluenceTd'> If set to true (the default value), files will be copied to subdirectory under the publishDir which will be named with the label for the current integration. </td>
<td class='confluenceTd'> bool </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> true </td>
</tr>
<tr>
<td class='confluenceTd'> alwaysPublish </td>
<td class='confluenceTd'> always copies the files, regardless of the state of the build <br clear="all" /> </td>
<td class='confluenceTd'> bool <br clear="all" /> </td>
<td class='confluenceTd'> false <br clear="all" /> </td>
<td class='confluenceTd'> false <br clear="all" /> </td>
</tr>
</tbody></table>
<p><img class="emoticon" src="images/icons/emoticons/information.gif" height="16" width="16" align="absmiddle" alt="" border="0"/> This block used to support an 'additionalDir' attribute. This feature has been removed - just use multiple <tt><buildpublisher></tt> blocks to achieve the same job.<br/>
<img class="emoticon" src="images/icons/emoticons/information.gif" height="16" width="16" align="absmiddle" alt="" border="0"/> The <b>useLabelSubDirectory</b> property has been added in 1.2.</p>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
</tr>
<tr>
<td align="center"><font color="grey">Document generated by Confluence on Dec 13, 2008 00:16</font></td>
</tr>
</table>
</body>
</html>