Utility: FTP Upload

Last Update: 3/6/2017

Team Services | TFS 2017 | Previous versions: XAML Build, Release

Upload files to a remote machine using the File Transfer Protocol (FTP), or securely with FTPS.

Demands

None

Arguments

Argument Description
FTP Service Endpoint

Select the service endpoint for your FTP server. To create one, click the Manage link and create a new Generic Service Endpoint, enter the FTP server URL for the server URL, e.g. ftp://server.example.com, and required credentials.

Secure connections will always be made regardless of the specified protocol (ftp:// or ftps://) if the target server supports FTPS. To allow only secure connections, use the ftps:// protocol, e.g. ftps://server.example.com. Connections to servers not supporting FTPS will fail if ftps:// is specified.

Source folder The source folder to upload files from. The default file path is relative from the root folder of the repo (same as if you had specified $(Build.SourcesDirectory)).
File patterns File paths or patterns of the files to upload. Supports multiple lines of match patterns. To upload the entire folder content recursively, specify **.
Remote directory Upload files to this directory on the remote FTP server.
Clean remote directory Recursively delete all contents of the remote directory before uploading.
Overwrite Overwrite existing files in the remote directory.
Trust server certificate Selecting this option results in the FTP server's SSL certificate being trusted with ftps://, even if it is self-signed or cannot be validated by a Certificate Authority (CA).
Control options

Q & A

Where can I learn more about file matching patterns?

File matching patterns reference

Q: I'm having problems. How can I troubleshoot them?

A: Try this:

  1. On the variables tab, add system.debug and set it to true. Select to allow at queue time.

  2. In the explorer tab, view your completed build and click the build step to view its output.

The control options arguments described above can also be useful when you're trying to isolate a problem.

Q: How do variables work? What variables are available for me to use in the arguments?

A: $(Build.SourcesDirectory) and $(Agent.BuildDirectory) are just a few of the variables you can use. See Variables.

Do I need an agent?

You need at least one agent to run your build or release. Get an agent.

I can't select a default agent queue and I can't queue my build or release. How do I fix this?

See queues.

I use Team Foundation Server on-premises and I don't see some of these features. Why not?

Some of these features are available only on Visual Studio Team Services and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.