ServiceFabricUpdateAppVersions@1 - Aggiornare l'attività Versioni app di Service Fabric v1

Articolo
2025-03-24

Usare questa attività in una pipeline di compilazione per aggiornare automaticamente le versioni di un'app di Service Fabric in pacchetto. Questa attività aggiunge un suffisso di versione a tutte le versioni del servizio e dell'app, specificate nei file manifesto, in un pacchetto di app di Azure Service Fabric.

Sintassi

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

Ingressi dati

applicationPackagePath - pacchetto dell'applicazione
string. Obbligatorio.

Specifica il percorso del pacchetto dell'applicazione di Service Fabric da distribuire nel cluster. Esempio: $(system.defaultworkingdirectory)/**/drop/applicationpackage. le variabili e i caratteri jolly possono essere usati nel percorso.

versionSuffix - valore della versione
string. Obbligatorio. Valore predefinito: .$(Build.BuildNumber)

Valore utilizzato per specificare la versione nei file manifesto.

Suggerimento

È possibile modificare direttamente il formato del numero di compilazione o usare un comando di registrazione per impostare dinamicamente una variabile in qualsiasi formato. Ad esempio, è possibile usare $(VersionSuffix) definiti in un'attività di PowerShell:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"

Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - comportamento della versione
string. Valori consentiti: Append, Replace. Valore predefinito: Append

Aggiunge il valore della versione ai valori esistenti nei file manifesto o li sostituisce.

updateOnlyChanged - Aggiorna solo se è stato modificato
boolean. Valore predefinito: false

Aggiorna in modo incrementale solo i pacchetti modificati. Usare il flag del compilatore deterministico per assicurarsi che le compilazioni con gli stessi input producano gli stessi output.

pkgArtifactName - nome artefatto pacchetto
string. Opzionale. Usare quando updateOnlyChanged = true.

Specifica il nome dell'artefatto contenente il pacchetto dell'applicazione della build precedente.

logAllChanges - Registra tutte le modifiche
boolean. Opzionale. Usare quando updateOnlyChanged = true. Valore predefinito: true

Confronta tutti i file in ogni pacchetto e log se il file è stato aggiunto, rimosso o se il relativo contenuto è stato modificato. In caso contrario, confronta i file in un pacchetto solo fino a quando non viene trovata la prima modifica per ottenere prestazioni più veloci.

compareType - Confronto con
string. Opzionale. Usare quando updateOnlyChanged = true. Valori consentiti: LastSuccessful (ultima compilazione riuscita), Specific (build specifica). Valore predefinito: LastSuccessful

Confronta con l'ultima compilazione completata e completata o con una compilazione specifica.

buildNumber - numero di build
string. Opzionale. Usare quando compareType = Specific.

Specifica il numero di build per il confronto se l'attività viene confrontata con una compilazione specifica.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente
richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: Cmd
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	1.95.0 o versione successiva
Categoria attività	Utilità

Condividi tramite