GitHubRelease@0 – GitHub Release v0-uppgift

Använd den här uppgiften för att skapa, redigera eller ta bort en GitHub-version.

Den här versionen av uppgiften är inaktuell. använd GitHubRelease@1.

Använd den här uppgiften för att skapa, redigera eller ta bort en GitHub-version.

# 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-anslutning (OAuth eller PAT)
string. Obligatoriskt.

Anger namnet på den GitHub-tjänstanslutning som ska användas för att ansluta till GitHub-lagringsplatsen. Anslutningen måste baseras på en GitHub-användares OAuth eller en personlig GitHub-åtkomsttoken. Mer information om tjänstanslutningar finns i Hantera tjänstanslutningar.

repositoryName - lagringsplats
string. Obligatoriskt. Standardvärde: $(Build.Repository.Name).

Anger namnet på GitHub-lagringsplatsen där du ska skapa, redigera eller ta bort GitHub-versionen.

action - åtgärd
string. Obligatoriskt. Tillåtna värden: create, edit, delete. Standardvärde: create.

Anger vilken typ av versionsåtgärd som ska utföras. Den här uppgiften kan skapa, redigera eller ta bort en GitHub-version.

target - Mål
string. Krävs när action = create || action = edit. Standardvärde: $(Build.SourceVersion).

Anger den inchecknings-SHA som du vill använda för att skapa GitHub-versionen, till exempel 48b11d8d6e92a22e3e9563a3f643699c16fd6e27. Du kan också använda en variabel, till exempel $(myCommitSHA), i det här fältet.

tagSource - Taggkälla
string. Krävs när action = create. Tillåtna värden: auto (Git-tagg), manual (användar angiven tagg). Standardvärde: auto.

Anger taggen som du vill använda för att skapa versioner. Alternativet auto (Git-tagg) använder automatiskt taggen som är associerad med Git-incheckningen. Använd alternativet manual (användar angiven tagg) för att manuellt ange en tagg.

tagPattern - taggmönster
string. Valfritt. Använd när tagSource = auto.

Anger Git-taggmönstret med hjälp av regex, till exempel release-v1.*. GitHub-versionen skapas endast för incheckningar som har matchande Git-tagg.

tag - Tagga
string. Krävs när action = edit || action = delete || tagSource = manual.

Anger den tagg som du vill använda när du skapar, redigerar eller tar bort en version. Du kan också använda en variabel, till exempel $(myTagName), i det här fältet.

title - Versionsrubrik
string. Valfritt. Använd när action = create || action = edit.

Anger rubriken på GitHub-versionen. Om den lämnas tom används taggen som versionsrubrik.

releaseNotesSource - Källkälla för viktig information
string. Valfritt. Använd när action = create || action = edit. Tillåtna värden: file (viktig anteckningsfil), input (infogade viktig information). Standardvärde: file.

Anger beskrivningen av GitHub-versionen. Använd alternativet file (Viktig anteckningsfil) för att använda filinnehåll som viktig information. Använd alternativet input (infogade viktig information) för att manuellt ange viktig information.

releaseNotesFile - Filsökväg för viktig information
string. Valfritt. Använd när releaseNotesSource = file.

Anger filen som innehåller viktig information.

releaseNotes - Viktig information
string. Valfritt. Använd när releaseNotesSource = input.

Anger viktig information. Markdown stöds.

assets - Tillgångar
string. Valfritt. Använd när action = create || action = edit. Standardvärde: $(Build.ArtifactStagingDirectory)/*.

Anger de filer som du vill ladda upp som tillgångar i versionen. Du kan använda jokertecken för att ange flera filer. Använd till exempel $(Build.ArtifactStagingDirectory)/*.zip för att skapa pipelines eller använda $(System.DefaultWorkingDirectory)/*.zip för versionspipelines.

Du kan också ange flera mönster, ett per rad. Som standard laddas alla filer i katalogen $(Build.ArtifactStagingDirectory) upp. Mer information om listan över fördefinierade variabler som är tillgängliga finns i versionsvariabler och versionsvariabler.

assetUploadMode - läget för uppladdning av tillgångar
string. Valfritt. Använd när action = edit. Tillåtna värden: delete (Ta bort befintliga tillgångar), replace (Ersätt befintliga tillgångar). Standardvärde: delete.

Anger det uppladdningsläge för tillgångar som du vill använda. Använd alternativet delete (Ta bort befintliga tillgångar) för att först ta bort befintliga tillgångar i versionen och sedan ladda upp alla tillgångar. Använd alternativet replace (Ersätt befintliga tillgångar) för att ersätta alla tillgångar som har samma namn.

isDraft - Utkastversion
boolean. Valfritt. Använd när action = create || action = edit. Standardvärde: false.

Anger om du vill spara versionen som ett utkast (avpublicerat). Om falsepubliceras versionen.

isPreRelease - förhandsversion
boolean. Valfritt. Använd när action = create || action = edit. Standardvärde: false.

Anger om du vill markera versionen som en förhandsversion.

addChangeLog - Lägg till
boolean. Valfritt. Använd när action = create || action = edit. Standardvärde: true.

Anger om du vill inkludera en ändringslogg. Om värdet är inställt på truegenereras en lista med ändringar (incheckningar och problem) mellan den aktuella versionen och den senaste publicerade versionen och läggs till i viktig information.

changeLogCompareToRelease - Jämför med
string. Krävs när addChangeLog = true. Tillåtna värden: lastFullRelease (senaste fullständiga versionen), lastNonDraftRelease (senaste icke-utkastversion), lastNonDraftReleaseByTag (senaste icke-utkastversion efter tagg). Standardvärde: lastFullRelease.

Anger vilken version som ska jämföras med för att generera ändringsloggen:

• lastFullRelease (Senaste fullständiga versionen): Jämför den aktuella versionen med den senaste icke-utkastversionen som inte har markerats som förhandsversion.
• lastNonDraftRelease (Senaste icke-utkastversionen): Jämför den aktuella versionen med den senaste versionen som inte är utkast.
• lastNonDraftReleaseByTag (Senaste icke-utkastversion efter tagg): Jämför den aktuella versionen med den senaste versionen som inte är utkast som matchar den angivna taggen. Du kan också ange en regex i stället för en exakt tagg.

changeLogCompareToReleaseTag - versionstagg
string. Krävs när changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true.

Anger regex för versionstaggen. En version som matchar den här taggen används som bas för changelog-beräkningen.

changeLogType - Ändringsloggtyp
string. Krävs när addChangeLog = true. Tillåtna värden: commitBased (incheckningsbaserad), issueBased (problembaserad). Standardvärde: commitBased.

Anger typ av ändringslogg. En ändringslogg kan vara incheckningsbaserad eller problembaserad. En incheckningsbaserad ändringslogg visar en lista över alla incheckningar som ingår i en version. Ett problembaserat ändringslogg visar en lista över alla problem eller pull-begäranden (PR) som ingår i versionen.

changeLogLabels - kategorier
string. Valfritt. Använd när changeLogType = issueBased && addChangeLog = true. Standardvärde: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

Kategoriserar ändringar baserat på etiketten som är associerad med problemet eller PR. För en etikett kan du nämna visningsnamnet för kategorin och problemets tillstånd. Exempel på etiketter är: "[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]". I fall där en ändring har flera etiketter på sig prioriteras den första angivna etiketten. Lämna det här fältet tomt om du vill se en platt lista över problem eller prs.

Ingen.

Anmärkningar

Det finns en nyare version av den här uppgiften tillgänglig på GitHubRelease@1.