ServiceFabricComposeDeploy@0 — задача развертывания версии 0 в Service Fabric Compose

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

Примечание

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

Синтаксис

# Service Fabric Compose deploy v0
# Deploy a Docker Compose application to an Azure Service Fabric cluster.
- task: ServiceFabricComposeDeploy@0
  inputs:
    clusterConnection: # string. Alias: serviceConnectionName. Required. Cluster Service Connection. 
    composeFilePath: '**/docker-compose.yml' # string. Required. Compose File Path. Default: **/docker-compose.yml.
    applicationName: 'fabric:/Application1' # string. Required. Application Name. Default: fabric:/Application1.
  # Registry Settings
    registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword' | 'None'. Required. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpointName. Optional. Use when registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when registryCredentials = UsernamePassword. Password Encrypted. Default: true.
  # Advanced Settings
    #upgrade: false # boolean. Upgrade. Default: false.
    #deployTimeoutSec: # string. Deploy Timeout (s). 
    #removeTimeoutSec: # string. Remove Timeout (s). 
    #getStatusTimeoutSec: # string. Get Status Timeout (s).

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

clusterConnection - Подключение к службе кластера
Входной псевдоним: serviceConnectionName. string. Обязательный.

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

composeFilePath - Создание пути к файлу
string. Обязательный. Значение по умолчанию: **/docker-compose.yml.

Указывает путь к файлу compose, который должен быть развернут. В пути можно использовать переменные и подстановочные знаки. Например, $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Примечание

Объединение файлов compose не поддерживается в рамках этой задачи.

applicationName - Имя приложения
string. Обязательный. Значение по умолчанию: fabric:/Application1.

Указывает имя развернутого приложения Service Fabric. Используйте fabric:/ в качестве префикса. Имена приложений в кластере Service Fabric должны быть уникальными.

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

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

• AzureResourceManagerEndpoint(Подключение к службе azure Resource Manager): использует azureSubscription для получения идентификатора и ключа субъекта-службы для Реестр контейнеров Azure.
• ContainerRegistryEndpoint (подключение к службе реестра контейнеров): использует dockerRegistryConnection для выбора подключения к службе реестра Docker. Если в агенте сборки установлен сертификат, соответствующий отпечатку сертификата сервера в подключении к службе кластеров, он будет использоваться для шифрования пароля; В противном случае пароль не будет зашифрован.
• UsernamePassword (Имя пользователя и пароль): использует registryUsername и registryPassword для хранения имени пользователя и пароля для реестра Docker. Пароли должны шифроваться с помощью invoke-ServiceFabricEncryptText с параметром Password Encrypted . Если пароли не шифруются с помощью Invoke-ServiceFabricEncryptText, а в агенте сборки установлен сертификат, соответствующий отпечатку сертификата сервера в подключении к кластеру, сертификат будет использоваться для шифрования пароля. В противном случае пароль не будет зашифрован и будет отправлен в виде ясного текста.
• None: учетные данные реестра не предоставляются. Используется для доступа к общедоступным реестрам контейнеров.

dockerRegistryConnection - Подключение службы реестра Docker
Входной псевдоним: dockerRegistryEndpointName. string. Необязательный элемент. Используйте при registryCredentials = ContainerRegistryEndpoint.

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

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

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

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

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

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

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

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

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

upgrade - Обновления
boolean. Значение по умолчанию: false.

Обновляет существующее развертывание, а не удаляет его.

deployTimeoutSec - Время ожидания развертывания (с)
string.

Указывает время ожидания (в секундах) для развертывания приложения.

removeTimeoutSec - Удалить время ожидания (с)
string.

Указывает время ожидания (в секундах) для удаления существующего приложения.

getStatusTimeoutSec - Получение времени ожидания состояния (с)
string.

Указывает время ожидания (в секундах) для получения состояния существующего приложения.

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

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

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

Нет.

Remarks

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

Примечание

Сейчас эта задача находится на этапе предварительной версии и требует предварительной версии Service Fabric, поддерживающей развертывание compose. См . раздел Поддержка развертывания Docker Compose в Azure Service Fabric.

Service Fabric

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

Требования

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