ServiceFabricUpdateAppVersions@1 - 更新 Service Fabric 應用程式版本 v1 工作

發行項
07/02/2024

在組建管線中使用這項工作，以自動更新已封裝 Service Fabric 應用程式的版本。此工作會將版本尾碼附加至 Azure Service Fabric 應用程式套件中資訊清單檔案中指定的所有服務和應用程式版本。

Syntax

# Update Service Fabric App Versions v1
# Automatically updates the versions of a packaged Service Fabric application.
- task: ServiceFabricUpdateAppVersions@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    versionSuffix: '.$(Build.BuildNumber)' # string. Required. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when compareType = Specific. Build Number.

輸入

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

指定要部署至叢集的 Service Fabric 應用程式封裝位置。範例： $(system.defaultworkingdirectory)/**/drop/applicationpackage. 變數和萬用字元可以在路徑中使用。

versionSuffix - 版本值
string. 必要。預設值：.$(Build.BuildNumber)。

值，用來指定資訊清單檔案中的版本。

提示

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

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"

Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - 版本行為
string. 允許值：Append 和 Replace。預設值：Append。

將版本值附加至資訊清單檔案中的現有值，或加以取代。

updateOnlyChanged - 只有在變更時才更新
boolean. 預設值：false。

以累加方式只更新已變更的套件。使用具決定性編譯器旗標來確保具有相同輸入的組建會產生相同的輸出。

pkgArtifactName - 套件成品名稱
string. 選擇性。使用時機 updateOnlyChanged = true 。

指定包含上一個組建之應用程式封裝的成品名稱。

logAllChanges - 記錄所有變更
boolean. 選擇性。使用時機 updateOnlyChanged = true 。預設值：true。

比較每個套件中的所有檔案，並在檔案新增、移除或內容變更時記錄。否則，只會比較套件中的檔案，直到找到第一個變更以加快效能為止。

compareType - 與比較
string. 選擇性。使用時機 updateOnlyChanged = true 。允許的值： LastSuccessful (上次成功建置) ， Specific (特定組建) 。預設值：LastSuccessful。

與最後一個已完成且成功的組建或特定組建進行比較。

buildNumber - 組建編號
string. 選擇性。使用時機 compareType = Specific 。

指定當工作與特定組建比較時要比較的組建編號。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

無。

規格需求

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

共用方式為