ServiceFabricUpdateManifests@2 – Uppdatera Service Fabric-manifest v2-uppgift

  • Artikel

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-appaket.

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.

# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged 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.

Indata

updateType - Uppdateringstyp
string. Krävs. Tillåtna värden: Manifest versions, Docker image settings. Standardvärde: Manifest versions.

Anger vilken typ av uppdatering som ska göras till manifestfilerna. Om du vill 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. Krävs.

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) definierad 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 du vill lägga till versionsvärdet 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 den tidigare versionen till.

Anteckning

Som standard skapar kompilatorn olika utdata även om inga ändringar har gjorts. Använd den deterministiska kompilatorflaggan för att säkerställa att versioner med samma indata genererar samma utdata.


pkgArtifactName - Namn på paketartefakt
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 här 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 kompilering), 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 - Versionsnummer
string. Valfritt. Använd när updateType = Manifest versions && compareType = Specific.

Anger versionsnumret för jämförelse.


overwriteExistingPkgArtifact - Skriv ö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.


imageNamesPath - Sökväg till 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 finnas på en egen rad och måste vara i samma ordning som sammandragen i bildsammandragsfilen. 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 - Sökväg för bildsammandrag
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-aktiviteten när du använder push-åtgärden. Filen ska innehålla textrader i formatet registry/image_name@digest_value.


Alternativ för aktivitetskontroll

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

Utdatavariabler

Inga.

Kommentarer

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-appaket.

Anteckning

Den här uppgiften kräver Windows PowerShell.

Den här uppgiften är inte tillgänglig i versionspipelines.

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

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

  1. Manifestversion: Uppdateringar tjänst- och programversioner som anges i manifestfiler i ett Service Fabric-programpaket. Om detta anges manifest version jämförs aktuella filer med en tidigare version och uppdaterar endast versionen för de ändrade tjänsterna.

  2. Docker-avbildningsinställningar: Uppdateringar docker-containeravbildningsinställningar 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 bygguppgiften.

    b. Bildsammandragsfil: Den här filen genereras av docker-aktiviteten när den skickar avbildningar till registret.

Exempel

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: Cmd
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 1.95.0 eller senare
Uppgiftskategori Verktyg