ServiceFabricUpdateAppVersions@1— обновление задачи "Версии приложений Service Fabric версии 1"

Статья
2025-03-24

Эта задача используется в конвейере сборки для автоматического обновления версий упаковаемого приложения 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).

Значение, используемое для указания версии в файлах манифеста.

Подсказка

Можно изменить формат номера сборки напрямую или использовать команду ведения журнала для динамического задания переменной в любом формате. Например, можно использовать $(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
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.95.0 или более поздней версии
Категория задач	Полезность