Partilhar via

ServiceFabricDeploy@1 - Tarefa v1 de implantação de aplicativos do Service Fabric

  • Artigo

Use esta tarefa para implantar um aplicativo do Service Fabric em um cluster. Esta 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

Esta tarefa não suporta autenticação do Azure Resource Manager com 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.

Insumos

applicationPackagePath - Pacote de Aplicação
string. Obrigatório.

Especifica o caminho para o pacote de aplicativo a ser implantado. As variáveis e curingas podem ser usadas 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 nesta 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 de malha de serviço usa o armazenamento de certificados da máquina para armazenar as informações sobre o certificado. Se duas versões forem executadas juntas em uma máquina usando o mesmo certificado, elas serão iniciadas corretamente. No entanto, se uma das tarefas for concluída, o certificado do armazenamento de certificados da máquina será limpo, o que afeta 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. As variáveis e curingas podem ser usadas no caminho. Saiba mais sobre como criar perfis de publicação no Visual Studio.


applicationParameterPath - Parâmetros de aplicação
string.

Opcional. Especifica o caminho para o arquivo de parâmetros do aplicativo. As variáveis e curingas podem ser usadas no caminho. Se especificado, isso substitui 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 compilação ou liberação são comparadas com as entradas de 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ê pode definir um pipeline de liberaçã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 liberação e no ambiente, as variáveis de ambiente substituirão as variáveis do pipeline de liberação.


compressPackage - Compress Package
boolean. Valor padrão: false.

Opcional. Especifica se o pacote do aplicativo deve ser compactado antes de copiar para o armazenamento 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 do aplicativo para o armazenamento de imagens. Se especificado, isso substitui 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 aplicativo.


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

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

Never não removerá o aplicativo existente. Este é 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 seu tipo de aplicativo e versão for o mesmo que o aplicativo que está sendo criado.


skipUpgradeSameTypeAndVersion - Ignorar 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á existir no cluster; caso contrário, a atualização falhará durante a validação. Se habilitadas, as reimplantações são idempotentes.


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

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


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

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

Um pacote de comparação é criado comparando o pacote especificado na entrada do pacote do aplicativo com o pacote atualmente registrado no cluster de destino. Se uma versão de serviço no pacote atual do cluster for a mesma que o novo pacote, esse pacote de serviço será removido do novo pacote de aplicativo. 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 configurações de atualização.


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

Substitui o aplicativo se o valor estiver definido como false.


unregisterUnusedVersions - Cancelar o registro de versões não utilizadas
boolean. Valor padrão: true.

Opcional. Indica se todas as versões não utilizadas 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 configurações do Docker
boolean. Valor padrão: false.

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


registryCredentials - Fonte de credenciais do Registro
string. Necessário quando configureDockerSettings = true. Valores permitidos: AzureResourceManagerEndpoint (Conexão de Serviço do Azure Resource Manager), ContainerRegistryEndpoint (Conexão do Serviço de 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 de 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 de malha de serviço. No entanto, a tarefa precisa que o certificado do servidor do cluster seja instalado na máquina do agente. Se o certificado não estiver presente, o segredo do registo não será encriptado.


azureSubscription - de 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 de malha de serviço. No entanto, a tarefa precisa que o certificado do servidor do cluster seja instalado na máquina do agente. Se o certificado não estiver presente, o segredo do registo não será encriptado.


registryUserName - Nome de Utilizador do Registo
string. Opcional. Use quando configureDockerSettings = true && registryCredentials = UsernamePassword.

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


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

Especifica a senha para o registro do Docker. Se a senha não estiver criptografada, você deverá usar uma variável secreta de pipeline de liberaçã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 compilação, esse certificado será usado para criptografar a senha; caso contrário, ocorrerá um erro.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Use esta tarefa para implantar um aplicativo do Service Fabric em um cluster. Esta 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 compilação.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de executar trabalhos que usam essa tarefa: Cmd
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Desplegar