GitHubRelease@1 – GitHub Release v1-uppgift

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

# GitHub Release v1
# Create, edit, or delete a GitHub release.
- task: GitHubRelease@1
  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: 'gitTag' # 'gitTag' | 'userSpecifiedTag'. Required when action = create. Tag source. Default: gitTag.
    #tagPattern: # string. Optional. Use when tagSource = gitTag. Tag Pattern. 
    #tag: # string. Required when action = edit || action = delete || tagSource = userSpecifiedTag. Tag. 
    #title: # string. Optional. Use when action = create || action = edit. Release title. 
    #releaseNotesSource: 'filePath' # 'filePath' | 'inline'. Optional. Use when action = create || action = edit. Release notes source. Default: filePath.
    #releaseNotesFilePath: # string. Optional. Use when releaseNotesSource = filePath. Release notes file path. 
    #releaseNotesInline: # string. Optional. Use when releaseNotesSource = inline. 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. Krävs.

Anger namnet på github-tjänstanslutningen 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 - Databasen
string. Krävs. Standardvärde: $(Build.Repository.Name).

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

action - Åtgärder
string. Krävs. 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: gitTag (Git-tagg), userSpecifiedTag (användarangiven tagg). Standardvärde: gitTag.

Anger taggen som du vill använda för att skapa versioner. Alternativet gitTag använder automatiskt taggen som är associerad med Git-incheckningen. Använd alternativet userSpecifiedTag för att manuellt ange en tagg.

tagPattern - Taggmönster
string. Valfritt. Använd när tagSource = gitTag.

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

tag - Etiketten
string. Krävs när action = edit || action = delete || tagSource = userSpecifiedTag.

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älla för viktig information
string. Valfritt. Använd när action = create || action = edit. Tillåtna värden: filePath (viktig informationsfil), inline (infogade viktig information). Standardvärde: filePath.

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

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

Anger filen som innehåller viktig information.

releaseNotesInline - Utgåvan
string. Valfritt. Använd när releaseNotesSource = inline.

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. Du kan till exempel använda $(Build.ArtifactStagingDirectory)/*.zip 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 $(Build.ArtifactStagingDirectory) katalogen upp. Mer information om listan över fördefinierade variabler som är tillgängliga finns i skapa variabler och versionsvariabler.

assetUploadMode - Uppladdningsläge för 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. delete Använd alternativet (Ta bort befintliga tillgångar) för att först ta bort befintliga tillgångar i versionen och sedan ladda upp alla tillgångar. replace Använd alternativet (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 versionen ska sparas 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 versionen ska markeras som en förhandsversion.

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

Anger om du vill inkludera en ändringslogg. Om det ä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 version), 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 version): Jämför den aktuella versionen med den senaste icke-utkastversionen som inte har markerats som förhandsversion.
• lastNonDraftRelease (Senaste icke-utkastversion): Jämför den aktuella versionen med den senaste icke-utkastversionen.
• lastNonDraftReleaseByTag (Senaste icke-utkastversion efter tagg): Jämför den aktuella versionen med den senaste icke-utkastversionen som matchar den angivna taggen. Du kan också ange ett 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. Versioner som matchar den här taggen används som bas för beräkningen av ändringsloggar.

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

Anger ändringsloggtypen. En ändringslogg kan vara incheckningsbaserad eller problembaserad. I en incheckningsbaserad ändringslogg visas alla incheckningar som ingår i en version. En problembaserad ä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 de 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 PR.

Inga.