cURL Upload Files task

Azure Pipelines | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015

Use this task in a build or release pipeline to use cURL to upload files with supported protocols such as FTP, FTPS, SFTP, HTTP, and more.



YAML snippet

# cURL upload files
# Use cURL's supported protocols to upload files
- task: cURLUploader@2
    #authType: 'ServiceEndpoint' # Optional. Options: serviceEndpoint, userAndPass
    #serviceEndpoint: # Required when authType == ServiceEndpoint
    #username: # Optional
    #password: # Optional
    #url: # Required when authType == UserAndPass
    #remotePath: 'upload/$(Build.BuildId)/' # Optional
    #options: # Optional
    #redirectStderr: true # Optional


Argument Description

If you want to upload a single file, click the ... button and select the file.

If you want to upload multiple files, specify a minimatch pattern filter. For example, specify ***.zip to upload all ZIP files in all sub-folders.

Username Specify the username for server authentication.

Specify the password for server authentication.

Important: Use a secret variable to avoid exposing this value.

URL to the location where you want to upload the files. If you are uploading to a folder, make sure to end the argument with a trailing slash.

Acceptable URL protocols include DICT://, FILE://, FTP://, FTPS://, GOPHER://, HTTP://, HTTPS://, IMAP://, IMAPS://, LDAP://, LDAPS://, POP3://, POP3S://, RTMP://, RTSP://, SCP://, SFTP://, SMTP://, SMTPS://, TELNET://, and TFTP://.

Optional Arguments Arguments to pass to cURL.
Redirect Standard Error to Standard Out

In most cases you should leave this selected.

Select if you want to add --stderr - as an argument to cURL. Otherwise, if you clear this check box, cURL will write its progress bar to stderr, which is interpreted by the build pipeline as error output, which could cause the build to fail.

Control options

Open source

This task is open source on GitHub. Feedback and contributions are welcome.

Q & A

Where can I learn more about file matching patterns?

File matching patterns reference

Where can I learn FTP commands?

List of raw FTP commands

Do I need an agent?

You need at least one agent to run your build or release. Get an agent for Linux, macOS, or Windows.

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

See Troubleshoot Build and Release.

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

See Agent pools.

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

Some of these features are available only on Azure Pipelines and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.