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 BuiltDockerImagesFilePath
szabá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_value
a 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:
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.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 |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: