GitHubRelease@0 – GitHub Release v0-Aufgabe

Verwenden Sie diese Aufgabe, um eine GitHub-Version zu erstellen, zu bearbeiten oder zu löschen.

Diese Version der Aufgabe ist veraltet; verwenden Sie GitHubRelease@1.

Verwenden Sie diese Aufgabe, um eine GitHub-Version zu erstellen, zu bearbeiten oder zu löschen.

# 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-Verbindung (OAuth oder PAT)
string. Erforderlich.

Gibt den Namen der GitHub-Dienstverbindung an, die zum Herstellen einer Verbindung mit dem GitHub-Repository verwendet werden soll. Die Verbindung muss auf dem OAuth eines GitHub-Benutzers oder einem persönlichen GitHub-Zugriffstoken basieren. Weitere Informationen zu Dienstverbindungen finden Sie unter Verwalten von Dienstverbindungen.

repositoryName - Repository-
string. Erforderlich. Standardwert: $(Build.Repository.Name).

Gibt den Namen des GitHub-Repositorys an, in dem Sie die GitHub-Version erstellen, bearbeiten oder löschen möchten.

action - Aktion
string. Erforderlich. Zulässige Werte: create, edit, delete. Standardwert: create.

Gibt den Typ des auszuführenden Freigabevorgangs an. Diese Aufgabe kann eine GitHub-Version erstellen, bearbeiten oder löschen.

target - Ziel-
string. Erforderlich, wenn action = create || action = edit. Standardwert: $(Build.SourceVersion).

Gibt den Commit-SHA an, den Sie zum Erstellen der GitHub-Version verwenden möchten, z. B. 48b11d8d6e92a22e3e9563a3f643699c16fd6e27. Sie können auch eine Variable wie $(myCommitSHA)in diesem Feld verwenden.

tagSource - Tagquelle
string. Erforderlich, wenn action = create. Zulässige Werte: auto (Git-Tag), manual (vom Benutzer angegebenes Tag). Standardwert: auto.

Gibt das Tag an, das Sie für die Freigabeerstellung verwenden möchten. Die Option auto (Git-Tag) verwendet automatisch das Tag, das dem Git-Commit zugeordnet ist. Verwenden Sie die Option manual (Vom Benutzer angegebenes Tag), um manuell ein Tag bereitzustellen.

tagPattern - Tagmuster
string. Wahlfrei. Wird verwendet, wenn tagSource = auto.

Gibt das Git-Tagmuster mithilfe von regex an, z. B. release-v1.*. GitHub-Version wird nur für Commits erstellt, die übereinstimmende Git-Tag aufweisen.

tag - Tag-
string. Erforderlich, wenn action = edit || action = delete || tagSource = manual.

Gibt das Tag an, das Sie beim Erstellen, Bearbeiten oder Löschen einer Version verwenden möchten. Sie können auch eine Variable wie $(myTagName)in diesem Feld verwenden.

title - Releasetitel
string. Wahlfrei. Wird verwendet, wenn action = create || action = edit.

Gibt den Titel der GitHub-Version an. Wenn sie leer gelassen wird, wird das Tag als Releasetitel verwendet.

releaseNotesSource - Versionshinweisequelle
string. Wahlfrei. Wird verwendet, wenn action = create || action = edit. Zulässige Werte: file (Versionshinweisedatei), input (Inlineversionshinweise). Standardwert: file.

Gibt die Beschreibung der GitHub-Version an. Verwenden Sie die Option file (Versionshinweisedatei), um Dateiinhalte als Versionshinweise zu verwenden. Verwenden Sie die Option input (Inline-Versionshinweise), um Versionshinweise manuell einzugeben.

releaseNotesFile - Dateipfad der Versionshinweise
string. Wahlfrei. Wird verwendet, wenn releaseNotesSource = file.

Gibt die Datei an, die die Versionshinweise enthält.

releaseNotes - Versionshinweise
string. Wahlfrei. Wird verwendet, wenn releaseNotesSource = input.

Gibt die Versionshinweise an. Markdown wird unterstützt.

