Partilhar via


ServiceFabricComposeDeploy@0 - Tarefa de implementação v0 do Service Fabric Compose

Utilize esta tarefa para implementar uma aplicação Docker Compose num cluster do Service Fabric. Esta tarefa implementa uma aplicação do Azure Service Fabric num cluster de acordo com as definições definidas no ficheiro Compor.

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 - Ligação do Serviço de Cluster
Alias de entrada: serviceConnectionName. string. Obrigatório.

Especifica uma ligação de serviço do Azure Service Fabric a ser utilizada para ligar ao cluster. Opte por Manage registar uma nova ligação de serviço.


composeFilePath - Compor Caminho do Ficheiro
string. Obrigatório. Valor predefinido: **/docker-compose.yml.

Especifica o caminho para o ficheiro de composição que vai ser implementado. As variáveis e carateres universais podem ser utilizados no caminho. Exemplo: $(System.DefaultWorkingDirectory)/**/drop/projectartifacts/**/docker-compose.yml.

Nota

A combinação de ficheiros de composição não é suportada como parte desta tarefa.


applicationName - Nome da Aplicação
string. Obrigatório. Valor predefinido: fabric:/Application1.

Especifica o nome da aplicação do Service Fabric da aplicação implementada. Utilize fabric:/ como prefixo. Os nomes das aplicações num cluster do Service Fabric têm de ser exclusivos.


registryCredentials - Origem de Credenciais do Registo
string. Obrigatório. Valores permitidos: AzureResourceManagerEndpoint (Azure Resource Manager ligação de serviço), ContainerRegistryEndpoint (ligação do serviço Container Registry), UsernamePassword (Nome de Utilizador e Palavra-passe), None. Valor predefinido: AzureResourceManagerEndpoint.

Especifica como as credenciais do registo de contentor do Docker serão fornecidas à tarefa de implementação. Os valores permitidos são:

  • AzureResourceManagerEndpoint(Ligação de serviço do Azure Resource Manager): utiliza azureSubscription para obter um ID e uma chave do principal de serviço para um Azure Container Registry.
  • ContainerRegistryEndpoint (Ligação do serviço do Container Registry): utiliza dockerRegistryConnection para selecionar uma ligação do serviço de registo do Docker. Se um certificado correspondente ao Thumbprint do Certificado de Servidor na Ligação do Serviço de Cluster estiver instalado no agente de compilação, será utilizado para encriptar a palavra-passe; caso contrário, a palavra-passe não será encriptada.
  • UsernamePassword (Nome de utilizador e Palavra-passe): utiliza registryUsername e registryPassword para armazenar o nome de utilizador e a palavra-passe do registo do Docker. As palavras-passe devem ser encriptadas com Invoke-ServiceFabricEncryptText com a opção Password Encrypted . Se as palavras-passe não estiverem encriptadas com Invoke-ServiceFabricEncryptTexte um certificado correspondente ao Thumbprint do Certificado de Servidor na Ligação de Cluster estiver instalado no agente de compilação, o certificado será utilizado para encriptar a palavra-passe. Caso contrário, a palavra-passe não será encriptada e será enviada em texto não encriptado.
  • None: não são fornecidas credenciais de registo. Isto é utilizado para aceder a registos de contentores públicos.

dockerRegistryConnection - Ligação do Serviço de Registo do Docker
Alias de entrada: dockerRegistryEndpointName. string. Opcional. Utilize quando registryCredentials = ContainerRegistryEndpoint.

Especifica uma ligação do serviço de registo do Docker. Se um certificado correspondente ao Thumbprint do Certificado de Servidor na Ligação do Serviço de Cluster estiver instalado no agente de compilação, será utilizado para encriptar a palavra-passe; caso contrário, a palavra-passe não será encriptada.


azureSubscription - Subscrição do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Necessário quando registryCredentials = AzureResourceManagerEndpoint.

Especifica uma subscrição do Azure.


registryUserName - Nome de Utilizador do Registo
string. Opcional. Utilize quando registryCredentials = UsernamePassword.

Especifica o nome de utilizador do registo do Docker.


registryPassword - Palavra-passe do Registo
string. Opcional. Utilize quando registryCredentials = UsernamePassword.

Especifica a palavra-passe do registo do Docker. Se a palavra-passe não estiver encriptada, recomenda-se que utilize uma variável de segredo do pipeline de versão personalizada para armazená-la.


passwordEncrypted - Palavra-passe Encriptada
boolean. Opcional. Utilize quando registryCredentials = UsernamePassword. Valor predefinido: true.

Encripta a palavra-passe com Invoke-ServiceFabricEncryptText. Se não encriptar a palavra-passe e um certificado correspondente ao Thumbprint do Certificado de Servidor na Ligação do Serviço de Cluster estiver instalado no agente de compilação, será utilizado para encriptar a palavra-passe; caso contrário, ocorrerá um erro.


upgrade - Atualizar
boolean. Valor predefinido: false.

Atualiza uma implementação existente em vez de a remover.


deployTimeoutSec - Tempo Limite (s) de Implementação
string.

Especifica o tempo limite, em segundos, para implementar a aplicação.


removeTimeoutSec - Remover Tempo Limite (s)
string.

Especifica o tempo limite, em segundos, para remover uma aplicação existente.


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

Especifica o tempo limite, em segundos, para obter o estado de uma aplicação existente.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para implementar uma aplicação docker-compose num cluster do Service Fabric. Esta tarefa implementa uma aplicação do Azure Service Fabric num cluster de acordo com as definições definidas no ficheiro de composição.

Nota

Esta tarefa está atualmente em pré-visualização e requer uma versão de pré-visualização do Service Fabric que suporte a implementação de composição. Veja Suporte de implementação do Docker Compose no Azure Service Fabric.

Service Fabric

  • Esta tarefa utiliza uma instalação do Service Fabric para ligar e implementar num cluster do Service Fabric.
  • Transfira e instale o SDK do Azure Service Fabric Core no agente de compilação.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: Cmd
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 1.95.0 ou superior
Categoria da tarefa Implementação