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


JenkinsDownloadArtifacts@1 — задача Jenkins download artifacts версии 1

Используйте эту задачу для скачивания артефактов, созданных заданием Jenkins.

Синтаксис

# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.
# Jenkins Download Artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

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

jenkinsServerConnection - Подключение службы Jenkins
Входной псевдоним: serverEndpoint. string. Обязательный.

Указывает подключение службы для экземпляра Jenkins. Чтобы создать подключение к службе, щелкните ссылку Управление.


jobName - Имя задания
string. Обязательный.

Указывает имя задания Jenkins для скачивания артефактов. Это должно точно соответствовать имени задания на сервере Jenkins.


jenkinsJobType - Тип задания Jenkins
string. Необязательный элемент. Используйте при jobName = invalidjobName.

Автоматически задает тип задания Jenkins.


saveTo - Сохранить в
string. Обязательный. Значение по умолчанию: jenkinsArtifacts.

Указывает каталог, в который загружаются и сохраняются артефакты Jenkins. Этот каталог создается, если он не существует.


jenkinsBuild - Скачивание артефактов, созданных
string. Обязательный. Допустимые значения: LastSuccessfulBuild (последняя успешная сборка), BuildNumber (номер сборки). Значение по умолчанию: LastSuccessfulBuild.

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


jenkinsBuildNumber - Номер сборки Jenkins
string. Требуется при .jenkinsBuild == BuildNumber Значение по умолчанию: 1.

Скачивает артефакты, созданные этой сборкой.


itemPattern - Шаблон элемента
string. Значение по умолчанию: **.

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

Шаблон по умолчанию ** скачивает все файлы по всем артефактам, созданным заданием Jenkins. Чтобы скачать все файлы в перетаскивающемся артефакте, используйте .drop/**


downloadCommitsAndWorkItems - Скачивание фиксаций и рабочих параметров
boolean. Значение по умолчанию: false.

Включает скачивание фиксаций и сведений о рабочем элементе, связанных с заданием Jenkins.


startJenkinsBuildNumber - Скачивание фиксаций и рабочих элементов из
string. Необязательный элемент. Используйте при downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

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


artifactDetailsFileNameSuffix - Commit и WorkItem FileName
string. Необязательный элемент. Используйте при downloadCommitsAndWorkItems == invalid.

Указывает суффикс имени файла для фиксаций и вложений рабочих элементов. Вложения создаются с помощью commits_{suffix}.json и workitem_{suffix}.json. Если этот вход не указан, создаются вложения с именами commits.json и workitems.json.


propagatedArtifacts - Артефакты распространяются в Azure
boolean. Значение по умолчанию: false.

Используйте эти входные данные, если артефакты Jenkins были распространены в Azure. Сведения об отправке артефактов Jenkins в Azure см. в этом подключаемом модуле Jenkins.


artifactProvider - Поставщик артефактов
string. Требуется при .propagatedArtifacts == notValid Допустимые значения: azureStorage (служба хранилища Azure). Значение по умолчанию: azureStorage.

Указывает внешнего поставщика хранилища, используемого в задании Jenkins для отправки артефактов.


ConnectedServiceNameARM - Подписка Azure
string. Требуется при .propagatedArtifacts == true

Указывает подписку Azure Resource Manager для артефактов.


storageAccountName - Имя учетной записи хранения
string. Требуется при .propagatedArtifacts == true

Указывает классическую или Resource Manager учетные записи хранения Azure. Выберите имя учетной записи хранения, в которой распространяются артефакты.


containerName - Имя контейнера
string. Требуется при .propagatedArtifacts == true

Указывает имя контейнера в учетной записи хранения, куда отправляются артефакты.


commonVirtualPath - Общий виртуальный путь
string. Необязательный элемент. Используйте при propagatedArtifacts == true.

Указывает путь к артефактам в контейнере службы хранилища Azure.


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

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

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

Нет.

Remarks

Используйте эту задачу для скачивания артефактов, созданных заданием Jenkins.

Требования

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