GitHubRelease@0 - GitHub Release v0 任务

使用此任务创建、编辑或删除 GitHub 版本。

此版本的任务已弃用;使用 GitHubRelease@1。

使用此任务创建、编辑或删除 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 服务连接的名称。 连接必须基于 GitHub 用户的 OAuth 或 GitHub 个人访问令牌。 有关服务连接的详细信息，请参阅 管理服务连接。

repositoryName - 存储库
string。 必填。 默认值：$(Build.Repository.Name)。

指定要在其中创建、编辑或删除 GitHub 版本的 GitHub 存储库的名称。

action - 操作
string。 必填。 允许的值：create、edit、delete。 默认值：create。

指定要执行的发布作的类型。 此任务可以创建、编辑或删除 GitHub 版本。

target - 目标
string。 action = create || action = edit时是必需的。 默认值：$(Build.SourceVersion)。

指定要用于创建 GitHub 版本的提交 SHA，例如 48b11d8d6e92a22e3e9563a3f643699c16fd6e27。 还可以在此字段中使用变量（如 $(myCommitSHA)）。

tagSource - 标记源
string。 action = create时是必需的。 允许的值：auto（Git 标记）、manual（用户指定的标记）。 默认值：auto。

指定要用于发布创建的标记。 auto（Git 标记）选项自动使用与 Git 提交关联的标记。 使用 manual（用户指定的标记）选项手动提供标记。

tagPattern - 标记模式
string。 可选。 当 tagSource = auto时使用。

使用正则表达式指定 Git 标记模式，例如 release-v1.*。 仅针对具有匹配 Git 标记的提交创建 GitHub 版本。

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时是必需的。

指定发布标记的正则表达式。 匹配此标记的发布将用作变更日志计算的基础。

changeLogType - Changelog 类型
string。 addChangeLog = true时是必需的。 允许的值：commitBased（基于提交）、issueBased（基于问题）。 默认值：commitBased。

指定更改日志类型。 更改日志可以是基于提交的，也可以是基于问题的。 基于提交的变更日志列出了发布中包含的所有提交。 基于问题的更改日志列出了发布中包含的所有问题或拉取请求（PR）。

changeLogLabels - 类别
string。 可选。 当 changeLogType = issueBased && addChangeLog = true时使用。 默认值：[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]。

根据与问题或 PR 关联的标签对更改进行分类。 对于标签，可以提及类别和问题状态的显示名称。 标签示例包括："[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]"。 如果更改具有多个标签，则第一个指定的标签优先。 将此字段留空，以查看问题或 PR 的平面列表。

没有。

注解

GitHubRelease@1提供了此任务的较新版本。