ServiceFabricUpdateAppVersions@1 – Atualizar a tarefa Versões da Aplicação do Service Fabric v1

Artigo
07/02/2024

Utilize esta tarefa num pipeline de compilação para atualizar automaticamente as versões de uma aplicação do Service Fabric empacotada. 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 App Versions v1
# Automatically updates the versions of a packaged Service Fabric application.
- task: ServiceFabricUpdateAppVersions@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    versionSuffix: '.$(Build.BuildNumber)' # string. Required. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when compareType = Specific. Build Number.

Entradas

applicationPackagePath - Pacote de Aplicações
string. Obrigatório.

Especifica a localização do pacote de aplicações do Service Fabric a implementar no cluster. Exemplo: $(system.defaultworkingdirectory)/**/drop/applicationpackage. Podem ser utilizadas variáveis e carateres universais no caminho.

versionSuffix - Valor da Versão
string. Obrigatório. Valor predefinido: .$(Build.BuildNumber).

O valor utilizado para especificar 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 em qualquer 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. Valores permitidos: Append, Replace. Valor predefinido: Append.

Acrescenta o valor da versão aos valores existentes nos ficheiros de manifesto ou substitui-os.

updateOnlyChanged - Atualizar apenas se for alterado
boolean. Valor predefinido: false.

Atualiza de forma incremental apenas os pacotes que foram alterados. 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 updateOnlyChanged = true.

Especifica o nome do artefacto que contém o pacote de aplicação da compilação anterior.

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

Compara todos os ficheiros em todos os pacotes e registos se o ficheiro foi adicionado, removido ou se o respetivo conteúdo foi alterado. Caso contrário, compara os 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 updateOnlyChanged = true. Valores permitidos: LastSuccessful (Última Compilação Com Êxito), Specific (Compilação Específica). Valor predefinido: LastSuccessful.

Compara-se com a última compilação concluída e com êxito ou com uma compilação específica.

buildNumber - Número da Compilação
string. Opcional. Utilize quando compareType = Specific.

Especifica o número de compilação para comparação se a tarefa estiver a comparar com uma compilação específica.

Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agente
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizam 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 tabelas definidas	Qualquer
Versão do agente	1.95.0 ou superior
Categoria da tarefa	Utilitário

Partilhar via