Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для развертывания приложения 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
-
ТаймаутСек
string. Необязательно. Используется при overridePublishProfileSettings = true && isUpgrade = true.
ForceRestart
-
ForceRestart
boolean. Необязательно. Используется при overridePublishProfileSettings = true && isUpgrade = true. Значение по умолчанию: false.
HealthCheckRetryTimeoutSec
-
HealthCheckRetryTimeoutSec
string. Необязательно. Используется при overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.
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
-
РассмотретьПредупреждениеКак Ошибка
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
-
Тип услугиЗдоровьеПолитикаКарта
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 в кластере. Эта задача развертывает приложение Azure Service Fabric в кластере в соответствии с параметрами, определенными в профиле публикации.
Service Fabric
Эта задача использует установку Service Fabric для подключения и развертывания в кластере Service Fabric. скачайте и установите Service Fabric в агенте сборки.
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка, классический выпуск |
| Выполняется в | Агент, DeploymentGroup |
| требования | Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: Cmd |
| возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | 1.95.0 или более поздней версии |
| Категория задач | Внедрять |