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

Статья
07/02/2024

Используйте эту задачу, чтобы скачать безопасный файл на компьютер агента.

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

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

Синтаксис

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

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

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

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

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

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

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
Требования	Нет
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные	Эта задача имеет разрешение на задание следующих переменных: secureFilePath
Версия агента	2.182.1 или более поздней версии
Категория задач	Служебная программа

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

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