GitHubRelease@0 - GitHub Release v0-taak

Gebruik deze taak om een GitHub-release te maken, bewerken of verwijderen.

Syntax

# 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" }].

Invoerwaarden

gitHubConnection - GitHub-verbinding (OAuth of PAT)
string. Vereist.

Hiermee geeft u de naam op van de GitHub-serviceverbinding die moet worden gebruikt om verbinding te maken met de GitHub-opslagplaats. De verbinding moet zijn gebaseerd op de OAuth van een GitHub-gebruiker of een persoonlijk GitHub-toegangstoken. Zie Serviceverbindingen beheren voor meer informatie over serviceverbindingen.

repositoryName - Repository
string. Vereist. Standaardwaarde: $(Build.Repository.Name).

Hiermee geeft u de naam op van de GitHub-opslagplaats waar u de GitHub-release gaat maken, bewerken of verwijderen.

action - Actie
string. Vereist. Toegestane waarden: create, edit, delete. Standaardwaarde: create.

Hiermee geeft u het type releasebewerking op dat moet worden uitgevoerd. Met deze taak kunt u een GitHub-release maken, bewerken of verwijderen.

target - Doel
string. Vereist wanneer action = create || action = edit. Standaardwaarde: $(Build.SourceVersion).

Hiermee geeft u de doorvoer-SHA op die u wilt gebruiken om de GitHub-release te maken, bijvoorbeeld 48b11d8d6e92a22e3e9563a3f643699c16fd6e27. U kunt in dit veld ook een variabele gebruiken, zoals $(myCommitSHA).

tagSource - Tagbron
string. Vereist wanneer action = create. Toegestane waarden: auto (Git-tag), manual (door de gebruiker opgegeven tag). Standaardwaarde: auto.

Hiermee geeft u de tag die u wilt gebruiken voor het maken van de release. De auto optie (Git-tag) maakt automatisch gebruik van de tag die is gekoppeld aan de Git-doorvoer. Gebruik de manual optie (Door gebruiker opgegeven tag) om handmatig een tag op te geven.

tagPattern - Tagpatroon
string. Optioneel. Gebruik wanneer tagSource = auto.

Hiermee geeft u het Git-tagpatroon op met behulp van regex, bijvoorbeeld release-v1.*. De GitHub-release wordt alleen gemaakt voor doorvoeringen met een overeenkomende Git-tag.

tag - Tag
string. Vereist wanneer action = edit || action = delete || tagSource = manual.

Hiermee geeft u de tag op die u wilt gebruiken wanneer u een release maakt, bewerkt of verwijdert. U kunt in dit veld ook een variabele gebruiken, zoals $(myTagName).

title - Releasetitel
string. Optioneel. Gebruik wanneer action = create || action = edit.

Hiermee geeft u de titel van de GitHub-release op. Als u dit leeg laat, wordt de tag gebruikt als de titel van de release.

releaseNotesSource - Bron van opmerkingen bij de release
string. Optioneel. Gebruik wanneer action = create || action = edit. Toegestane waarden: file (releaseopmerkingenbestand), input (Opmerkingen bij de release inline). Standaardwaarde: file.

Hiermee geeft u de beschrijving van de GitHub-release op. Gebruik de file optie (Release notes file) om bestandsinhoud te gebruiken als releaseopmerkingen. Gebruik de input optie (Inline releaseopmerkingen) om handmatig releaseopmerkingen in te voeren.

releaseNotesFile - Bestandspad voor opmerkingen bij de release
string. Optioneel. Gebruik wanneer releaseNotesSource = file.

Hiermee geeft u het bestand met de releaseopmerkingen.

releaseNotes - Opmerkingen bij de release
string. Optioneel. Gebruik wanneer releaseNotesSource = input.

Hiermee geeft u de opmerkingen bij de release op. Markdown wordt ondersteund.

