ServiceFabricComposeDeploy@0 – Tarefa de implantação de composição do Service Fabric v0

Use essa tarefa para implantar um aplicativo Docker Compose em um cluster do Service Fabric. Essa tarefa implanta um aplicativo do Azure Service Fabric em um cluster de acordo com as configurações definidas no arquivo Compose.

Syntax

# 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).
# Service Fabric Compose Deploy v0
# Deploy a docker-compose application to a 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).

Entradas

clusterConnection - Conexão do Serviço de Cluster
Alias de entrada: serviceConnectionName. string. Obrigatórios.

Especifica uma conexão de serviço do Azure Service Fabric a ser usada para se conectar ao cluster. Escolha Manage registrar uma nova conexão de serviço.


composeFilePath - Compor caminho de arquivo
string. Obrigatórios. Valor padrão: **/docker-compose.yml.

Especifica o caminho para o arquivo de composição a ser implantado. Variáveis e curingas podem ser usados no caminho. Exemplo: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Observação

Não há suporte para a combinação de arquivos de redação como parte dessa tarefa.


applicationName - Nome do Aplicativo
string. Obrigatórios. Valor padrão: fabric:/Application1.

Especifica o nome do aplicativo do Service Fabric do aplicativo implantado. Use fabric:/ como prefixo. Os nomes de aplicativos em um cluster do Service Fabric devem ser exclusivos.


registryCredentials - Origem das Credenciais do Registro
string. Obrigatórios. Valores permitidos: AzureResourceManagerEndpoint (conexão de serviço do Azure Resource Manager), ContainerRegistryEndpoint (conexão de serviço do Registro de Contêiner), UsernamePassword (Nome de usuário e senha), None. Valor padrão: AzureResourceManagerEndpoint.

Especifica como as credenciais para o registro de contêiner do Docker serão fornecidas para a tarefa de implantação. Os valores permitidos são:

  • AzureResourceManagerEndpoint(Conexão de serviço Resource Manager do Azure): usa azureSubscription para obter uma ID e uma chave de entidade de serviço para um Registro de Contêiner do Azure.
  • ContainerRegistryEndpoint (Conexão de serviço do Registro de Contêiner): usa dockerRegistryConnection para selecionar uma conexão de serviço do Registro do Docker. Se um certificado correspondente à Impressão Digital do Certificado do Servidor na Conexão do Serviço de Cluster estiver instalado no agente de build, ele será usado para criptografar a senha; caso contrário, a senha não será criptografada.
  • UsernamePassword (Nome de usuário e senha): usa registryUsername e registryPassword para armazenar o nome de usuário e a senha para o registro do Docker. As senhas devem ser criptografadas usando Invoke-ServiceFabricEncryptText com a opção Password Encrypted . Se as senhas não forem criptografadas com Invoke-ServiceFabricEncryptTexte um certificado correspondente à Impressão Digital do Certificado do Servidor na Conexão de Cluster estiver instalado no agente de build, o certificado será usado para criptografar a senha. Caso contrário, a senha não será criptografada e será enviada em texto não criptografado.
  • None: nenhuma credencial do Registro é fornecida. Isso é usado para acessar registros de contêiner públicos.

dockerRegistryConnection - Conexão do Serviço de Registro do Docker
Alias de entrada: dockerRegistryEndpointName. string. Opcional. Use quando registryCredentials = ContainerRegistryEndpoint.

Especifica uma conexão de serviço do Registro do Docker. Se um certificado correspondente à Impressão Digital do Certificado do Servidor na Conexão do Serviço de Cluster estiver instalado no agente de build, ele será usado para criptografar a senha; caso contrário, a senha não será criptografada.


azureSubscription - Assinatura do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Obrigatório quando registryCredentials = AzureResourceManagerEndpoint.

Especifica uma assinatura do Azure.


registryUserName - Nome de Usuário do Registro
string. Opcional. Use quando registryCredentials = UsernamePassword.

Especifica o nome de usuário para o registro do Docker.


registryPassword - Senha do Registro
string. Opcional. Use quando registryCredentials = UsernamePassword.

Especifica a senha do Registro do Docker. Se a senha não estiver criptografada, é recomendável que você use uma variável de segredo de pipeline de lançamento personalizada para armazená-la.


passwordEncrypted - Senha Criptografada
boolean. Opcional. Use quando registryCredentials = UsernamePassword. Valor padrão: true.

Criptografa sua senha usando Invoke-ServiceFabricEncryptText. Se você não criptografar sua senha e um certificado correspondente à Impressão Digital do Certificado do Servidor na Conexão do Serviço de Cluster estiver instalado no agente de build, ele será usado para criptografar a senha; caso contrário, ocorrerá um erro.


upgrade - Atualização
boolean. Valor padrão: false.

Atualiza uma implantação existente em vez de removê-la.


deployTimeoutSec - Implantar Tempo Limite (s)
string.

Especifica o tempo limite, em segundos, para implantar o aplicativo.


removeTimeoutSec - Remover Tempo Limite (s)
string.

Especifica o tempo limite, em segundos, para remover um aplicativo existente.


getStatusTimeoutSec - Obter Tempo Limite de Status (s)
string.

Especifica o tempo limite, em segundos, para obter o status de um aplicativo existente.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa para implantar um aplicativo Docker-compose em um cluster do Service Fabric. Essa tarefa implanta um aplicativo do Azure Service Fabric em um cluster de acordo com as configurações definidas no arquivo de composição.

Observação

Essa tarefa está atualmente em versão prévia e requer uma versão prévia do Service Fabric que dê suporte à implantação de composição. Confira Suporte à implantação do Docker Compose no Azure Service Fabric.

Service Fabric

  • Essa tarefa usa uma instalação do Service Fabric para se conectar e implantar em um cluster do Service Fabric.
  • Baixe e instale o SDK do Azure Service Fabric Core no agente de build.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: Cmd
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.95.0 ou superior
Categoria da tarefa Implantar