ServiceFabricUpdateManifests@2 - 更新 Service Fabric 資訊清單 v2 工作

在組建管線中使用這項工作，以自動更新已封裝 Service Fabric 應用程式的版本。 此工作會將版本尾碼附加至 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.

輸入

updateType - 更新類型
string. 必要。 允許值：Manifest versions 和 Docker image settings。 預設值：Manifest versions。

指定應該對資訊清單檔進行的更新類型。 若要同時使用這兩種更新類型，請將這項工作的實例新增至要執行之每種更新類型的組建管線。

applicationPackagePath - 應用程式套件
string. 必要。

指定應用程式封裝的路徑。 變數 和萬用字元可以在路徑中使用。 applicationPackagePath 不得有尾端斜線或 \/ 。

versionSuffix - 版本值
string. 需要 。 updateType = Manifest versions 預設值：.$(Build.BuildNumber)。

指定資訊清單檔中的版本。

提示

您可以直接修改組建編號格式，或使用記錄命令，以格式動態設定變數。 例如，您可以使用 $(VersionSuffix) PowerShell 工作中定義的 ：

$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 映射名稱。 每個影像名稱必須位於自己的行上，而且必須與影像摘要檔案中的摘要順序相同。 如果映射是由 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 應用程式的版本。

此工作支援兩種類型的更新：

1. 資訊清單版本：更新 Service Fabric 應用程式套件中資訊清單檔中指定的服務和應用程式版本。 如果指定， manifest version 請比較目前的檔案與先前的組建，並只針對這些已變更的服務更新版本。

2. Docker 映射設定：更新 Service Fabric 應用程式套件中資訊清單檔中指定的 Docker 容器映射設定。 要放置的映射設定會從兩個檔案中挑選：

   a. 映射名稱檔案：此檔案是由建置工作產生。

   b. 映射摘要檔案：此檔案會在將映射推送至登錄時由 Docker 工作產生。

範例

• *Service Fabric 應用程式部署工作

規格需求

需求	描述
管線類型	YAML、傳統組建
在 上執行	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的作業：Cmd
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
可設定變數	任意
代理程式版本	1.95.0 或更新版本
工作類別	公用程式