ServiceFabricUpdateAppVersions@1 – Aufgabe "Dienst Fabric-App-Versionen aktualisieren v1"

Artikel
03/24/2025

Verwenden Sie diese Aufgabe in einer Buildpipeline, um die Versionen einer verpackten Service Fabric-App automatisch zu aktualisieren. Diese Aufgabe fügt ein Versionssuffix an alle Dienst- und App-Versionen an, die in den Manifestdateien angegeben sind, in einem Azure Service Fabric-App-Paket.

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.

Eingänge

applicationPackagePath - Anwendungspaket-
string. Erforderlich.

Gibt den Speicherort des Service Fabric-Anwendungspakets an, das im Cluster bereitgestellt werden soll. Beispiel: $(system.defaultworkingdirectory)/**/drop/applicationpackage. Variablen und Wildcards können im Pfad verwendet werden.

versionSuffix - Versionswert
string. Erforderlich. Standardwert: .$(Build.BuildNumber).

Der Wert, der zum Angeben der Version in den Manifestdateien verwendet wird.

Tipp

Sie können das Buildnummernformat direkt ändern oder einen Protokollierungsbefehl verwenden, um eine Variable in jedem beliebigen Format dynamisch festzulegen. Sie können beispielsweise $(VersionSuffix) verwenden, die in einer PowerShell-Aufgabe definiert sind:

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

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

versionBehavior - Versionsverhalten
string. Zulässige Werte: Append, Replace. Standardwert: Append.

Fügt den Versionswert an vorhandene Werte in den Manifestdateien an oder ersetzt sie.

updateOnlyChanged - Nur aktualisieren, wenn geändert wurde
boolean. Standardwert: false.

Aktualisiert inkrementell nur die Pakete, die geändert wurden. Verwenden Sie das deterministische Compilerflagge, um sicherzustellen, dass Builds mit den gleichen Eingaben dieselben Ausgaben erzeugen.

pkgArtifactName - Paketartefaktename
string. Wahlfrei. Wird verwendet, wenn updateOnlyChanged = true.

Gibt den Namen des Artefakts an, das das Anwendungspaket aus dem vorherigen Build enthält.

logAllChanges - Alle Änderungen protokollieren
boolean. Wahlfrei. Wird verwendet, wenn updateOnlyChanged = true. Standardwert: true.

Vergleicht alle Dateien in allen Paketen und Protokollen, wenn die Datei hinzugefügt, entfernt oder der Inhalt geändert wurde. Andernfalls werden Dateien in einem Paket nur verglichen, bis die erste Änderung für eine schnellere Leistung gefunden wird.

compareType - Vergleichen mit
string. Wahlfrei. Wird verwendet, wenn updateOnlyChanged = true. Zulässige Werte: LastSuccessful (Last Successful Build), Specific (Specific Build). Standardwert: LastSuccessful.

Vergleicht mit dem letzten abgeschlossenen und erfolgreichen Build oder mit einem bestimmten Build.

buildNumber - Buildnummer
string. Wahlfrei. Wird verwendet, wenn compareType = Specific.

Gibt die Buildnummer für den Vergleich an, wenn die Aufgabe mit einem bestimmten Build verglichen wird.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Läuft auf	Agent
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: Cmd
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.95.0 oder höher
Vorgangskategorie	Nützlichkeit

Teilen über