ServiceFabricUpdateAppVersions@1 — aktualizowanie zadania wersje aplikacji usługi Service Fabric w wersji 1

To zadanie jest używane w potoku kompilacji, aby automatycznie aktualizować wersje spakowanej aplikacji usługi Service Fabric. To zadanie dołącza sufiks wersji do wszystkich wersji usługi i aplikacji określonych w plikach manifestu w pakiecie aplikacji usługi Azure Service Fabric.

Składnia

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

Dane wejściowe

applicationPackagePath - Pakiet aplikacji
string. Wymagane.

Określa lokalizację pakietu aplikacji usługi Service Fabric, który ma zostać wdrożony w klastrze. Przykład: $(system.defaultworkingdirectory)/**/drop/applicationpackage. Zmienne i symbole wieloznaczne mogą być używane w ścieżce.

versionSuffix - Wartość wersji
string. Wymagane. Wartość domyślna: .$(Build.BuildNumber).

Wartość używana do określenia wersji w plikach manifestu.

Porada

Format numeru kompilacji można zmodyfikować bezpośrednio lub użyć polecenia rejestrowania, aby dynamicznie ustawić zmienną w dowolnym formacie. Można na przykład użyć $(VersionSuffix) zdefiniowanego w zadaniu programu PowerShell:

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

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

versionBehavior - Zachowanie wersji
string. Dozwolone wartości: Append, Replace. Wartość domyślna: Append.

Dołącza wartość wersji do istniejących wartości w plikach manifestu lub zastępuje je.

updateOnlyChanged - Aktualizuj tylko w przypadku zmiany
boolean. Wartość domyślna: false.

Przyrostowo aktualizuje tylko zmienione pakiety. Użyj flagi kompilatora deterministycznego , aby upewnić się, że kompilacje z tymi samymi danymi wejściowymi generują te same dane wyjściowe.

pkgArtifactName - Nazwa artefaktu pakietu
string. Opcjonalny. Użyj polecenia , gdy updateOnlyChanged = true.

Określa nazwę artefaktu zawierającego pakiet aplikacji z poprzedniej kompilacji.

logAllChanges - Rejestrowanie wszystkich zmian
boolean. Opcjonalny. Użyj polecenia , gdy updateOnlyChanged = true. Wartość domyślna: true.

Porównuje wszystkie pliki w każdym pakiecie i rejestruje, czy plik został dodany, usunięty lub czy jego zawartość uległa zmianie. W przeciwnym razie porównuje pliki w pakiecie tylko do momentu znalezienia pierwszej zmiany w celu zwiększenia wydajności.

compareType - Porównanie z
string. Opcjonalny. Użyj polecenia , gdy updateOnlyChanged = true. Dozwolone wartości: LastSuccessful (ostatnia pomyślna kompilacja), Specific (określona kompilacja). Wartość domyślna: LastSuccessful.

Porównuje się z ostatnio ukończoną i pomyślną kompilacją lub z określoną kompilacją.

buildNumber - Numer kompilacji
string. Opcjonalny. Użyj polecenia , gdy compareType = Specific.

Określa numer kompilacji do porównania, jeśli zadanie jest porównywane z określoną kompilacją.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa w	Agent
Wymagania	Agenci hostowani samodzielnie muszą mieć funkcje zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: Cmd
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	1.95.0 lub nowsza
Kategoria zadania	Narzędzie