ServiceFabricDeploy@1 — задача развертывания приложения Service Fabric версии 1

Используйте эту задачу для развертывания приложения Service Fabric в кластере. Эта задача развертывает приложение Azure Service Fabric в кластере в соответствии с параметрами, определенными в профиле публикации.

Примечание

Эта задача не поддерживает проверку подлинности azure Resource Manager с федерацией удостоверений рабочих процессов.

Синтаксис

# Service Fabric application deployment v1
# Deploy an Azure Service Fabric application to a cluster.
- task: ServiceFabricDeploy@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    serviceConnectionName: # string. Required. Cluster Service Connection. 
    #publishProfilePath: # string. Publish Profile. 
    #applicationParameterPath: # string. Application Parameters. 
    #overrideApplicationParameter: false # boolean. Override Application Parameters. Default: false.
  # Advanced Settings
    #compressPackage: false # boolean. Compress Package. Default: false.
    #copyPackageTimeoutSec: # string. CopyPackageTimeoutSec. 
    #registerPackageTimeoutSec: # string. RegisterPackageTimeoutSec. 
    overwriteBehavior: 'SameAppTypeAndVersion' # 'Always' | 'Never' | 'SameAppTypeAndVersion'. Required. Overwrite Behavior. Default: SameAppTypeAndVersion.
    #skipUpgradeSameTypeAndVersion: false # boolean. Skip upgrade for same Type and Version. Default: false.
    #skipPackageValidation: false # boolean. Skip package validation. Default: false.
  # Upgrade Settings
    #useDiffPackage: false # boolean. Use Diff Package. Default: false.
    #overridePublishProfileSettings: false # boolean. Override All Publish Profile Upgrade Settings. Default: false.
    #isUpgrade: true # boolean. Optional. Use when overridePublishProfileSettings = true. Upgrade the Application. Default: true.
    #unregisterUnusedVersions: true # boolean. Unregister Unused Versions. Default: true.
    #upgradeMode: 'Monitored' # 'Monitored' | 'UnmonitoredAuto' | 'UnmonitoredManual'. Required when overridePublishProfileSettings = true && isUpgrade = true. Upgrade Mode. Default: Monitored.
    #FailureAction: 'Rollback' # 'Rollback' | 'Manual'. Required when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. FailureAction. Default: Rollback.
    #UpgradeReplicaSetCheckTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. UpgradeReplicaSetCheckTimeoutSec. 
    #TimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. TimeoutSec. 
    #ForceRestart: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. ForceRestart. Default: false.
    #HealthCheckRetryTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckRetryTimeoutSec. 
    #HealthCheckWaitDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckWaitDurationSec. 
    #HealthCheckStableDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckStableDurationSec. 
    #UpgradeDomainTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeDomainTimeoutSec. 
    #ConsiderWarningAsError: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ConsiderWarningAsError. Default: false.
    #DefaultServiceTypeHealthPolicy: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. DefaultServiceTypeHealthPolicy. 
    #MaxPercentUnhealthyDeployedApplications: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. MaxPercentUnhealthyDeployedApplications. 
    #UpgradeTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeTimeoutSec. 
    #ServiceTypeHealthPolicyMap: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ServiceTypeHealthPolicyMap. 
  # Docker Settings
    #configureDockerSettings: false # boolean. Configure Docker settings. Default: false.
    #registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword'. Required when configureDockerSettings = true. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Required when configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Password Encrypted. Default: true.

Входные данные

applicationPackagePath - Пакет приложения
string. Обязательный.

Указывает путь к пакету приложения, который требуется развернуть. В пути можно использовать переменные и подстановочные знаки.

serviceConnectionName - Подключение к службе кластера
string. Обязательный.

Указывает подключение службы Azure Service Fabric, которое будет использоваться для подключения к кластеру. Параметры, определенные в этом упоминаемом подключении службы, переопределяют параметры, определенные в профиле публикации. Выберите Manage регистрацию нового подключения к службе.

