ServiceFabricUpdateAppVersions@1 – Uppdatera Service Fabric App Versions v1-uppgift

Artikel
2025-03-24

Använd den här uppgiften i en bygg-pipeline för att automatiskt uppdatera versionerna av en paketerad Service Fabric-app. Den här uppgiften lägger till ett versionssuffix i alla tjänst- och appversioner som anges i manifestfilerna i ett Azure Service Fabric-apppaket.

Syntax

# Update Service Fabric App Versions v1
# Automatically updates the versions of a packaged Service Fabric application.
- task: ServiceFabricUpdateAppVersions@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    versionSuffix: '.$(Build.BuildNumber)' # string. Required. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when compareType = Specific. Build Number.

Ingångar

applicationPackagePath - programpaket
string. Obligatoriskt.

Anger platsen för Service Fabric-programpaketet som ska distribueras till klustret. Exempel: $(system.defaultworkingdirectory)/**/drop/applicationpackage. Variabler och jokertecken kan användas i sökvägen.

versionSuffix - versionsvärde
string. Obligatoriskt. Standardvärde: .$(Build.BuildNumber).

Det värde som används för att ange versionen i manifestfilerna.

Tips

Du kan ändra versionsnummerformatet direkt eller använda ett loggningskommando för att dynamiskt ange en variabel i valfritt format. Du kan till exempel använda $(VersionSuffix) som definierats i en PowerShell-uppgift:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"

Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - versionsbeteende
string. Tillåtna värden: Append, Replace. Standardvärde: Append.

Lägger till versionsvärdet i befintliga värden i manifestfilerna eller ersätter dem.

updateOnlyChanged - uppdatera endast om den ändras
boolean. Standardvärde: false.

Uppdaterar endast de paket som har ändrats stegvis. Använd deterministisk kompilatorflagga för att säkerställa att versioner med samma indata ger samma utdata.

pkgArtifactName - paketartefaktnamn
string. Valfritt. Använd när updateOnlyChanged = true.

Anger namnet på artefakten som innehåller programpaketet från föregående version.

logAllChanges - Logga alla ändringar
boolean. Valfritt. Använd när updateOnlyChanged = true. Standardvärde: true.

Jämför alla filer i varje paket och loggar om filen har lagts till, tagits bort eller om dess innehåll har ändrats. Annars jämförs endast filer i ett paket tills den första ändringen hittas för snabbare prestanda.

compareType - Jämför med
string. Valfritt. Använd när updateOnlyChanged = true. Tillåtna värden: LastSuccessful (senaste lyckade version), Specific (specifik version). Standardvärde: LastSuccessful.

Jämför med den senast slutförda och lyckade versionen eller mot en specifik version.

buildNumber - Build Number
string. Valfritt. Använd när compareType = Specific.

Anger versionsnumret för jämförelse om aktiviteten jämförs med en specifik version.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Ombud
kräver	Lokalt installerade agenter måste ha funktioner som matchar följande kräver för att köra jobb som använder den här uppgiften: Cmd
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.95.0 eller senare
Aktivitetskategori	Nytta

Dela via