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.
Nota
Esta tarefa não suporta a autenticação do Azure Resource Manager com a federação de identidade do fluxo de trabalho.
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): utilizaazureSubscription
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): utilizadockerRegistryConnection
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): utilizaregistryUsername
eregistryPassword
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çãoPassword Encrypted
. Se as palavras-passe não estiverem encriptadas comInvoke-ServiceFabricEncryptText
e 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 |