DownloadSecureFile@1. Скачивание задачи безопасного файла версии 1

Статья
03/24/2025

Используйте эту задачу для скачивания защищенного файла на компьютер агента.

Синтаксис

# 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.

Входные данные

secureFile - безопасный файл
string. Обязательное.

Указывает имя или уникальный идентификатор (GUID) защищенного файла, скачаемого на компьютер агента. Файл удаляется после завершения задания конвейера.

retryCount - число повторных попыток
string. Значение по умолчанию: 8.

Необязательно. Указывает количество повторных попыток скачивания безопасного файла, если скачивание завершается ошибкой.

retryCount - число повторных попыток
string. Значение по умолчанию: 5.

время ожидания сокетаsocketTimeout -
string.

Необязательно. При скачивании защищенного запроса на файл в Корпорации Майкрософт этот вход указывает время ожидания для сокета.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Эта задача определяет следующие выходные переменные, которые можно использовать в подчиненных шагах, заданиях и этапах.

secureFilePath
Указывает расположение скачаемого защищенного файла.

Замечания

Используйте эту задачу в конвейере, чтобы скачать безопасный файл на компьютер агента. При указании имени файла (с помощью входных данных secureFile) используйте имя, указанное при отправке файла, а не фактическое имя файла.

Примечание.

Эта задача выполняется в начале своего этапа независимо от того, где она находится в пределах его задания.

После скачивания используйте значение name, заданное в задаче (или "Имя ссылки" в классическом редакторе), чтобы ссылаться на путь к защищенному файлу на компьютере агента. Например, если задаче присвоено имя mySecureFile, его путь можно указать в конвейере как $(mySecureFile.secureFilePath). Кроме того, скачанные защищенные файлы можно найти в каталоге, указанном $(Agent.TempDirectory). Полный пример ниже.

Когда задание конвейера завершится, завершается ли оно успешно, завершается сбоем или отменяется, безопасный файл удаляется из его расположения загрузки.

Эту задачу не нужно использовать с установить сертификат Apple или установить профиль подготовки Apple, так как они автоматически загружают, устанавливают и удаляют (в конце задания конвейера) безопасный файл.

Эта задача в настоящее время поддерживает только одну задачу файла на экземпляр.

Примеры

В этом примере скачивает файл защищенного сертификата и устанавливает его в каталог доверенного центра сертификации (ЦС) в Linux:

- 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/

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Эта задача выполняется с помощью следующих ограничений команд : ограничено.
переменные settable	Эта задача имеет разрешение на задать следующие переменные: secureFilePath
Версия агента	2.182.1 или более поздней версии
Категория задач	Полезность

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	2.116.0 или более поздней версии
Категория задач	Полезность

Поделиться через