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.

Sintaxe

# 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

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

Especifica o tipo de atualização que deve ser feita aos 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 executada.


do Pacote de Aplicativos applicationPackagePath -
string. Obrigatório

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


de valor de versão versionSuffix -
string. Necessá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 - de comportamento de versão
string. Opcional. Use quando updateType = Manifest versions. Valores permitidos: Append, 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 alterado
boolean. Opcional. Use quando updateType = Manifest versions. Valor padrão: false.

Acrescenta o novo sufixo de versão a apenas os 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 builds 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
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 comparará arquivos em um pacote somente até que a primeira alteração seja encontrada para 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 de build
string. Opcional. Use quando updateType = Manifest versions && compareType = Specific.

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


overwriteExistingPkgArtifact - substituir de 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 atualizadas 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 - de caminho de resumos de imagem
string. Necessá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 Docker ao usar a ação de 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 das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

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 o Windows PowerShell.

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

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

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

  1. versão do Manifesto: atualiza as 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 as 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 em dois arquivos:

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

    b. Imagem digere o arquivo: 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
Execuções em Agent, DeploymentGroup
de demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: Cmd
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 1.95.0 ou superior
Categoria de tarefa Utilidade