GitHubRelease@0 — задача выпуска GitHub версии 0

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

Синтаксис

# GitHub Release v0
# Create, edit, or delete a GitHub release.
- task: GitHubRelease@0
  inputs:
    gitHubConnection: # string. Required. GitHub connection (OAuth or PAT). 
    repositoryName: '$(Build.Repository.Name)' # string. Required. Repository. Default: $(Build.Repository.Name).
    action: 'create' # 'create' | 'edit' | 'delete'. Required. Action. Default: create.
    #target: '$(Build.SourceVersion)' # string. Required when action = create || action = edit. Target. Default: $(Build.SourceVersion).
    tagSource: 'auto' # 'auto' | 'manual'. Required when action = create. Tag source. Default: auto.
    #tagPattern: # string. Optional. Use when tagSource = auto. Tag Pattern. 
    #tag: # string. Required when action = edit || action = delete || tagSource = manual. Tag. 
    #title: # string. Optional. Use when action = create || action = edit. Release title. 
    #releaseNotesSource: 'file' # 'file' | 'input'. Optional. Use when action = create || action = edit. Release notes source. Default: file.
    #releaseNotesFile: # string. Optional. Use when releaseNotesSource = file. Release notes file path. 
    #releaseNotes: # string. Optional. Use when releaseNotesSource = input. Release notes. 
    #assets: '$(Build.ArtifactStagingDirectory)/*' # string. Optional. Use when action = create || action = edit. Assets. Default: $(Build.ArtifactStagingDirectory)/*.
    #assetUploadMode: 'delete' # 'delete' | 'replace'. Optional. Use when action = edit. Asset upload mode. Default: delete.
    #isDraft: false # boolean. Optional. Use when action = create || action = edit. Draft release. Default: false.
    #isPreRelease: false # boolean. Optional. Use when action = create || action = edit. Pre-release. Default: false.
    #addChangeLog: true # boolean. Optional. Use when action = create || action = edit. Add changelog. Default: true.
  # Changelog configuration
    changeLogCompareToRelease: 'lastFullRelease' # 'lastFullRelease' | 'lastNonDraftRelease' | 'lastNonDraftReleaseByTag'. Required when addChangeLog = true. Compare to. Default: lastFullRelease.
    #changeLogCompareToReleaseTag: # string. Required when changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true. Release Tag. 
    changeLogType: 'commitBased' # 'commitBased' | 'issueBased'. Required when addChangeLog = true. Changelog type. Default: commitBased.
    #changeLogLabels: '[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]' # string. Optional. Use when changeLogType = issueBased && addChangeLog = true. Categories. Default: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

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

gitHubConnection - Подключение GitHub (OAuth или PAT)
string. Обязательный.

Указывает имя подключения службы GitHub, используемого для подключения к репозиторию GitHub. Подключение должно основываться на OAuth пользователя GitHub или личном маркере доступа GitHub. Дополнительные сведения о подключениях к службам см. в разделе Управление подключениями к службам.

repositoryName - Репозитория
string. Обязательный. Значение по умолчанию: $(Build.Repository.Name).

Указывает имя репозитория GitHub, в котором будет создан, изменен или удален выпуск GitHub.

action - Действий
string. Обязательный. Допустимые значения: create, edit, delete. Значение по умолчанию: create.

Указывает тип выполняемой операции освобождения. Эта задача может создавать, изменять или удалять выпуск GitHub.

target - Целевой
string. Требуется, если action = create || action = edit. Значение по умолчанию: $(Build.SourceVersion).

Указывает SHA фиксации, который вы хотите использовать для создания выпуска GitHub, например 48b11d8d6e92a22e3e9563a3f643699c16fd6e27. В этом поле также можно использовать переменную , например $(myCommitSHA).

tagSource - Источник тегов
string. Требуется, если action = create. Допустимые значения: auto (тег Git), manual (тег, указанный пользователем). Значение по умолчанию: auto.

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

tagPattern - Шаблон тега
string. Необязательный элемент. Используйте при tagSource = auto.

Указывает шаблон тега Git с помощью регулярного выражения, например release-v1.*. Выпуск GitHub будет создан только для фиксаций, имеющих соответствующий тег Git.

tag - Тег
string. Требуется, если action = edit || action = delete || tagSource = manual.

Указывает тег, который вы хотите использовать при создании, изменении или удалении выпуска. В этом поле также можно использовать переменную , например $(myTagName).

title - Название выпуска
string. Необязательный элемент. Используйте при action = create || action = edit.

Указывает заголовок выпуска GitHub. Если оставить его пустым, тег будет использоваться в качестве заголовка выпуска.

releaseNotesSource - Источник заметок о выпуске
string. Необязательный элемент. Используйте при action = create || action = edit. Допустимые значения: file (файл заметок о выпуске), input (встроенные заметки о выпуске). Значение по умолчанию: file.

