Compartilhar via

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

  • Artigo

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 a autenticação do Azure Resource Manager comde federação de identidade de fluxo de trabalho.

Sintaxe

# 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

do Pacote de Aplicativos applicationPackagePath -
string. Obrigatório

Especifica o caminho para o pacote de aplicativos que deve ser implantado. Variáveis e curingas podem ser usados no caminho.


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

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


de Perfil de Publicação publishProfilePath -
string.

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


parâmetros de aplicativo applicationParameterPath -
string.

Opcional. Especifica o caminho para o arquivo de parâmetros do aplicativo. Variáveis e curingas 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 às entradas Parameter Name 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 seu 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 versão ou uma variável de ambiente SampleApp_PartitionCount 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 versão.


compressPackage - compactar pacote
boolean. Valor padrão: false.

Opcional. Especifica se o pacote do aplicativo deve ser compactado antes de copiar para o repositório de imagens. Se habilitado, isso substituirá o valor no perfil de publicação. Saiba mais sobre compactando 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 - substituir o comportamento
string. Obrigatório Valores permitidos: Always, Never, SameAppTypeAndVersion. Valor padrão: SameAppTypeAndVersion.

Substitui o comportamento se houver um aplicativo 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 iguais ao aplicativo que está sendo criado.


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

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


skipPackageValidation - Ignorar de 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 de validação de pacote.


useDiffPackage - usar o 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 de diferenciação é 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 de pacotes de diferenciação de.


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 estiver 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. Necessário quando overridePublishProfileSettings = true && isUpgrade = true. Valores permitidos: Monitored, UnmonitoredAuto, UnmonitoredManual. Valor padrão: Monitored.


FailureAction - FailureAction
string. Necessário quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valores permitidos: Rollback, 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 - ConsiderWarningAsError
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 as configurações do Docker
boolean. Valor padrão: false.

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


registryCredentials - de Origem das Credenciais do Registro
string. Necessário quando configureDockerSettings = true. 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). Valor padrão: AzureResourceManagerEndpoint.

Especifica como as credenciais para o registro do Docker são fornecidas.


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

Especifica uma conexão de serviço do Registro do Docker. Necessá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 da malha de serviço. 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. Necessá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 para o registro do Docker.


registryPassword - de 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 - criptografados por senha
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 do 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 de tarefa

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

Variáveis de saída

Nenhum.

Observações

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. Baixar e instalar do Service Fabric no agente de build.

Requisitos

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