ServiceFabricUpdateManifests@2 – Aktualizace úlohy manifestů Service Fabric v2

Pomocí této úlohy v kanálu buildu můžete automaticky aktualizovat verze zabalené aplikace Service Fabric. Tato úloha připojí příponu verze ke všem verzím služby a aplikací zadaným v souborech manifestu v balíčku aplikace Azure Service Fabric.

Syntax

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

Vstupy

updateType - Typ aktualizace
string. Povinná hodnota. Povolené hodnoty: Manifest versions, Docker image settings. Výchozí hodnota: Manifest versions.

Určuje typ aktualizace, která se má provést u souborů manifestu. Pokud chcete použít oba typy aktualizací, přidejte instanci této úlohy do kanálu buildu pro každý typ aktualizace, která se má spustit.

applicationPackagePath - Balíček aplikace
string. Povinná hodnota.

Určuje cestu k balíčku aplikace. V cestě je možné použít proměnné a zástupné é kóty. applicationPackagePathnesmí mít koncové lomítko, ani \ ./

versionSuffix - Hodnota verze
string. Vyžaduje se, když updateType = Manifest versions. Výchozí hodnota: .$(Build.BuildNumber).

Určuje verzi v souborech manifestu.

Tip

Formát čísla sestavení můžete upravit přímo nebo pomocí příkazu protokolování dynamicky nastavit proměnnou ve formátu. Můžete například použít $(VersionSuffix) definici v úloze PowerShellu:

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

versionBehavior - Chování verzí
string. Nepovinný parametr. Použijte, když updateType = Manifest versions. Povolené hodnoty: Append, Replace. Výchozí hodnota: Append.

Určuje, jestli se má hodnota verze připojit k existujícím hodnotám v souborech manifestu, nebo je nahradit.

updateOnlyChanged - Aktualizovat pouze v případě změny
boolean. Nepovinný parametr. Použijte, když updateType = Manifest versions. Výchozí hodnota: false.

Připojí příponu nové verze pouze k balíčkům, které se změnily od předchozího sestavení. Pokud se nenajdou žádné změny, připojí se přípona verze z předchozího buildu.

Poznámka

Ve výchozím nastavení kompilátor vytvoří různé výstupy, i když nebyly provedeny žádné změny. Pomocí příznaku deterministického kompilátoru se ujistěte, že sestavení se stejnými vstupy generují stejné výstupy.

pkgArtifactName - Název artefaktu balíčku
string. Nepovinný parametr. Použijte, když updateType = Manifest versions && updateOnlyChanged = true.

Určuje název artefaktu obsahujícího balíček aplikace pro porovnání.

logAllChanges - Protokolovat všechny změny
boolean. Nepovinný parametr. Použijte, když updateType = Manifest versions && updateOnlyChanged = true. Výchozí hodnota: true.

Porovná všechny soubory v každém balíčku a protokoluje, jestli byl soubor přidán, odebrán nebo se změnil jeho obsah. V opačném případě tato logická hodnota porovnává soubory v balíčku pouze do doby, než se najde první změna, aby se zrychlil výkon.

compareType - Porovnat proti
string. Nepovinný parametr. Použijte, když updateType = Manifest versions && updateOnlyChanged = true. Povolené hodnoty: LastSuccessful (Poslední úspěšné sestavení), Specific (konkrétní sestavení). Výchozí hodnota: LastSuccessful.

Určuje, jestli se má porovnat s posledním dokončeným a úspěšným sestavením, nebo s konkrétním sestavením.

buildNumber - Číslo buildu
string. Nepovinný parametr. Použijte, když updateType = Manifest versions && compareType = Specific.

Určuje číslo sestavení pro porovnání.

overwriteExistingPkgArtifact - Přepsat existující artefakt balíčku
boolean. Nepovinný parametr. Použijte, když updateType = Manifest versions && updateOnlyChanged = true. Výchozí hodnota: true.

Stáhne novou kopii artefaktu. V opačném případě tato logická hodnota použije existující kopii, pokud existuje.

imageNamesPath - Cesta k názvům obrázků
string. Nepovinný parametr. Použijte, když updateType = Docker image settings.

Určuje cestu k textovému souboru, který obsahuje názvy imagí Dockeru přidružených k aplikaci Service Fabric, které by se měly aktualizovat pomocí hodnot hash. Název každého obrázku musí být na samostatném řádku a musí být ve stejném pořadí jako hodnoty hash v souboru Digest obrázku. Pokud image vytváří projekt Service Fabric, tento soubor se vygeneruje jako součást cíle balíčku a jeho umístění výstupu je řízeno vlastností BuiltDockerImagesFilePath.

imageDigestsPath - Cesta k hodnotě Hash obrázku
string. Vyžaduje se, když updateType = Docker image settings.

Určuje cestu k textovému souboru, který obsahuje hodnoty digest imagí Dockeru přidružených k aplikaci Service Fabric. Tento soubor může být výstupem úlohy Dockeru při použití akce nasdílení změn. Soubor by měl obsahovat řádky textu ve formátu registry/image_name@digest_value.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů i možnosti řízení. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Pomocí této úlohy v kanálu buildu můžete automaticky aktualizovat verze zabalené aplikace Service Fabric. Tato úloha připojí příponu verze ke všem verzím služby a aplikací zadaným v souborech manifestu v balíčku aplikace Azure Service Fabric.

Poznámka

Tato úloha vyžaduje Windows PowerShell.

Tato úloha není k dispozici v kanálech verze .

Tuto úlohu je možné použít pouze v kanálu buildu k automatické aktualizaci verzí zabalené aplikace Service Fabric.

Tato úloha podporuje dva typy aktualizací:

1. Verze manifestu: Aktualizace verze služby a aplikace zadané v souborech manifestu v balíčku aplikace Service Fabric. Pokud je zadaný, manifest version porovná aktuální soubory s předchozím buildem a aktualizuje verzi jenom pro tyto změněné služby.

2. Nastavení image Dockeru: Aktualizace nastavení image kontejneru Dockeru zadané v souborech manifestu v balíčku aplikace Service Fabric. Nastavení obrázku, která se mají umístit, se vybírají ze dvou souborů:

   a. Soubor s názvy imagí: Tento soubor generuje úloha sestavení.

   b. Soubor hodnot hash image: Tento soubor vygeneruje úloha Dockeru při odesílání imagí do registru.

Příklady

• *Úloha nasazení aplikace Service Fabric

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: Cmd
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	1.95.0 nebo vyšší
Kategorie úloh	Nástroj