FtpUpload@1 - FTP 上传 v1 任务
使用此任务可以使用 FTP 将文件上传到远程计算机,或者通过 FTPS 安全地上传文件。
此版本的任务已弃用;使用 FtpUpload@2。
使用此任务可以使用 FTP 将文件上传到远程计算机,或者通过 FTPS 安全地上传文件。
语法
# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
inputs:
credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection.
#serverUrl: # string. Required when credsType = inputs. Server URL.
#username: # string. Required when credsType = inputs. Username.
#password: # string. Required when credsType = inputs. Password.
rootDirectory: # string. Alias: rootFolder. Required. Root folder.
filePatterns: '**' # string. Required. File patterns. Default: **.
remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
# Advanced
#clean: false # boolean. Delete remote directory. Default: false.
#cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
#overwrite: true # boolean. Overwrite. Default: true.
#preservePaths: false # boolean. Preserve file paths. Default: false.
#trustSSL: false # boolean. Trust server certificate. Default: false.
输入
credentialsOption
-
身份验证方法
输入别名:credsType
。
string
。 必填。 允许的值:serviceEndpoint
(FTP 服务连接)、inputs
(输入凭据)。 默认值:serviceEndpoint
。
指定身份验证方法。 使用 FTP 服务连接或输入连接凭据。
serverEndpoint
-
FTP 服务连接
string
。
credsType = serviceEndpoint
时是必需的。
指定 FTP 服务器的服务连接。 若要创建一个,请单击“管理”链接并创建新的通用服务连接,然后输入服务器 URL 的 FTP 服务器 URL,例如 ftp://server.example.com
和所需的凭据。
如果目标服务器支持 FTPS,无论指定的协议(ftp://
或 ftps://
),都会始终建立安全连接。 若要仅允许安全连接,请使用 ftps://
协议,例如 ftps://server.example.com
。 如果指定了 ftps://
,则与不支持 FTPS 的服务器的连接将失败。
serverUrl
-
服务器 URL
string
。
credsType = inputs
时是必需的。
指定 FTP 服务器的 URL。
username
-
用户名
string
。
credsType = inputs
时是必需的。
指定 FTP 连接的用户名。
password
-
密码
string
。
credsType = inputs
时是必需的。
指定 FTP 连接的密码。
rootDirectory
-
根文件夹
输入别名:rootFolder
。
string
。 必填。
指定要从中上传文件的源文件夹。
remoteDirectory
-
远程目录
输入别名:remotePath
。
string
。 必填。 默认值:/upload/$(Build.BuildId)/
。
指定任务上传文件的远程 FTP 服务器上的目录。
clean
-
删除远程目录
boolean
。 默认值:false
。
在上传之前删除远程目录,包括其内容。
cleanContents
-
清除远程目录内容
boolean
。 可选。 当 clean = false
时使用。 默认值:false
。
在上传之前,以递归方式删除远程目录中的所有内容。 不会删除现有目录。 为了获得更好的性能,请改用 clean
。
overwrite
-
覆盖
boolean
。 默认值:true
。
覆盖远程目录中的现有文件。
preservePaths
-
保留文件路径
boolean
。 默认值:false
。
如果选择,则会在上传文件的远程目录下重新创建相对本地目录结构。 否则,文件将直接上传到远程目录,而无需创建其他子目录。
例如,假设源文件夹 /home/user/source/
,其中包含文件 foo/bar/foobar.txt
,远程目录为:/uploads/
。 如果选择此布尔值,文件将上传到 /uploads/foo/bar/foobar.txt
。 如果未选择此布尔值,文件将上传到 /uploads/foobar.txt
。
trustSSL
-
信任服务器证书
boolean
。 默认值:false
。
信任具有 ftps://
的 FTP 服务器的 SSL 证书,即使它是自签名证书,也不能由证书颁发机构(CA)验证。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。
注解
使用此任务可以使用 FTP 将文件上传到远程计算机,或者通过 FTPS 安全地上传文件。
注释
FtpUpload@2中提供了此任务的较新版本。