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


JenkinsDownloadArtifacts@2 - Jenkins скачать артефакты v2 задача

Скачайте артефакты, созданные заданием Jenkins.

Замечание

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

Синтаксис

# Jenkins download artifacts v2
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@2
  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. Чтобы создать его, нажмите на ссылку Управление и создайте новое подключение к службе 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. Чтобы скачать все файлы в artifact drop, используйте drop/**.

.


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

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


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

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


artifactDetailsFileNameSuffix - Имя файла фиксации и рабочего элемента
string. Необязательно. Используется при downloadCommitsAndWorkItems == invalid.

Необязательный суффикс имени файла для фиксаций и вложений рабочих элементов. Вложения будут создаваться с.json commits_{суффикс} и workitem_{суффикс}.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 для артефактов.

Замечание

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


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

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


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

Имя контейнера в учетной записи хранения, в который загружаются артефакты.


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

Путь к артефактам внутри контейнера хранилища Azure.


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

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

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

Нет.

Замечания

Настройка Azure RBAC для доступа к хранилищу Azure

В этой версии задачи используется подключение к службе Azure Resource Manager , настроенное с помощью федерации удостоверений рабочей нагрузки и Azure RBAC для подключения к хранилищу Azure вместо ключей учетных записей хранения или подписанных URL-адресов общего доступа (SAS). Чтобы подключиться к хранилищу Azure из этой задачи, необходимо назначить роль участника данных BLOB-объектов хранилища в учетной записи хранения удостоверению подключения к службе, настроенного для ConnectedServiceNameARM. Дополнительные сведения см. в статьях Назначение роли Azure для доступа к данным BLOB-объектов и Действия по назначению роли.

Требования

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