ServiceFabricDeploy@1 – Tarefa de implantação de aplicativo do Service Fabric v1

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

Observação

Essa tarefa não dá suporte à autenticação de Resource Manager do Azure com federação de identidade de fluxo de trabalho.

Syntax

# 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.

Entradas

applicationPackagePath - Pacote de Aplicativos
string. Obrigatórios.

Especifica o caminho para o pacote de aplicativos a ser implantado. Variáveis e caracteres curinga podem ser usados no caminho.

serviceConnectionName - Conexão de Serviço de Cluster
string. Obrigatórios.

Especifica a conexão de serviço do Azure Service Fabric a ser usada para se conectar ao cluster. As configurações definidas nessa conexão de serviço referenciada substituem as definidas no perfil de publicação. Escolha Manage registrar uma nova conexão de serviço.

Para se conectar ao cluster, a tarefa do Service Fabric usa o repositório de certificados do computador para armazenar as informações sobre o certificado. Se duas versões forem executadas juntas em um computador usando o mesmo certificado, elas serão iniciadas corretamente. No entanto, se uma das tarefas for concluída, o certificado do repositório de certificados do computador será limpo, o que afetará a segunda versão.

publishProfilePath - Publicar Perfil
string.

Opcional. Especifica o caminho para o arquivo de perfil de publicação que define as configurações a serem usadas. Variáveis e caracteres curinga podem ser usados no caminho. Saiba mais sobre como criar perfis de publicação no Visual Studio.

applicationParameterPath - Parâmetros de aplicativo
string.

Opcional. Especifica o caminho para o arquivo de parâmetros do aplicativo. Variáveis e caracteres curinga podem ser usados no caminho. Se especificado, isso substituirá o valor no perfil de publicação. Saiba mais sobre como criar um arquivo de parâmetros de aplicativo no Visual Studio.

overrideApplicationParameter - Substituir parâmetros de aplicativo
boolean. Valor padrão: false.

Opcional. Especifica que as variáveis definidas no pipeline de build ou lançamento são correspondidas Parameter Name às entradas no arquivo de manifesto do aplicativo. Saiba mais sobre como criar um arquivo de parâmetros de aplicativo no Visual Studio. Exemplo:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Se o aplicativo tiver um parâmetro definido como no exemplo acima e você quiser alterar a contagem de partições para 2, você poderá definir um pipeline de lançamento ou uma variável SampleApp_PartitionCount de ambiente e seu valor como 2.

Observação

Se as mesmas variáveis forem definidas no pipeline de lançamento e no ambiente, as variáveis de ambiente substituirão as variáveis de pipeline de lançamento.

compressPackage - Compactar Pacote
boolean. Valor padrão: false.

Opcional. Especifica se o pacote de aplicativos deve ser compactado antes de copiar para o repositório de imagens. Se habilitado, isso substitui o valor no perfil de publicação. Saiba mais sobre como compactar pacotes.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Opcional. Especifica o tempo limite em segundos para copiar o pacote de aplicativos para o repositório de imagens. Se especificado, isso substituirá o valor no perfil de publicação.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Opcional. Especifica o tempo limite em segundos para registrar ou cancelar o registro de um pacote de aplicativos.

overwriteBehavior - Comportamento de substituição
string. Obrigatórios. Valores permitidos: Always, Never, SameAppTypeAndVersion. Valor padrão: SameAppTypeAndVersion.

Substitui o comportamento se um aplicativo existir no cluster com o mesmo nome e as atualizações não tiverem sido configuradas.

Never não removerá o aplicativo existente. Esse é o comportamento padrão.

Always removerá o aplicativo existente, mesmo que seu tipo de aplicativo e versão sejam diferentes do aplicativo que está sendo criado.

SameAppTypeAndVersion removerá o aplicativo existente somente se o tipo de aplicativo e a versão forem os mesmos que o aplicativo que está sendo criado.

skipUpgradeSameTypeAndVersion - Ignorar a atualização para o mesmo tipo e versão
boolean. Valor padrão: false.

