CruiseControl.NET : Ftp task - Publisher
This page last changed on Nov 30, 2010 by ccnet-doc-gen.
FTP Task / Publisher
The ftp task / publisher allows to download or upload files/ folders, for example, uploading a new version of a web page to ftp site of an ISP.
Version
Available from version 1.5
Examples
<ftp> <serverName>ftp.isp.com</serverName> <userName>john</userName> <password>doe</password> <action>UploadFolder</action> <ftpFolderName>site/config</ftpFolderName> <localFolderName>d:\website\config</localFolderName> <recursiveCopy>true</recursiveCopy> </ftp>
Configuration Elements
| Element | Description | Type | Required | Default | Version |
|---|---|---|---|---|---|
| action | The action to perform. | String - one of:
|
No | DownloadFolder | 1.5 |
| description | Description used for the visualisation of the buildstage, if left empty the process name will be shown. | String | No | The task/publisher name. | 1.5 |
| dynamicValues | The dynamic values to use for the task. | Dynamic Values array | No | None | 1.5 |
| environment | A set of environment variables set for commands that are executed. Each variable should be specified as <variable name="name" value="value" />
. |
Environment Variable array | No | ||
| ftpFolderName | The path to the folder to use on the FTP server. | String | Yes | n/a | 1.5 |
| localFolderName | The to the folder to use on the local machine. | String | Yes | n/a | 1.5 |
| password | The password to use. | String | Yes | n/a | 1.5 |
| recursiveCopy | Whether to perform a recursive copy or not. | Boolean | No | true | 1.5 |
| serverName | The name of the server to connect to. | String | Yes | n/a | 1.5 |
| timeDifference | Time difference between server and client (relative to client) in hours. | Int32 | No | 0 | 1.6 |
| useActiveConnectionMode | Whether to use active connection mode or not. | Boolean | No | true | 1.5 |
| userName | The username to log in with. | String | Yes | n/a | 1.5 |
Notes
| Label | Description | Example | Version |
|---|---|---|---|
| CCNetBuildCondition | The condition used to trigger the build, indicating if the build was triggered by new modifications or if it was forced. Legal values are: "IfModificationExists" or "ForceBuild" | ForceBuild | |
| CCNetIntegrationStatus | The status of the current integration. Could be Success, Failure, Exception or Unknown | Success | |
| CCNetLabel | The label used to identify the CCNet build. This label is generated by the CCNet labeller. | 1.0.2.120 | |
| CCNetLastIntegrationStatus | The status of the previous integration. Could be Success, Failure, Exception or Unknown | Success | |
| CCNetProject | The name of the CCNet project that is being integrated. | MyProject | |
| CCNetBuildDate | The date of the build (in yyyy-MM-dd format) | 2005-08-10 | |
| CCNetBuildTime | The time of the start of the build (in HH:mm:ss format) | 08:45:12 | |
| CCNetArtifactDirectory | The project artifact directory (as an absolute path) | c:\program files\CruiseControl.NET\Server\MyProject\Artifacts | |
| CCNetWorkingDirectory | The project working directory (as an absolute path) | c:\program files\CruiseControl.NET\Server\MyProject\WorkingDirectory | |
| CCNetRequestSource | The source of the integration request; this will generally be the name of the trigger that raised the request. | IntervalTrigger | 1.1.0 |
| CCNetFailureUsers | The list of users who have contributed modifications to a sequence of builds that has failed. | John, Smith |
|
| CCNetListenerFile | Viewing build progress with Nant and MSBuild | c:\Project\Artifact\listener.xml | 1.4.0 |
| CCNetProjectUrl | The URL where the project is located | http://myhost/ccnet/server/ | |
| CCNetNumericLabel | Contains the label as an integer if conversion is possible, otherwise zero. | 1 | |
| CCNetModifyingUsers |
The list of users who have contributed to the current build only |
Smith | |
| CCNetUser | The user who forced the build. If security is off, or the build is not forced, then this will not be set. | John Doe | 1.5.0 |
 | Automatically Generated Documentation generated on Tuesday, 30 Nov 2010 at 10:25:50 AM |
