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

Статья
03/24/2025

Используйте эту задачу для развертывания приложения 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.

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. Если это не так, и сертификат, соответствующий отпечатку сертификата сервера, в соединении службы кластеров устанавливается в агенте сборки, этот сертификат будет использоваться для шифрования пароля; в противном случае возникнет ошибка.

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

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

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

Нет.

Замечания

Service Fabric

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

Требования

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

Поделиться через

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

Синтаксис

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

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

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

Замечания

Service Fabric

Требования

Обратная связь

Дополнительные ресурсы