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

Use essa tarefa em um pipeline de build para atualizar automaticamente as versões de um aplicativo do Service Fabric empacotado. Essa tarefa acrescenta um sufixo de versão a todas as versões de serviço e aplicativo, especificadas nos arquivos de manifesto, em um pacote de aplicativos 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órios. Valores Permitidos: Manifest versions e Docker image settings. Valor padrão: Manifest versions.

Especifica o tipo de atualização que deve ser feita nos arquivos de manifesto. Para usar os dois tipos de atualização, adicione uma instância dessa tarefa ao pipeline de build para cada tipo de atualização a ser executado.

applicationPackagePath - Pacote de Aplicativos
string. Obrigatórios.

Especifica o caminho para o pacote do aplicativo. Variáveis e caracteres curinga podem ser usados no caminho. applicationPackagePath não deve ter uma barra à direita, seja \ ou /.

versionSuffix - Valor da versão
string. Obrigatório quando updateType = Manifest versions. Valor padrão: .$(Build.BuildNumber).

Especifica a versão nos arquivos de manifesto.

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

versionBehavior - Comportamento da versão
string. Opcional. Use quando updateType = Manifest versions. Valores Permitidos: Append e Replace. Valor padrão: Append.

Especifica se o valor da versão deve ser acrescentado aos valores existentes nos arquivos de manifesto ou substituí-los.

updateOnlyChanged - Atualizar somente se for alterado
boolean. Opcional. Use quando updateType = Manifest versions. Valor padrão: false.

Acrescenta o sufixo da nova versão apenas aos pacotes que foram alterados de um build anterior. Se nenhuma alteração for encontrada, o sufixo de versão do build anterior será acrescentado.

pkgArtifactName - Nome do artefato do pacote
string. Opcional. Use quando updateType = Manifest versions && updateOnlyChanged = true.

Especifica o nome do artefato que contém o pacote do aplicativo para comparação.

logAllChanges - Registrar todas as alterações em log
boolean. Opcional. Use quando updateType = Manifest versions && updateOnlyChanged = true. Valor padrão: true.

Compara todos os arquivos em cada pacote e log se o arquivo foi adicionado, removido ou se seu conteúdo foi alterado. Caso contrário, esse booliano compara arquivos em um pacote somente até que a primeira alteração seja encontrada para obter um desempenho mais rápido.

compareType - Comparar com
string. Opcional. Use quando updateType = Manifest versions && updateOnlyChanged = true. Valores permitidos: LastSuccessful (Última compilação bem-sucedida) Specific (Build específico). Valor padrão: LastSuccessful.

Especifica se deve ser comparado com o último build concluído e bem-sucedido ou com um build específico.

buildNumber - Número do Build
string. Opcional. Use quando updateType = Manifest versions && compareType = Specific.

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

overwriteExistingPkgArtifact - Substituir artefato de pacote existente
boolean. Opcional. Use quando updateType = Manifest versions && updateOnlyChanged = true. Valor padrão: true.

Baixa uma nova cópia do artefato. Caso contrário, esse booliano usará uma cópia existente, se presente.

imageNamesPath - Caminho de nomes de imagem
string. Opcional. Use quando updateType = Docker image settings.

Especifica o caminho para um arquivo de texto que contém os nomes das imagens do Docker associadas ao aplicativo do Service Fabric que devem ser atualizados com resumos. Cada nome de imagem deve estar em sua própria linha e deve estar na mesma ordem que os resumos no arquivo Image Digests. Se as imagens forem criadas pelo projeto do Service Fabric, esse arquivo será gerado como parte do destino pacote e seu local de saída será controlado pela propriedade BuiltDockerImagesFilePath.

imageDigestsPath - Caminho de Resumos de Imagem
string. Obrigatório quando updateType = Docker image settings.

Especifica o caminho para um arquivo de texto que contém os valores de resumo das imagens do Docker associadas ao aplicativo Service Fabric. Esse arquivo pode ser gerado pela tarefa do Docker ao usar a ação push. O arquivo deve conter linhas de texto no formato de registry/image_name@digest_value.

Nenhum.