Opcional. Especifica se uma atualização será ignorada se o mesmo tipo de aplicativo e versão já existirem no cluster; caso contrário, a atualização falhará durante a validação. Se habilitadas, as reimplantações serão idempotentes.

skipPackageValidation - Ignorar validação de pacote
boolean. Valor padrão: false.

Opcional. Especifica se o pacote deve ser validado ou não antes da implantação. Saiba mais sobre a validação do pacote.

useDiffPackage - Usar pacote Diff
boolean. Valor padrão: false.

Opcional. Atualiza usando um pacote diff que contém apenas os arquivos de aplicativo atualizados, o manifesto do aplicativo atualizado e os arquivos de manifesto do serviço.

Um pacote diff é criado comparando o pacote especificado na entrada do pacote de aplicativos com o pacote registrado no momento no cluster de destino. Se uma versão de serviço no pacote atual do cluster for a mesma do novo pacote, esse pacote de serviço será removido do novo pacote de aplicativos. Saiba mais sobre pacotes de comparação.

overridePublishProfileSettings - Substituir todas as configurações de atualização de perfil de publicação
boolean. Valor padrão: false.

Opcional. Substitui todas as configurações de atualização com valores especificados ou o valor padrão (se não especificado). Saiba mais sobre as configurações de atualização.

isUpgrade - Atualizar o aplicativo
boolean. Opcional. Use quando overridePublishProfileSettings = true. Valor padrão: true.

Substituirá o aplicativo se o valor for definido como false.

unregisterUnusedVersions - Versões não registradas não registradas
boolean. Valor padrão: true.

Opcional. Indica se todas as versões não utilizados do tipo de aplicativo serão removidas após uma atualização.

upgradeMode - Modo de Atualização
string. Obrigatório quando overridePublishProfileSettings = true && isUpgrade = true. Valores permitidos: Monitored, UnmonitoredAuto, UnmonitoredManual. Valor padrão: Monitored.

FailureAction - Failureaction
string. Obrigatório quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valores Permitidos: Rollback e Manual. Valor padrão: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true. Valor padrão: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - ConsidereWarningAsError
boolean. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valor padrão: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Opcional. Use quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Definir configurações do Docker
boolean. Valor padrão: false.

Define o aplicativo com as configurações especificadas do Docker.

registryCredentials - Fonte de Credenciais do Registro
string. Obrigatório quando configureDockerSettings = true. Valores permitidos: AzureResourceManagerEndpoint (Conexão de Serviço Resource Manager do Azure), ContainerRegistryEndpoint (Conexão de Serviço do Registro de Contêiner) UsernamePassword (Nome de usuário e senha). Valor padrão: AzureResourceManagerEndpoint.

Especifica como as credenciais do Registro do Docker são fornecidas.

dockerRegistryConnection - Conexão do Serviço de Registro do Docker
Alias de entrada: dockerRegistryEndpoint. string. Obrigatório quando configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Especifica uma conexão de serviço do Registro do Docker. Obrigatório para comandos que precisam ser autenticados com um registro.

Observação

A tarefa tenta criptografar o segredo do Registro antes de transmiti-lo para o cluster do service fabric. No entanto, a tarefa precisa que o certificado do servidor do cluster seja instalado no computador do agente. Se o certificado não estiver presente, o segredo do Registro não será criptografado.

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

Especifica uma assinatura do Azure.

Observação

A tarefa tentará criptografar o segredo do Registro antes de transmiti-lo para o cluster do service fabric. No entanto, a tarefa precisa que o certificado do servidor do cluster seja instalado no computador do agente. Se o certificado não estiver presente, o segredo do Registro não será criptografado.

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

Especifica o nome de usuário do Registro do Docker.

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

Especifica a senha do Registro do Docker. Se a senha não estiver criptografada, você deverá usar uma variável de segredo de pipeline de versão personalizada para armazená-la.

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

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

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 do Service Fabric em um cluster. Essa tarefa implanta um aplicativo do Azure Service Fabric em um cluster de acordo com as configurações definidas no perfil de publicação.

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 Service Fabric no agente de build.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
É executado 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