cURLUploader@2 - cURL Upload Files v2 task

Artikkeli
07/02/2024

Use this task with cURL to upload files. Supported data transfer protocols include FTP, FTPS, SFTP, HTTP, and others.

Use cURL to upload files.

Syntax

# cURL Upload Files v2
# Use cURL's supported protocols to upload files.
- task: cURLUploader@2
  inputs:
    files: # string. Required. Files. 
    #authType: 'ServiceEndpoint' # 'ServiceEndpoint' | 'UserAndPass'. Authentication Method. Default: ServiceEndpoint.
    serviceEndpoint: # string. Required when authType = ServiceEndpoint. Service Connection. 
    #username: # string. Optional. Use when authType = UserAndPass. Username. 
    #password: # string. Optional. Use when authType = UserAndPass. Password. 
    #url: # string. Required when authType = UserAndPass. URL. 
    #remotePath: 'upload/$(Build.BuildId)/' # string. Remote Directory. Default: upload/$(Build.BuildId)/.
    #options: # string. Optional Arguments. 
  # Advanced
    #redirectStderr: true # boolean. Redirect Standard Error to Standard Out. Default: true.

# cURL Upload Files v2
# Use cURL to upload files.
- task: cURLUploader@2
  inputs:
    files: # string. Required. Files. 
    #authType: 'ServiceEndpoint' # 'ServiceEndpoint' | 'UserAndPass'. Authentication Method. Default: ServiceEndpoint.
    serviceEndpoint: # string. Required when authType = ServiceEndpoint. Service Connection. 
    #username: # string. Optional. Use when authType = UserAndPass. Username. 
    #password: # string. Optional. Use when authType = UserAndPass. Password. 
    #url: # string. Required when authType = UserAndPass. URL. 
    #remotePath: 'upload/$(Build.BuildId)/' # string. Remote Directory. Default: upload/$(Build.BuildId)/.
    #options: # string. Optional Arguments. 
  # Advanced
    #redirectStderr: true # boolean. Redirect Standard Error to Standard Out. Default: true.

Inputs

files - Files
string. Required.

File(s) to be uploaded. Wildcards can be used. For example, **/*.zip for all ZIP files in all subfolders.

authType - Authentication Method
string. Allowed values: ServiceEndpoint (Service connection), UserAndPass (Username and password). Default value: ServiceEndpoint.

Specifies the authentication method for server authentication.

serviceEndpoint - Service Connection
string. Required when authType = ServiceEndpoint.

Specifies the service connection with the credentials for the server authentication. Use the Generic service connection type for the service connection.

username - Username
string. Optional. Use when authType = UserAndPass.

Specifies the username for server authentication.

password - Password
string. Optional. Use when authType = UserAndPass.

Specifies the password for server authentication. Use a new build variable with its lock enabled on the Variables tab to encrypt this value. Use a secret variable to avoid exposing ths value.

url - URL
string. Required when authType = UserAndPass.

Specifies the URL to where the file(s) will be uploaded. The directory should end with a trailing slash. Possible 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://.

remotePath - Remote Directory
string. Default value: upload/$(Build.BuildId)/.

Optional. Specifies the sub-folder on the remote server for the URL supplied in the credentials.

options - Optional Arguments
string.

Optional. The additional arguments that will be passed to cURL.

redirectStderr - Redirect Standard Error to Standard Out
boolean. Default value: true.

Adds --stderr - as an argument to cURL. By default, cURL writes its progress bar to stderr, which is interpreted by the build as error output. Enabling this checkbox suppresses that behavior.

Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

Use this task to use cURL to upload files with supported protocols such as FTP, FTPS, SFTP, HTTP, and more.

Where can I learn more about file matching patterns?

File matching patterns reference

Where can I learn FTP commands?

List of raw FTP commands

Requirements

Requirement	Description
Pipeline types	YAML, Classic build, Classic release
Runs on	Agent, DeploymentGroup
Demands	None
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	This task runs using the following command restrictions: restricted
Settable variables	This task has permission to set the following variables: Setting variables is disabled
Agent version	2.182.1 or greater
Task category	Utility

Requirement	Description
Pipeline types	YAML, Classic build, Classic release
Runs on	Agent, DeploymentGroup
Demands	None
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	Any
Settable variables	Any
Agent version	All supported agent versions.
Task category	Utility

Requirement	Description
Pipeline types	YAML, Classic build, Classic release
Runs on	Agent, DeploymentGroup
Demands	Self-hosted agents must have capabilities that match the following demands to run jobs that use this task: curl
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	Any
Settable variables	Any
Agent version	All supported agent versions.
Task category	Utility

Jaa