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.

Syntax

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

Entradas

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.

Dica

Pode modificar o formato de número de compilação diretamente ou utilizar um comando de registo para definir dinamicamente uma variável num formato. Por exemplo, pode utilizar $(VersionSuffix) definido numa tarefa do PowerShell:

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

Nota

Por predefinição, o compilador criará saídas diferentes mesmo que não tenham sido efetuadas alterações. Utilize o sinalizador do compilador determinista para garantir que as compilações com as mesmas entradas produzem as mesmas saídas.

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

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das respetivas entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

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.

Nota

Esta tarefa requer Windows PowerShell.

Esta tarefa não está disponível em pipelines de versão .

Esta tarefa só pode ser utilizada num pipeline de compilação para atualizar automaticamente as versões de uma aplicação do Service Fabric em pacote.

Esta tarefa suporta dois tipos de atualizações:

1. Versão do manifesto: Atualizações versões do Serviço e da Aplicação especificadas em ficheiros de manifesto num pacote de aplicação do Service Fabric. Se especificado, manifest version compara os ficheiros atuais com uma compilação anterior e atualiza a versão apenas para esses serviços alterados.

2. Definições de imagem do Docker: Atualizações definições de imagem de contentor do Docker especificadas em ficheiros de manifesto num pacote de aplicação do Service Fabric. As definições de imagem a colocar são escolhidas a partir de dois ficheiros:

   a. Ficheiro de nomes de imagem: este ficheiro é gerado pela tarefa de compilação.

   b. Ficheiro de resumo da imagem: este ficheiro é gerado pela tarefa do Docker quando envia imagens para o registo.

Exemplos

• *Tarefa de Implementação de Aplicações do Service Fabric

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agent, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: Cmd
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.95.0 ou superior
Categoria da tarefa	Utilitário