ServiceFabricUpdateManifests@2 — aktualizowanie manifestów usługi Service Fabric w wersji 2

Artykuł
2025-03-24

Użyj tego zadania w potoku kompilacji, aby automatycznie zaktualizować 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 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.

Dane wejściowe

updateType - typ aktualizacji
string. To jest wymagane. Dozwolone wartości: Manifest versions, Docker image settings. Wartość domyślna: Manifest versions.

Określa typ aktualizacji, który ma zostać wykonany w plikach manifestu. Aby użyć obu typów aktualizacji, dodaj wystąpienie tego zadania do potoku kompilacji dla każdego typu aktualizacji do wykonania.

pakietu aplikacji applicationPackagePath -
string. To jest wymagane.

Określa ścieżkę do pakietu aplikacji. zmienne i symbole wieloznaczne mogą być używane w ścieżce. applicationPackagePath nie może mieć ukośnika końcowego, \ lub /.

wartość wersji versionSuffix -
string. Wymagane, gdy updateType = Manifest versions. Wartość domyślna: .$(Build.BuildNumber).

Określa wersję w plikach manifestu.

Wskazówka

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

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - zachowanie wersji
string. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions. Dozwolone wartości: Append, Replace. Wartość domyślna: Append.

Określa, czy należy dołączyć wartość wersji do istniejących wartości w plikach manifestu, czy zastąpić je.

updateOnlyChanged - Update tylko w przypadku zmiany
boolean. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions. Wartość domyślna: false.

Dołącza nowy sufiks wersji tylko do pakietów, które zostały zmienione z poprzedniej kompilacji. Jeśli nie zostaną znalezione żadne zmiany, zostanie dołączony sufiks wersji z poprzedniej kompilacji.

Uwaga

Domyślnie kompilator utworzy różne dane wyjściowe, nawet jeśli nie wprowadzono żadnych zmian. Użyj flagi deterministycznego kompilatora, 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 updateType = Manifest versions && updateOnlyChanged = true.

Określa nazwę artefaktu zawierającego pakiet aplikacji do porównania.

logAllChanges - Rejestrowanie wszystkich zmian
boolean. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions && 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 ten wartość logiczna porównuje pliki w pakiecie tylko do momentu znalezienia pierwszej zmiany w celu uzyskania szybszej wydajności.

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

Określa, czy porównać z ostatnią ukończoną i pomyślną kompilacją, czy z określoną kompilacją.

buildNumber - numer kompilacji
string. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions && compareType = Specific.

Określa numer kompilacji dla porównania.

overwriteExistingPkgArtifact - zastępowanie istniejącego artefaktu pakietu
boolean. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions && updateOnlyChanged = true. Wartość domyślna: true.

Pobiera nową kopię artefaktu. W przeciwnym razie wartość logiczna używa istniejącej kopii, jeśli istnieje.

imageNamesPath - ścieżki nazw obrazów
string. Opcjonalny. Użyj polecenia , gdy updateType = Docker image settings.

Określa ścieżkę do pliku tekstowego zawierającego nazwy obrazów platformy Docker skojarzonych z aplikacją usługi Service Fabric, które powinny zostać zaktualizowane przy użyciu skrótów. Każda nazwa obrazu musi znajdować się we własnym wierszu i musi być w takiej samej kolejności, jak skróty w pliku Image Digests. Jeśli obrazy są tworzone przez projekt usługi Service Fabric, ten plik jest generowany jako część elementu docelowego pakietu, a jego lokalizacja wyjściowa jest kontrolowana przez właściwość BuiltDockerImagesFilePath.

ścieżka skrótów obrazu imageDigestsPath -
string. Wymagane, gdy updateType = Docker image settings.

Określa ścieżkę do pliku tekstowego zawierającego wartości skrótów obrazów platformy Docker skojarzonych z aplikacją usługi Service Fabric. Ten plik może być wyjściowy przez zadanie platformy Docker podczas korzystania z akcji wypychania. Plik powinien zawierać wiersze tekstu w formacie registry/image_name@digest_value.

Opcje sterowania zadaniami

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

Zmienne wyjściowe

Żaden.

Uwagi

Uwaga

To zadanie wymaga programu Windows PowerShell.

To zadanie nie jest dostępne w potokach wydania.

To zadanie może być używane tylko w potoku kompilacji, aby automatycznie aktualizować wersje spakowanej aplikacji usługi Service Fabric.

To zadanie obsługuje dwa typy aktualizacji:

wersja manifestu: aktualizacje wersji usługi i aplikacji określonych w plikach manifestu w pakiecie aplikacji usługi Service Fabric. Jeśli zostanie określony, manifest version porównuje bieżące pliki z poprzednią kompilacją i aktualizuje wersję tylko dla tych zmienionych usług.
ustawienia obrazu platformy Docker: aktualizuje ustawienia obrazu kontenera platformy Docker określone w plikach manifestu w pakiecie aplikacji usługi Service Fabric. Ustawienia obrazu do umieszczenia są wybierane z dwóch plików:

a. plik nazw obrazów: ten plik jest generowany przez zadanie kompilacji.

b. plik skrótów obrazów: ten plik jest generowany przez zadanie platformy Docker podczas wypychania obrazów do rejestru.

Przykłady

* zadania wdrażania aplikacji usługi Service Fabric

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.95.0 lub nowsza
Kategoria zadań	Użyteczność

Udostępnij za pośrednictwem