ServiceFabricUpdateManifests@2 – Atualizar a tarefa de manifestos do Service Fabric v2

Utilize esta tarefa num pipeline de compilação para atualizar automaticamente as versões de uma aplicação do Service Fabric em pacote. Esta tarefa acrescenta um sufixo de versão a todas as versões do serviço e da aplicação, especificadas nos ficheiros de manifesto, num pacote de aplicações do Azure Service Fabric.

# Update Service Fabric manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

updateType - Tipo de Atualização
string. Obrigatório. Valores permitidos: Manifest versions, Docker image settings. Valor predefinido: Manifest versions.

Especifica o tipo de atualização que deve ser efetuada aos ficheiros de manifesto. Para utilizar ambos os tipos de atualização, adicione uma instância desta tarefa ao pipeline de compilação para que cada tipo de atualização seja executado.

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

Especifica o caminho para o pacote de aplicação. As variáveis e carateres universais podem ser utilizados no caminho. applicationPackagePath não pode ter uma barra à direita ou \/.

versionSuffix - Valor da Versão
string. Necessário quando updateType = Manifest versions. Valor predefinido: .$(Build.BuildNumber).

Especifica a versão nos ficheiros de manifesto.

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - Comportamento da Versão
string. Opcional. Utilize quando updateType = Manifest versions. Valores permitidos: Append, Replace. Valor predefinido: Append.

Especifica se pretende acrescentar o valor da versão aos valores existentes nos ficheiros de manifesto ou substituí-los.

updateOnlyChanged - Atualizar apenas se for alterado
boolean. Opcional. Utilize quando updateType = Manifest versions. Valor predefinido: false.

Acrescenta o sufixo da nova versão apenas aos pacotes que foram alterados de uma compilação anterior. Se não forem encontradas alterações, o sufixo da versão da compilação anterior será acrescentado.

pkgArtifactName - Nome do Artefacto do Pacote
string. Opcional. Utilize quando updateType = Manifest versions && updateOnlyChanged = true.

Especifica o nome do artefacto que contém o pacote de aplicação para comparação.

logAllChanges - Registar todas as alterações
boolean. Opcional. Utilize quando updateType = Manifest versions && updateOnlyChanged = true. Valor predefinido: true.

Compara todos os ficheiros em cada pacote e registo se o ficheiro foi adicionado, removido ou se o respetivo conteúdo foi alterado. Caso contrário, este booleano compara ficheiros num pacote apenas até que a primeira alteração seja encontrada para um desempenho mais rápido.

compareType - Comparar com
string. Opcional. Utilize quando updateType = Manifest versions && updateOnlyChanged = true. Valores permitidos: LastSuccessful (Última Compilação Com Êxito), Specific (Compilação Específica). Valor predefinido: LastSuccessful.

Especifica se pretende comparar com a última compilação concluída e bem-sucedida ou com uma compilação específica.

buildNumber - Número de Compilação
string. Opcional. Utilize quando updateType = Manifest versions && compareType = Specific.

Especifica o número de compilação para comparação.

overwriteExistingPkgArtifact - Substituir Artefacto de Pacote Existente
boolean. Opcional. Utilize quando updateType = Manifest versions && updateOnlyChanged = true. Valor predefinido: true.

Transfere uma nova cópia do artefacto. Caso contrário, este booleano utiliza uma cópia existente, se estiver presente.

imageNamesPath - Caminho dos Nomes de Imagem
string. Opcional. Utilize quando updateType = Docker image settings.

Especifica o caminho para um ficheiro de texto que contém os nomes das imagens do Docker associadas à aplicação do Service Fabric que devem ser atualizados com resumos. Cada nome de imagem tem de estar na sua própria linha e tem de estar na mesma ordem que os resumos no ficheiro Resumos da Imagem. Se as imagens forem criadas pelo projeto do Service Fabric, este ficheiro é gerado como parte do destino do Pacote e a respetiva localização de saída é controlada pela propriedade BuiltDockerImagesFilePath.

imageDigestsPath - Caminho dos Resumos da Imagem
string. Necessário quando updateType = Docker image settings.

Especifica o caminho para um ficheiro de texto que contém os valores de resumo das imagens do Docker associadas à aplicação do Service Fabric. Este ficheiro pode ser exportado pela tarefa do Docker ao utilizar a ação push. O ficheiro deve conter linhas de texto no formato .registry/image_name@digest_value

Nenhum.