ServiceFabricUpdateAppVersions@1: Task "Service Fabric-App-Versionen v1 aktualisieren"

Artikel
07/02/2024

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

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.

Eingaben

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 einem beliebigen Format dynamisch festzulegen. Sie können beispielsweise in einer PowerShell-Aufgabe definiert verwenden $(VersionSuffix) :

$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
boolean. Standardwert. false.

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

pkgArtifactName - Name des Paketartefakts
string. Optional. Verwenden Sie , wenn updateOnlyChanged = true.

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

logAllChanges - Protokollieren aller Änderungen
boolean. Optional. Verwenden Sie , wenn updateOnlyChanged = true. Standardwert. true.

Vergleicht alle Dateien in jedem Paket und protokolliert, ob die Datei hinzugefügt, entfernt wurde oder ob sich ihr Inhalt geändert hat. Andernfalls vergleicht Dateien in einem Paket nur, bis die erste Änderung gefunden wird, um die Leistung zu verbessern.

compareType - Vergleichen mit
string. Optional. Verwenden Sie , wenn updateOnlyChanged = true. Zulässige Werte: LastSuccessful (Letzter erfolgreicher Build), Specific (spezifischer Build). Standardwert. LastSuccessful.

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

buildNumber - Buildnummer
string. Optional. Verwenden Sie , 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 Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Wird ausgeführt auf	Agent
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: Cmd
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.95.0 oder höher
Aufgabenkategorie	Hilfsprogramm

Freigeben über