Указывает описание выпуска GitHub. file Используйте параметр (файл заметок о выпуске), чтобы использовать содержимое файла в качестве заметок о выпуске. input Используйте параметр (Встроенные заметки о выпуске), чтобы вручную ввести заметки о выпуске.

releaseNotesFile - Путь к файлу заметок о выпуске
string. Необязательный элемент. Используйте при releaseNotesSource = file.

Указывает файл, содержащий заметки о выпуске.

releaseNotes - Заметки о выпуске
string. Необязательный элемент. Используйте при releaseNotesSource = input.

Указывает заметки о выпуске. Поддерживается Markdown.

assets - Активов
string. Необязательный элемент. Используйте при action = create || action = edit. Значение по умолчанию: $(Build.ArtifactStagingDirectory)/*.

Указывает файлы, которые нужно отправить в качестве ресурсов выпуска. Для указания нескольких файлов можно использовать подстановочные знаки. Например, используйте $(Build.ArtifactStagingDirectory)/*.zip для конвейеров сборки или для $(System.DefaultWorkingDirectory)/*.zip конвейеров выпуска.

Можно также указать несколько шаблонов, по одному на строку. По умолчанию будут отправлены $(Build.ArtifactStagingDirectory) все файлы в каталоге . Дополнительные сведения о списке доступных предварительно определенных переменных см. в разделе Переменные сборки и переменные выпуска.

assetUploadMode - Режим отправки ресурсов
string. Необязательный элемент. Используйте при action = edit. Допустимые значения: delete (Удалить существующие ресурсы), replace (Замените существующие ресурсы). Значение по умолчанию: delete.

Указывает режим отправки ресурсов, который вы хотите использовать. delete Используйте параметр (Удалить существующие ресурсы), чтобы сначала удалить все существующие ресурсы в выпуске, а затем отправить все ресурсы. replace Используйте параметр (Заменить существующие ресурсы), чтобы заменить все ресурсы с одинаковым именем.

isDraft - Выпуск черновика
boolean. Необязательный элемент. Используйте при action = create || action = edit. Значение по умолчанию: false.

Указывает, нужно ли сохранить выпуск в виде черновика (неопубликованного). Если falseзначение , выпуск будет опубликован.

isPreRelease - Предварительная версия
boolean. Необязательный элемент. Используйте при action = create || action = edit. Значение по умолчанию: false.

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

addChangeLog - Добавление журнала изменений
boolean. Необязательный элемент. Используйте при action = create || action = edit. Значение по умолчанию: true.

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

changeLogCompareToRelease - Сравните с
string. Требуется, если addChangeLog = true. Допустимые значения: lastFullRelease (Последний полный выпуск), lastNonDraftRelease (Последний выпуск, отличный от черновика), lastNonDraftReleaseByTag (Последний выпуск без черновика по тегу). Значение по умолчанию: lastFullRelease.

Указывает, с каким выпуском следует сравнить, чтобы создать журнал изменений:

• lastFullRelease (Последний полный выпуск): сравнивает текущий выпуск с самым последним выпуском, который не помечен как предварительный.
• lastNonDraftRelease (Последний выпуск, отличный от черновика). Сравнивает текущий выпуск с последним выпуском без черновика.
• lastNonDraftReleaseByTag (Последний выпуск, отличный от черновика по тегу): сравнивает текущий выпуск с последним выпуском без черновика, соответствующим указанному тегу. Вы также можете указать регулярное выражение вместо точного тега.

changeLogCompareToReleaseTag - Тег выпуска
string. Требуется, если changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true.

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

changeLogType - Тип журнала изменений
string. Требуется, если addChangeLog = true. Допустимые значения: commitBased (на основе фиксации), issueBased (на основе проблемы). Значение по умолчанию: commitBased.

Указывает тип журнала изменений. Журнал изменений может быть основан на фиксациях или проблемах. В журнале изменений на основе фиксаций перечислены все фиксации, включенные в выпуск. В журнале изменений на основе проблем перечислены все проблемы или запросы на вытягивание (PR), включенные в выпуск.

changeLogLabels - Категории
string. Необязательный элемент. Используйте при changeLogType = issueBased && addChangeLog = true. Значение по умолчанию: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

Классифицирует изменения на основе метки, связанной с проблемой или запросом на вытягивание. Для метки можно упоминание отображаемое имя категории и состояние проблемы. Примеры меток: "[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]". В случаях, когда изменение содержит несколько меток, приоритет имеет первая указанная метка. Оставьте это поле пустым, чтобы просмотреть плоский список проблем или запросы на запросы.

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

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

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

Нет.

Remarks

На GitHubRelease@1 доступна более новая версия этой задачи.

Требования

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