次の方法で共有


ServiceFabricUpdateAppVersions@1 - Service Fabric App Versions v1 タスクを更新する

パッケージ化された Service Fabric アプリのバージョンを自動的に更新するには、ビルド パイプラインでこのタスクを使用します。 このタスクは、Azure Service Fabric アプリ パッケージ内のマニフェスト ファイルで指定されたすべてのサービスとアプリのバージョンにバージョン サフィックスを追加します。

構文

# 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)

マニフェスト ファイル内のバージョンを指定するために使用される値。

ヒント

ビルド番号の形式を直接変更することも、ログ コマンドを使用して任意の形式で変数を動的に設定することもできます。 たとえば、PowerShell タスクで定義されている を使用 $(VersionSuffix) できます。

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

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


versionBehavior - バージョンの動作
string. 使用できる値: AppendReplace。 既定値: 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 このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.95.0 以上
タスクのカテゴリ ユーティリティ