assets - Ressourcen
string. Wahlfrei. Wird verwendet, wenn action = create || action = edit. Standardwert: $(Build.ArtifactStagingDirectory)/*.

Gibt die Dateien an, die Sie als Objekte der Version hochladen möchten. Mit Wildcardzeichen können Sie mehrere Dateien angeben. Verwenden Sie z. B. $(Build.ArtifactStagingDirectory)/*.zip für Buildpipelines, oder verwenden Sie $(System.DefaultWorkingDirectory)/*.zip für Releasepipelines.

Sie können auch mehrere Muster pro Zeile angeben. Standardmäßig werden alle Dateien im verzeichnis $(Build.ArtifactStagingDirectory) hochgeladen. Weitere Informationen zur Liste der verfügbaren vordefinierten Variablen finden Sie unter Buildvariablen und Releasevariablen.

assetUploadMode - Modus zum Hochladen von Ressourcen
string. Wahlfrei. Wird verwendet, wenn action = edit. Zulässige Werte: delete (Ressourcen löschen), replace (Vorhandene Ressourcen ersetzen). Standardwert: delete.

Gibt den Ressourcenuploadmodus an, den Sie verwenden möchten. Verwenden Sie die Option delete (Vorhandene Ressourcen löschen), um zuerst vorhandene Ressourcen in der Version zu löschen und dann alle Ressourcen hochzuladen. Verwenden Sie die Option replace (Vorhandene Ressourcen ersetzen), um alle Ressourcen zu ersetzen, die denselben Namen haben.

isDraft - Entwurfsversion
boolean. Wahlfrei. Wird verwendet, wenn action = create || action = edit. Standardwert: false.

Gibt an, ob Sie die Version als Entwurf speichern möchten (unveröffentlicht). Wenn false, wird die Version veröffentlicht.

isPreRelease - Vorabversion
boolean. Wahlfrei. Wird verwendet, wenn action = create || action = edit. Standardwert: false.

Gibt an, ob Sie die Version als Vorabversion markieren möchten.

addChangeLog - Änderungsprotokoll hinzufügen
boolean. Wahlfrei. Wird verwendet, wenn action = create || action = edit. Standardwert: true.

Gibt an, ob Sie einen Änderungsprotokoll einschließen möchten. Bei Festlegung auf truewird eine Liste der Änderungen (Commits und Probleme) zwischen der aktuellen Version und der letzten veröffentlichten Version generiert und an die Versionshinweise angefügt.

changeLogCompareToRelease - Mit vergleichen
string. Erforderlich, wenn addChangeLog = true. Zulässige Werte: lastFullRelease (Letzte vollversion), lastNonDraftRelease (Letzte Nichtentwurfsversion), lastNonDraftReleaseByTag (Letzte Nichtentwurfsversion nach Tag). Standardwert: lastFullRelease.

Gibt an, mit welcher Version verglichen werden soll, um den Änderungsprotokoll zu generieren:

• lastFullRelease (Letzte Vollversion): Vergleicht die aktuelle Version mit der neuesten Nichtentwurfsversion, die nicht als Vorabversion gekennzeichnet ist.
• lastNonDraftRelease (Letzte Nichtentwurfsversion): Vergleicht die aktuelle Version mit der neuesten Version ohne Entwurf.
• lastNonDraftReleaseByTag (Letzte Nichtentwurfsversion nach Tag): Vergleicht die aktuelle Version mit der letzten Nichtentwurfsversion, die dem angegebenen Tag entspricht. Sie können auch einen regulären Ausdruck anstelle eines exakten Tags angeben.

changeLogCompareToReleaseTag - Releasetag-
string. Erforderlich, wenn changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true.

Gibt den regex für das Releasetag an. Ein Release, das dieses Tag abgleicht, wird als Basis für die Berechnung des Änderungsprotokolls verwendet.

changeLogType - Änderungsprotokolltyp
string. Erforderlich, wenn addChangeLog = true. Zulässige Werte: commitBased (Commit basierend), issueBased (Problembasiert). Standardwert: commitBased.

Gibt den Änderungsprotokolltyp an. Ein Änderungsprotokoll kann commitbasiert oder problembasiert sein. In einem commitbasierten Änderungsprotokoll werden alle Commits aufgelistet, die in einer Version enthalten sind. In einem problembasierten Änderungsprotokoll werden alle Probleme oder Pullanforderungen (PRs) aufgelistet, die in der Version enthalten sind.

changeLogLabels - Kategorien
string. Wahlfrei. Wird verwendet, wenn changeLogType = issueBased && addChangeLog = true. Standardwert: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

Kategorisiert Änderungen basierend auf der Bezeichnung, die dem Problem oder der PR zugeordnet ist. Bei einer Bezeichnung können Sie den Anzeigenamen für die Kategorie und den Status des Problems erwähnen. Beispiele für Etiketten sind: "[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]". In Fällen, in denen eine Änderung mehrere Bezeichnungen enthält, hat die erste angegebene Bezeichnung Vorrang. Lassen Sie dieses Feld leer, um eine flache Liste von Problemen oder PRs anzuzeigen.

Keiner.

Bemerkungen

Es ist eine neuere Version dieser Aufgabe unter GitHubRelease@1verfügbar.