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

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

applicationPackagePath - Pakiet aplikacji
string. 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 \/.

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

Określa wersję w plikach manifestu.

Porada

Format numeru kompilacji można zmodyfikować bezpośrednio lub użyć polecenia rejestrowania, aby dynamicznie ustawić zmienną w 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. 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 - Aktualizuj tylko w przypadku zmiany
boolean. Opcjonalny. Użyj polecenia , gdy updateType = Manifest versions. Wartość domyślna: false.

Dołącza sufiks nowej wersji tylko do pakietów, które zostały zmienione z poprzedniej kompilacji. Jeśli nie zostaną znalezione żadne zmiany, zostanie dodany 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 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 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 ta wartość logiczna porównuje pliki w pakiecie tylko do momentu znalezienia pierwszej zmiany w celu uzyskania szybszej wydajności.

compareType - Porównanie 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 należy porównać z ostatnio 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 do 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żka 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.

imageDigestsPath - Ścieżka skrótów obrazów
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ć zwracany 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 sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

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.

Uwaga

To zadanie wymaga 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:

1. Wersja manifestu: Aktualizacje Service i Wersje aplikacji określone 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.

2. Ustawienia obrazu platformy Docker: Aktualizacje 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

• *Zadanie wdrażania aplikacji usługi Service Fabric

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości 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 w formie tabeli settable	Dowolne
Wersja agenta	1.95.0 lub nowsza
Kategoria zadania	Narzędzie