Compartilhar via


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.

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

Entradas

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.

Dica

Você pode modificar o formato de número de build diretamente ou usar um comando de registro em log para definir dinamicamente uma variável em um formato. Por exemplo, você pode usar $(VersionSuffix) definido em uma tarefa do PowerShell:

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

Observação

Por padrão, o compilador criará saídas diferentes mesmo que nenhuma alteração tenha sido feita. Use o sinalizador do compilador determinístico para garantir que compilações com as mesmas entradas produzam as mesmas saídas.


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.


Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Comentários

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.

Observação

Essa tarefa requer Windows PowerShell.

Essa tarefa não está disponível em pipelines de lançamento .

Essa tarefa só pode ser usada em um pipeline de build para atualizar automaticamente as versões de um aplicativo do Service Fabric empacotado.

Esta tarefa dá suporte a dois tipos de atualizações:

  1. Versão do manifesto: Atualizações versões de Serviço e Aplicativo especificadas em arquivos de manifesto em um pacote de aplicativos do Service Fabric. Se especificado, manifest version compara os arquivos atuais com um build anterior e atualiza a versão somente para esses serviços alterados.

  2. Configurações de imagem do Docker: Atualizações configurações de imagem de contêiner do Docker especificadas em arquivos de manifesto em um pacote de aplicativos do Service Fabric. As configurações de imagem a serem colocadas são escolhidas de dois arquivos:

    a. Arquivo de nomes de imagem: esse arquivo é gerado pela tarefa de build.

    b. Arquivo de resumos de imagem: esse arquivo é gerado pela tarefa docker quando envia imagens por push para o Registro.

Exemplos

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
É executado em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: Cmd
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.95.0 ou superior
Categoria da tarefa Utilitário