Для подключения к кластеру задача Service Fabric использует хранилище сертификатов компьютера для хранения сведений о сертификате. Если два выпуска выполняются вместе на одном компьютере с использованием одного сертификата, они запускаются должным образом. Однако если одна из задач завершена, сертификат из хранилища сертификатов компьютера будет очищен, что повлияет на второй выпуск.

publishProfilePath - Профиль публикации
string.

Необязательный элемент. Указывает путь к файлу профиля публикации, который определяет используемые параметры. В пути можно использовать переменные и подстановочные знаки. Узнайте больше о создании профилей публикации в Visual Studio.

applicationParameterPath - Параметры приложения
string.

Необязательный элемент. Указывает путь к файлу параметров приложения. В пути можно использовать переменные и подстановочные знаки. Если этот параметр указан, это переопределяет значение в профиле публикации. Узнайте больше о том, как создать файл параметров приложения в Visual Studio.

overrideApplicationParameter - Переопределение параметров приложения
boolean. Значение по умолчанию: false.

Необязательный элемент. Указывает, что переменные, определенные в конвейере сборки или выпуска, сопоставляются с Parameter Name записями в файле манифеста приложения. Узнайте больше о том, как создать файл параметров приложения в Visual Studio. Пример

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Если приложение имеет параметр, определенный как в приведенном выше примере, и вы хотите изменить число секций на 2, можно определить конвейер выпуска или переменную SampleApp_PartitionCount среды и его значение как 2.

Примечание

Если одни и те же переменные определены в конвейере выпуска и в среде, переменные среды будут заменять переменные конвейера выпуска.

compressPackage - Сжатие пакета
boolean. Значение по умолчанию: false.

Необязательный элемент. Указывает, следует ли сжать пакет приложения перед копированием в хранилище образов. Если этот параметр включен, это переопределяет значение в профиле публикации. Дополнительные сведения о сжатии пакетов.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Необязательный элемент. Указывает время ожидания в секундах для копирования пакета приложения в хранилище образов. Если этот параметр указан, это переопределяет значение в профиле публикации.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Необязательный элемент. Указывает время ожидания в секундах для регистрации или отмены регистрации пакета приложения.

overwriteBehavior - Поведение перезаписи
string. Обязательный. Допустимые значения: Always, Never, SameAppTypeAndVersion. Значение по умолчанию: SameAppTypeAndVersion.

Перезаписывает поведение, если в кластере существует приложение с тем же именем и обновления не настроены.

Never не удаляет существующее приложение. Это поведение по умолчанию.

Always удалит существующее приложение, даже если его тип и версия приложения отличаются от создаваемого приложения.

SameAppTypeAndVersion удаляет существующее приложение только в том случае, если его тип и версия приложения совпадают с типом создаваемого приложения.

skipUpgradeSameTypeAndVersion - Пропустить обновление для одного типа и версии
boolean. Значение по умолчанию: false.

Необязательный элемент. Указывает, будет ли обновление пропущено, если тот же тип приложения и версия уже существуют в кластере; в противном случае обновление завершается ошибкой во время проверки. Если этот параметр включен, повторное развертывание является идемпотентным.

skipPackageValidation - Пропустить проверку пакета
boolean. Значение по умолчанию: false.

Необязательный элемент. Указывает, следует ли проверять пакет перед развертыванием. Дополнительные сведения о проверке пакетов.

useDiffPackage - Использование пакета Diff
boolean. Значение по умолчанию: false.

Необязательный элемент. Обновляется с помощью пакета diff, который содержит только обновленные файлы приложения, обновленный манифест приложения и файлы манифеста службы.

Пакет diff создается путем сравнения пакета, указанного во входных данных пакета приложения, с пакетом, который в настоящее время зарегистрирован в целевом кластере. Если версия службы в текущем пакете кластера совпадает с новым пакетом, этот пакет службы будет удален из нового пакета приложения. Дополнительные сведения о пакетах diff.

overridePublishProfileSettings - Переопределение всех параметров обновления профиля публикации
boolean. Значение по умолчанию: false.

