ServiceFabricDeploy@1 – tarefa de implementação da aplicação do Service Fabric v1

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

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

# Service Fabric Application Deployment v1
# Deploy a 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.

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

Especifica o caminho para o pacote de aplicação que vai ser implementado. As variáveis e carateres universais podem ser utilizados no caminho.

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

Especifica a ligação de serviço do Azure Service Fabric a ser utilizada para ligar ao cluster. As definições definidas nesta ligação de serviço referenciada substituem as definidas no perfil de publicação. Opte por Manage registar uma nova ligação de serviço.

Para ligar ao cluster, a tarefa do service fabric utiliza o arquivo de certificados do computador para armazenar as informações sobre o certificado. Se duas versões forem executadas em conjunto num computador com o mesmo certificado, serão iniciadas corretamente. No entanto, se uma das tarefas estiver concluída, o certificado do arquivo de certificados do computador será limpo, o que afeta a segunda versão.

publishProfilePath - Publicar Perfil
string.

Opcional. Especifica o caminho para o ficheiro de perfil de publicação que define as definições a utilizar. As variáveis e carateres universais podem ser utilizados no caminho. Saiba mais sobre como criar perfis de publicação no Visual Studio.

applicationParameterPath - Parâmetros da Aplicação
string.

Opcional. Especifica o caminho para o ficheiro de parâmetros da aplicação. As variáveis e carateres universais podem ser utilizados no caminho. Se for especificado, isto substitui o valor no perfil de publicação. Saiba mais sobre como criar um ficheiro de parâmetros de aplicação no Visual Studio.

overrideApplicationParameter - Substituir Parâmetros da Aplicação
boolean. Valor predefinido: false.

Opcional. Especifica que as variáveis definidas no pipeline de compilação ou versão correspondem às Parameter Name entradas no ficheiro de manifesto da aplicação. Saiba mais sobre como criar um ficheiro de parâmetros de aplicação no Visual Studio. Exemplo:

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

Se a aplicação tiver um parâmetro definido como no exemplo acima e quiser alterar a contagem de partições para 2, pode definir um pipeline de versão ou uma variável SampleApp_PartitionCount de ambiente e o respetivo valor como 2.

compressPackage - Comprimir Pacote
boolean. Valor predefinido: false.

Opcional. Especifica se o pacote de aplicação deve ser comprimido antes de copiar para o arquivo de imagens. Se estiver ativada, esta ação substitui o valor no perfil de publicação. Saiba mais sobre a compressão de pacotes.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Opcional. Especifica o tempo limite em segundos para copiar o pacote de aplicação para o arquivo de imagens. Se for especificado, isto substitui o valor no perfil de publicação.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Opcional. Especifica o tempo limite em segundos para registar ou anular o registo de um pacote de aplicações.

overwriteBehavior - Substituir Comportamento
string. Obrigatório. Valores permitidos: Always, , NeverSameAppTypeAndVersion. Valor predefinido: SameAppTypeAndVersion.

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

Never não removerá a aplicação existente. Este é o comportamento predefinido.

Always irá remover a aplicação existente, mesmo que o tipo de aplicação e a versão sejam diferentes da aplicação que está a ser criada.

SameAppTypeAndVersion removerá a aplicação existente apenas se o tipo de aplicação e a versão forem os mesmos que a aplicação que está a ser criada.

skipUpgradeSameTypeAndVersion - Ignorar a atualização para o mesmo Tipo e Versão
boolean. Valor predefinido: false.

Opcional. Especifica se uma atualização será ignorada se o mesmo tipo de aplicação e versão já existirem no cluster; caso contrário, a atualização falha durante a validação. Se estiver ativada, as implementações são idempotentes.

skipPackageValidation - Ignorar a validação do pacote
boolean. Valor predefinido: false.

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

useDiffPackage - Utilizar o Pacote Diff
boolean. Valor predefinido: false.

Opcional. Atualiza através de um pacote difuso que contém apenas os ficheiros da aplicação atualizados, o manifesto da aplicação atualizado e os ficheiros de manifesto do serviço.

É criado um pacote diferencial ao comparar o pacote especificado na entrada do pacote de aplicação com o pacote que está atualmente registado no cluster de destino. Se uma versão de serviço no pacote atual do cluster for igual ao novo pacote, este pacote de serviço será removido do novo pacote de aplicação. Saiba mais sobre pacotes difusos.

overridePublishProfileSettings - Substituir Todas as Definições de Atualização do Perfil de Publicação
boolean. Valor predefinido: false.

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

isUpgrade - Atualizar a Aplicação
boolean. Opcional. Utilize quando overridePublishProfileSettings = true. Valor predefinido: true.

Substitui a aplicação se o valor estiver definido como false.

unregisterUnusedVersions - Anular o Registo de Versões Não Utilizadas
boolean. Valor predefinido: true.

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

upgradeMode - Modo de Atualização
string. Necessário quando overridePublishProfileSettings = true && isUpgrade = true. Valores permitidos: Monitored, , UnmonitoredAutoUnmonitoredManual. Valor predefinido: Monitored.

FailureAction - FailureAction
string. Necessário quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valores permitidos: Rollback, Manual. Valor predefinido: Rollback.

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

TimeoutSec - Tempo LimiteSec
string. Opcional. Utilize quando overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Opcional. Utilize quando overridePublishProfileSettings = true && isUpgrade = true. Valor predefinido: false.

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

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

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

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

ConsiderWarningAsError - ConsiderarWarningAsError
boolean. Opcional. Utilize quando overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Valor predefinido: false.

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

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

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

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

configureDockerSettings - Configurar as definições do Docker
boolean. Valor predefinido: false.

Configura a aplicação com as definições do Docker especificadas.

registryCredentials - Origem de Credenciais do Registo
string. Necessário quando configureDockerSettings = true. Valores permitidos: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (Container Registry Service Connection) UsernamePassword (Nome de utilizador e Palavra-passe). Valor predefinido: AzureResourceManagerEndpoint.

Especifica a forma como as credenciais do registo do Docker são fornecidas.

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

Especifica uma ligação do serviço de registo do Docker. Necessário para comandos que precisam de ser autenticados com um registo.

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

Especifica uma subscrição do Azure.

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

Especifica o nome de utilizador do registo do Docker.

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

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

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

Deve encriptar a sua palavra-passe com Invoke-ServiceFabricEncryptText. Se não o fizer, 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, esse certificado será utilizado para encriptar a palavra-passe; caso contrário, ocorrerá um erro.

Nenhum.