Megosztás a következőn keresztül:


ServiceFabricUpdateManifests@2 – A Service Fabric jegyzékfájljai v2-feladatának frissítése

Ezzel a feladattal egy buildelési folyamatban automatikusan frissítheti a csomagolt Service Fabric-alkalmazások verzióit. Ez a feladat hozzáfűz egy verzió-utótagot a jegyzékfájlokban megadott összes szolgáltatás- és alkalmazásverzióhoz egy Azure Service Fabric-alkalmazáscsomagban.

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.
# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged 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.

Bevitelek

updateType - Frissítés típusa
string. Kötelező. Engedélyezett értékek: Manifest versions, Docker image settings. Alapértelmezett érték: Manifest versions.

Megadja, hogy milyen típusú frissítést kell végezni a jegyzékfájlokon. Mindkét frissítéstípus használatához adja hozzá a feladat egy példányát a buildfolyamathoz az egyes végrehajtandó frissítéstípusokhoz.


applicationPackagePath - Alkalmazáscsomag
string. Kötelező.

Megadja az alkalmazáscsomag elérési útját. Az elérési úton változók és helyettesítő karakterek használhatók. applicationPackagePath A vagy a záró perjele \/nem lehet.


versionSuffix - Verzió értéke
string. Akkor szükséges, ha updateType = Manifest versions. Alapértelmezett érték: .$(Build.BuildNumber).

A jegyzékfájlokban szereplő verziót adja meg.

Tipp

Módosíthatja közvetlenül a buildszámformátumot, vagy egy naplózási paranccsal dinamikusan beállíthat egy változót egy formátumban. Használhatja például $(VersionSuffix) egy PowerShell-feladatban definiálva:

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

versionBehavior - Verzió viselkedése
string. Választható. Használja a következőt: updateType = Manifest versions. Engedélyezett értékek: Append, Replace. Alapértelmezett érték: Append.

Megadja, hogy a verzióértéket hozzá kívánja-e fűzni a jegyzékfájlok meglévő értékeihez, vagy lecserélni őket.


updateOnlyChanged - Csak akkor frissítsen, ha módosult
boolean. Választható. Használja a következőt: updateType = Manifest versions. Alapértelmezett érték: false.

Az új verzió utótagját csak az előző buildben módosított csomagokhoz fűzi hozzá. Ha nem talál módosításokat, a rendszer hozzáfűzi az előző build verzió-utótagját.

Megjegyzés

Alapértelmezés szerint a fordító különböző kimeneteket hoz létre, még akkor is, ha nem történt módosítás. A determinisztikus fordítójelölővel biztosíthatja, hogy az azonos bemenetekkel rendelkező buildek ugyanazokat a kimeneteket eredményezik.


pkgArtifactName - Csomagösszetevő neve
string. Választható. Használja a következőt: updateType = Manifest versions && updateOnlyChanged = true.

Az alkalmazáscsomagot tartalmazó összetevő nevét adja meg összehasonlítás céljából.


logAllChanges - Az összes módosítás naplózása
boolean. Választható. Használja a következőt: updateType = Manifest versions && updateOnlyChanged = true. Alapértelmezett érték: true.

Összehasonlítja az összes csomagban lévő összes fájlt, és naplózza, hogy a fájl hozzá lett-e adva, eltávolítva vagy megváltozott-e a tartalma. Ellenkező esetben ez a logikai érték csak addig hasonlítja össze a csomagban lévő fájlokat, amíg az első módosítás meg nem jelenik a gyorsabb teljesítmény érdekében.


compareType - Összehasonlítás
string. Választható. Használja a következőt: updateType = Manifest versions && updateOnlyChanged = true. Engedélyezett értékek: LastSuccessful (Utolsó sikeres build) Specific (Adott build). Alapértelmezett érték: LastSuccessful.

Meghatározza, hogy az összehasonlítás az utolsó befejezett és sikeres buildel vagy egy adott buildel legyen-e összehasonlítva.


buildNumber - Buildszám
string. Választható. Használja a következőt: updateType = Manifest versions && compareType = Specific.

Az összehasonlítás buildszámát adja meg.


overwriteExistingPkgArtifact - Meglévő csomagösszetevő felülírása
boolean. Választható. Használja a következőt: updateType = Manifest versions && updateOnlyChanged = true. Alapértelmezett érték: true.

Letölti az összetevő új példányát. Ellenkező esetben ez a logikai érték egy meglévő példányt használ, ha van ilyen.


imageNamesPath - Képnevek elérési útja
string. Választható. Használja a következőt: updateType = Docker image settings.

Megadja egy szövegfájl elérési útját, amely tartalmazza a Service Fabric-alkalmazáshoz társított Docker-lemezképek nevét, amelyeket kivonatokkal kell frissíteni. Minden képnévnek a saját sorában kell lennie, és ugyanabban a sorrendben kell lennie, mint az Image Digests fájl kivonatai. Ha a rendszerképeket a Service Fabric-projekt hozza létre, ez a fájl a Csomag célhely részeként jön létre, és a kimeneti helyét a tulajdonság BuiltDockerImagesFilePathszabályozza.


imageDigestsPath - Képkivonatok elérési útja
string. Akkor szükséges, ha updateType = Docker image settings.

Megadja egy szövegfájl elérési útját, amely a Service Fabric-alkalmazáshoz társított Docker-rendszerképek kivonatolási értékeit tartalmazza. Ez a fájl a Docker-feladat kimenete lehet a leküldéses művelet használatakor. A fájlnak szövegsorokat kell tartalmaznia registry/image_name@digest_valuea következő formátumban: .


Tevékenységvezérlési beállítások

A tevékenységbemeneteken kívül minden tevékenység rendelkezik vezérlési lehetőségekkel. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal egy buildelési folyamatban automatikusan frissítheti a csomagolt Service Fabric-alkalmazások verzióit. Ez a feladat hozzáfűz egy verzió-utótagot a jegyzékfájlokban megadott összes szolgáltatás- és alkalmazásverzióhoz egy Azure Service Fabric-alkalmazáscsomagban.

Megjegyzés

Ehhez a feladathoz Windows PowerShell szükséges.

Ez a feladat nem érhető el a kiadási folyamatokban.

Ez a feladat csak buildfolyamatokban használható a csomagolt Service Fabric-alkalmazások verzióinak automatikus frissítéséhez.

Ez a feladat kétféle frissítést támogat:

  1. Jegyzékverzió: Frissítések Service Fabric-alkalmazáscsomag jegyzékfájljaiban megadott szolgáltatás- és alkalmazásverziók. Ha meg van adva, összehasonlítja az aktuális fájlokat egy korábbi buildel, manifest version és csak a módosított szolgáltatásokra frissíti a verziót.

  2. Docker-lemezkép beállításai: Frissítések Service Fabric-alkalmazáscsomag jegyzékfájljaiban megadott Docker-tároló lemezképbeállításai. A elhelyezendő képbeállításokat két fájlból választja ki a rendszer:

    a. Képnévfájl: Ezt a fájlt a buildelési feladat hozza létre.

    b. Képemelő fájl: Ezt a fájlt a docker-feladat hozza létre, amikor leküldi a lemezképeket a beállításjegyzékbe.

Példák

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build
Futtatás: Ügynök, DeploymentGroup
Igények A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: Cmd
Képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Bármelyik
Változók beállítása Bármelyik
Ügynök verziója 1.95.0 vagy újabb
Feladatkategória Segédprogram