Необязательный элемент. Переопределяет все параметры обновления указанными значениями или значением по умолчанию (если не указано). Дополнительные сведения о параметрах обновления.

isUpgrade - Обновление приложения
boolean. Необязательный элемент. Используйте при overridePublishProfileSettings = true. Значение по умолчанию: true.

Перезаписывает приложение, если задано falseзначение .

unregisterUnusedVersions - Отмена регистрации неиспользуемых версий
boolean. Значение по умолчанию: true.

Необязательный элемент. Указывает, будут ли удалены все неиспользуемые версии типа приложения после обновления.

upgradeMode - Режим обновления
string. Требуется, если overridePublishProfileSettings = true && isUpgrade = true. Допустимые значения: Monitored, UnmonitoredAuto, UnmonitoredManual. Значение по умолчанию: Monitored.

FailureAction - FailureAction
string. Требуется, если overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Допустимые значения: Rollback, Manual. Значение по умолчанию: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true. Значение по умолчанию: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsiderWarningAsError
boolean. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Значение по умолчанию: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Необязательный элемент. Используйте при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Настройка параметров Docker
boolean. Значение по умолчанию: false.

Настраивает приложение с указанными параметрами Docker.

registryCredentials - Источник учетных данных реестра
string. Требуется, если configureDockerSettings = true. Допустимые значения: AzureResourceManagerEndpoint (Подключение к службе Azure Resource Manager), ContainerRegistryEndpoint (подключение к службе реестра контейнеров), UsernamePassword (имя пользователя и пароль). Значение по умолчанию: AzureResourceManagerEndpoint.

Указывает способ предоставления учетных данных для реестра Docker.

dockerRegistryConnection - Подключение службы реестра Docker
Входной псевдоним: dockerRegistryEndpoint. string. Требуется, если configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Указывает подключение к службе реестра Docker. Требуется для команд, которые должны пройти проверку подлинности в реестре.

Примечание

Задача пытается зашифровать секрет реестра перед его передачей в кластер Service Fabric. Однако для выполнения задачи требуется, чтобы сертификат сервера кластера был установлен на компьютере агента. Если сертификат отсутствует, секрет реестра не будет зашифрован.

azureSubscription - Подписка Azure
Входной псевдоним: azureSubscriptionEndpoint. string. Требуется, если configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Указывает подписку Azure.

Примечание

Задача попытается зашифровать секрет реестра перед его передачей в кластер Service Fabric. Однако для выполнения задачи требуется, чтобы сертификат сервера кластера был установлен на компьютере агента. Если сертификат отсутствует, секрет реестра не будет зашифрован.

registryUserName - Имя пользователя реестра
string. Необязательный элемент. Используйте при configureDockerSettings = true && registryCredentials = UsernamePassword.

Указывает имя пользователя для реестра Docker.

registryPassword - Пароль реестра
string. Необязательный элемент. Используйте при configureDockerSettings = true && registryCredentials = UsernamePassword.

Указывает пароль для реестра Docker. Если пароль не зашифрован, для его хранения следует использовать настраиваемую переменную секрета конвейера выпуска.

passwordEncrypted - Пароль зашифрован
boolean. Необязательный элемент. Используйте при configureDockerSettings = true && registryCredentials = UsernamePassword. Значение по умолчанию: true.

Зашифруйте пароль с помощью Invoke-ServiceFabricEncryptText. В противном случае сертификат, соответствующий отпечатку сертификата сервера в подключении к службе кластеров, установлен в агенте сборки, этот сертификат будет использоваться для шифрования пароля. В противном случае возникнет ошибка.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Используйте эту задачу для развертывания приложения Service Fabric в кластере. Эта задача развертывает приложение Azure Service Fabric в кластере в соответствии с параметрами, определенными в профиле публикации.

Service Fabric

Эта задача использует установку Service Fabric для подключения и развертывания в кластере Service Fabric. Скачайте и установите Service Fabric в агенте сборки.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: Cmd
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	1.95.0 или более поздней версии
Категория задач	Развертывание