ServiceFabricUpdateManifests@2 – Uppdatera Service Fabric-manifest v2-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 manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

Ingångar

updateType - uppdateringstyp
string. Obligatoriskt. Tillåtna värden: Manifest versions, Docker image settings. Standardvärde: Manifest versions.

Anger vilken typ av uppdatering som ska göras till manifestfilerna. För att kunna använda båda uppdateringstyperna lägger du till en instans av den här uppgiften i bygg-pipelinen för varje typ av uppdatering som ska köras.

applicationPackagePath - programpaket
string. Obligatoriskt.

Anger sökvägen till programpaketet. Variabler och jokertecken kan användas i sökvägen. applicationPackagePath får inte ha ett avslutande snedstreck, antingen \ eller /.

versionSuffix - versionsvärde
string. Krävs när updateType = Manifest versions. Standardvärde: .$(Build.BuildNumber).

Anger versionen i manifestfilerna.

Tips

Du kan ändra versionsnummerformatet direkt eller använda ett loggningskommando för att dynamiskt ange en variabel i ett 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. Valfritt. Använd när updateType = Manifest versions. Tillåtna värden: Append, Replace. Standardvärde: Append.

Anger om versionsvärdet ska läggas till i befintliga värden i manifestfilerna eller ersätta dem.

updateOnlyChanged - uppdatera endast om den ändras
boolean. Valfritt. Använd när updateType = Manifest versions. Standardvärde: false.

Lägger till det nya versionssuffixet till endast de paket som har ändrats från en tidigare version. Om inga ändringar hittas läggs versionssuffixet från föregående version till.

Anmärkning

Som standard skapar kompilatorn olika utdata även om inga ändringar har gjorts. 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 updateType = Manifest versions && updateOnlyChanged = true.

Anger namnet på artefakten som innehåller programpaketet för jämförelse.

logAllChanges - Logga alla ändringar
boolean. Valfritt. Använd när updateType = Manifest versions && 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ör det booleska objektet 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 updateType = Manifest versions && updateOnlyChanged = true. Tillåtna värden: LastSuccessful (senaste lyckade version), Specific (specifik version). Standardvärde: LastSuccessful.

Anger om du vill jämföra med den senast slutförda och lyckade versionen eller mot en specifik version.

buildNumber - Build Number
string. Valfritt. Använd när updateType = Manifest versions && compareType = Specific.

Anger versionsnumret för jämförelse.

overwriteExistingPkgArtifact - skriva över befintlig paketartefakt
boolean. Valfritt. Använd när updateType = Manifest versions && updateOnlyChanged = true. Standardvärde: true.

Laddar ned en ny kopia av artefakten. Annars använder det här booleska objektet en befintlig kopia om den finns.

sökväg imageNamesPath - bildnamn
string. Valfritt. Använd när updateType = Docker image settings.

Anger sökvägen till en textfil som innehåller namnen på de Docker-avbildningar som är associerade med Service Fabric-programmet som ska uppdateras med sammandrag. Varje bildnamn måste vara på sin egen rad och måste vara i samma ordning som sammanfattningarna i filen Image Digests. Om avbildningarna skapas av Service Fabric-projektet genereras den här filen som en del av paketmålet och dess utdataplats styrs av egenskapen BuiltDockerImagesFilePath.

imageDigestsPath - Bildsammandrag sökväg
string. Krävs när updateType = Docker image settings.

Anger sökvägen till en textfil som innehåller sammandragsvärdena för De Docker-avbildningar som är associerade med Service Fabric-programmet. Den här filen kan matas ut av Docker-uppgift när du använder push-åtgärden. Filen ska innehålla textrader i formatet registry/image_name@digest_value.

Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

Anmärkning

Den här uppgiften kräver Windows PowerShell.

Den här uppgiften är inte tillgänglig i version pipelines.

Den här uppgiften kan bara användas i en byggpipeline för att automatiskt uppdatera versionerna av en paketerad Service Fabric-app.

Den här uppgiften stöder två typer av uppdateringar:

Manifestversion: Uppdaterar tjänst- och programversioner som anges i manifestfiler i ett Service Fabric-programpaket. Om det anges jämför manifest version aktuella filer med en tidigare version och uppdaterar endast versionen för de ändrade tjänsterna.
Docker-avbildningsinställningar: Uppdaterar docker-containeravbildningsinställningarna som anges i manifestfiler i ett Service Fabric-programpaket. De bildinställningar som ska placeras väljs från två filer:

a. Fil med avbildningsnamn: Den här filen genereras av byggaktiviteten.

b) Image digests-fil: Den här filen genereras av docker-aktiviteten när den skickar avbildningar till registret.

Exempel

* service fabric-programdistributionsuppgift

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
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