DownloadSecureFile@1 - 下载安全文件 v1 任务
使用此任务将安全文件下载到代理计算机。
使用此任务将安全文件下载到代理计算机上的临时位置。
使用此任务将安全文件下载到生成或发布代理上的临时位置。
语法
# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
inputs:
secureFile: # string. Required. Secure File.
#retryCount: '8' # string. Retry Count. Default: 8.
#socketTimeout: # string. Socket Timeout.
# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
inputs:
secureFile: # string. Required. Secure File.
#retryCount: '5' # string. Retry Count. Default: 5.
# Download secure file v1
# Download a secure file to a temporary location on the agent machine.
- task: DownloadSecureFile@1
inputs:
secureFile: # string. Required. Secure File.
# Download Secure File v1
# Download a secure file to a temporary location on the build or release agent.
- task: DownloadSecureFile@1
inputs:
secureFile: # string. Required. Secure File.
输入
secureFile - 安全文件
string. 必需。
指定下载到代理计算机的安全文件 (GUID) 的名称或唯一标识符。 管道作业完成后，文件将被删除。
retryCount - 重试计数
string. 默认值：8。
可选。 指定在下载失败时重试下载安全文件的次数。
retryCount - 重试计数
string. 默认值：5。
可选。 指定在下载失败时重试下载安全文件的次数。
socketTimeout - 套接字超时
string.
可选。 在 Microsoft 中下载安全文件请求时，此输入指定套接字的超时。
任务控件选项
除任务输入外，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。
输出变量
此任务定义以下 输出变量，可在下游步骤、作业和阶段中使用。
secureFilePath
指定已下载的安全文件的位置。
注解
在管道中使用此任务将 安全文件 下载到代理计算机。 使用 secureFile 输入) 指定 (文件的名称时，请使用上传时指定的名称，而不是实际文件名。
下载后，使用 name 在经典编辑器) 中对任务设置的值 (或“引用名称”来引用代理计算机上的安全文件的路径。 例如，如果为任务指定了名称 mySecureFile，则可以在管道中将其路径引用为 $(mySecureFile.secureFilePath)。 或者，可以在 给定 $(Agent.TempDirectory)的目录中找到下载的安全文件。 请参阅 下面的完整示例。
管道作业完成后，无论它是成功、失败还是取消，都会从其下载位置删除安全文件。
无需将此任务与 “安装 Apple 证书” 或 “安装 Apple 预配配置文件 ”任务一起使用，因为它们会在管道作业结束时自动下载、安装和删除 (，) 安全文件。
此任务目前仅支持每个实例一个文件任务。
示例
本示例下载一个安全证书文件，并将其安装到 Linux 上的 CA) 目录 (受信任的证书颁发机构：
- task: DownloadSecureFile@1
name: caCertificate
displayName: 'Download CA certificate'
inputs:
secureFile: 'myCACertificate.pem'
- script: |
echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
sudo chown root:root $(caCertificate.secureFilePath)
sudo chmod a+r $(caCertificate.secureFilePath)
sudo ln -s $(caCertificate.secureFilePath) /etc/ssl/certs/