在組建管線中使用這項工作，自動更新已封裝 Service Fabric 應用程式的版本。 此工作會將版本後綴附加至 Azure Service Fabric 應用程式套件中指令清單檔案中指定的所有服務和應用程式版本。
語法
# 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.
輸入
updateType
-
更新類型
string。 必須的。 允許的值：Manifest versions、Docker image settings。 預設值：Manifest versions。
指定應該對指令清單檔進行的更新類型。 若要使用這兩種更新類型，請將這項工作的實例新增至要執行之每個更新類型的建置管線。
applicationPackagePath
-
應用程式套件
string。 必須的。
指定應用程式封裝的路徑。
變數 和通配符可以在路徑中使用。
applicationPackagePath 不能有尾端斜線，\ 或 /。
versionSuffix
-
版本值
string。
updateType = Manifest versions時為必要項。 預設值：.$(Build.BuildNumber)。
指定指令清單檔案中的版本。
小提示
您可以直接修改組建編號格式，或使用記錄命令，以格式動態設定變數。 例如，您可以使用 PowerShell 工作中定義的 $(VersionSuffix)：
$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"
versionBehavior
-
版本行為
string。 選擇性。
updateType = Manifest versions時使用 。 允許的值：Append、Replace。 預設值：Append。
指定是否要將版本值附加至指令清單檔案中的現有值，或加以取代。
只有在變更時，才 updateOnlyChanged - 更新
boolean。 選擇性。
updateType = Manifest versions時使用 。 預設值：false。
將新版本後綴附加至只有先前組建變更的套件。 如果找不到任何變更，則會附加上一個組建的版本後綴。
備註
編譯程式預設會建立不同的輸出，即使沒有任何變更也一樣。 使用 具決定性編譯程式旗標，以確保具有相同輸入的組建會產生相同的輸出。
pkgArtifactName
-
套件成品名稱
string。 選擇性。
updateType = Manifest versions && updateOnlyChanged = true時使用 。
指定要比較之應用程式套件的成品名稱。
logAllChanges
-
記錄所有變更
boolean。 選擇性。
updateType = Manifest versions && updateOnlyChanged = true時使用 。 預設值：true。
比較每個套件中的所有檔案，並在檔案已新增、移除或內容變更時記錄。 否則，這個布爾值只會比較封裝中的檔案，直到找到第一個變更，以獲得更快的效能。
compareType
-
比較與
string。 選擇性。
updateType = Manifest versions && updateOnlyChanged = true時使用 。 允許的值：LastSuccessful（上次成功建置）、Specific（特定組建）。 預設值：LastSuccessful。
指定是否要與上次完成和成功建置或與特定組建進行比較。
buildNumber
-
組建編號
string。 選擇性。
updateType = Manifest versions && compareType = Specific時使用 。
指定要比較的組建編號。
overwriteExistingPkgArtifact
-
覆寫現有的封裝成品
boolean。 選擇性。
updateType = Manifest versions && updateOnlyChanged = true時使用 。 預設值：true。
下載成品的新複本。 否則，如果存在，這個布爾值會使用現有的複本。
imageNamesPath
-
映射名稱路徑
string。 選擇性。
updateType = Docker image settings時使用 。
指定文本文件的路徑，其中包含應該使用摘要更新之 Service Fabric 應用程式相關聯的 Docker 映射名稱。 每個映像名稱必須位於自己的行上，而且必須與 Image Digests 檔案中的摘要順序相同。 如果映像是由 Service Fabric 專案所建立，則此檔案會作為套件目標的一部分產生，而且其輸出位置是由 屬性 BuiltDockerImagesFilePath所控制。
imageDigestsPath
-
影像摘要路徑
string。
updateType = Docker image settings時為必要項。
指定文本文件的路徑，其中包含與 Service Fabric 應用程式相關聯的 Docker 映射摘要值。 使用推送動作時，Docker 工作可以輸出此檔案。 檔案應該包含格式為 registry/image_name@digest_value的文字行。
工作控制選項
除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。
備註
在組建管線中使用這項工作，自動更新已封裝 Service Fabric 應用程式的版本。 此工作會將版本後綴附加至 Azure Service Fabric 應用程式套件中指令清單檔案中指定的所有服務和應用程式版本。
備註
這項工作需要 Windows PowerShell。
發行 管線中無法使用這項工作。
此工作只能在組建管線中使用，以自動更新已封裝 Service Fabric 應用程式的版本。
此工作支援兩種類型的更新：
指令清單版本：更新 Service Fabric 應用程式套件中指令清單檔案中指定的服務和應用程式版本。 如果指定，
manifest version會比較目前的檔案與先前的組建，並只針對那些已變更的服務更新版本。Docker 映像設定：更新 Service Fabric 應用程式套件中指令清單檔案中指定的 Docker 容器映射設定。 要放置的影像設定會從兩個檔案中挑選：
一。 映射名稱檔案：建置工作會產生此檔案。
b。 映射摘要檔案：此檔案會在將映射推送至登錄時由 Docker 工作產生。