assets - Activa
string. Optioneel. Gebruik wanneer action = create || action = edit. Standaardwaarde: $(Build.ArtifactStagingDirectory)/*.

Hiermee geeft u de bestanden die u wilt uploaden als assets van de release. U kunt jokertekens gebruiken om meerdere bestanden op te geven. Gebruik $(Build.ArtifactStagingDirectory)/*.zip bijvoorbeeld voor build-pijplijnen of $(System.DefaultWorkingDirectory)/*.zip voor release-pijplijnen.

U kunt ook meerdere patronen opgeven, één per regel. Standaard worden alle bestanden in de $(Build.ArtifactStagingDirectory) map geüpload. Zie buildvariabelen en releasevariabelen voor meer informatie over de lijst met vooraf gedefinieerde variabelen die beschikbaar zijn.

assetUploadMode - Modus voor het uploaden van assets
string. Optioneel. Gebruik wanneer action = edit. Toegestane waarden: delete (Bestaande assets verwijderen), replace (Bestaande assets vervangen). Standaardwaarde: delete.

Hiermee geeft u de uploadmodus voor assets op die u wilt gebruiken. Gebruik de delete optie (Bestaande assets verwijderen) om eerst bestaande assets in de release te verwijderen en vervolgens alle assets te uploaden. Gebruik de replace optie (Bestaande assets vervangen) om assets met dezelfde naam te vervangen.

isDraft - Conceptrelease
boolean. Optioneel. Gebruik wanneer action = create || action = edit. Standaardwaarde: false.

Geeft aan of u de release wilt opslaan als een concept (niet gepubliceerd). Als false, wordt de release gepubliceerd.

isPreRelease - Voorlopige versie
boolean. Optioneel. Gebruik wanneer action = create || action = edit. Standaardwaarde: false.

Hiermee wordt aangegeven of u de release wilt markeren als een voorlopige versie.

addChangeLog - Wijzigingenlogboek toevoegen
boolean. Optioneel. Gebruik wanneer action = create || action = edit. Standaardwaarde: true.

Hiermee geeft u op of u een wijzigingenlogboek wilt opnemen. Als deze optie is ingesteld op true, wordt een lijst met wijzigingen (doorvoeringen en problemen) tussen de huidige release en de laatste gepubliceerde release gegenereerd en toegevoegd aan de releaseopmerkingen.

changeLogCompareToRelease - Vergelijken met
string. Vereist wanneer addChangeLog = true. Toegestane waarden: lastFullRelease (Laatste volledige release), lastNonDraftRelease (Laatste niet-conceptrelease), lastNonDraftReleaseByTag (Laatste niet-conceptrelease per tag). Standaardwaarde: lastFullRelease.

Geeft aan met welke release moet worden vergeleken om het wijzigingenlogboek te genereren:

• lastFullRelease (Laatste volledige release): Vergelijkt de huidige release met de meest recente niet-conceptversie die niet is gemarkeerd als pre-release.
• lastNonDraftRelease (Laatste niet-conceptversie): vergelijkt de huidige release met de meest recente niet-conceptversie.
• lastNonDraftReleaseByTag (Laatste niet-conceptrelease per tag): vergelijkt de huidige release met de laatste niet-conceptrelease die overeenkomt met de opgegeven tag. U kunt ook een regex opgeven in plaats van een exacte tag.

changeLogCompareToReleaseTag - Releasetag
string. Vereist wanneer changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true.

Hiermee geeft u de regex voor de releasetag. Een release die overeenkomt met deze tag wordt gebruikt als basis voor de berekening van het wijzigingenlogboek.

changeLogType - Type wijzigingslogboek
string. Vereist wanneer addChangeLog = true. Toegestane waarden: commitBased (op basis van doorvoeren), issueBased (op basis van probleem). Standaardwaarde: commitBased.

Hiermee geeft u het type wijzigingslogboek op. Een wijzigingslogboek kan zijn gebaseerd op doorvoeren of problemen. Een wijzigingslogboek op basis van doorvoer bevat alle doorvoeringen die zijn opgenomen in een release. Een wijzigingslogboek op basis van problemen bevat alle problemen of pull-aanvragen (PULL's) die in de release zijn opgenomen.

changeLogLabels - Categorieën
string. Optioneel. Gebruik wanneer changeLogType = issueBased && addChangeLog = true. Standaardwaarde: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

Categoriseert wijzigingen op basis van het label dat is gekoppeld aan het probleem of de pull-aanvraag. Voor een label kunt u de weergavenaam voor de categorie en de status van het probleem vermelden. Voorbeelden van labels zijn: "[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]". In gevallen waarin een wijziging meerdere labels bevat, heeft het eerste opgegeven label prioriteit. Laat dit veld leeg om een platte lijst met problemen of pull-aanvragen weer te geven.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Er is een nieuwere versie van deze taak beschikbaar op GitHubRelease@1.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.0.0 of hoger
Taakcategorie	Hulpprogramma