ServiceFabricUpdateManifests@2 - Aggiornare i manifesti di Service Fabric v2

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

Ingressi dati

updateType - tipo di aggiornamento
string. Obbligatorio. Valori consentiti: Manifest versions, Docker image settings. Valore predefinito: Manifest versions

Specifica il tipo di aggiornamento che deve essere eseguito ai file manifesto. Per usare entrambi i tipi di aggiornamento, aggiungere un'istanza di questa attività alla pipeline di compilazione per ogni tipo di aggiornamento da eseguire.

applicationPackagePath - pacchetto dell'applicazione
string. Obbligatorio.

Specifica il percorso del pacchetto dell'applicazione. le variabili e i caratteri jolly possono essere usati nel percorso. applicationPackagePath non deve avere una barra finale, \ o /.

versionSuffix - valore della versione
string. Obbligatorio quando updateType = Manifest versions. Valore predefinito: .$(Build.BuildNumber)

Specifica 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 un 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. Opzionale. Usare quando updateType = Manifest versions. Valori consentiti: Append, Replace. Valore predefinito: Append

Specifica se aggiungere il valore della versione ai valori esistenti nei file manifesto o sostituirli.

updateOnlyChanged - Aggiorna solo se è stato modificato
boolean. Opzionale. Usare quando updateType = Manifest versions. Valore predefinito: false

Aggiunge il suffisso della nuova versione solo ai pacchetti modificati da una build precedente. Se non vengono trovate modifiche, verrà aggiunto il suffisso della versione della build precedente.

Nota

Per impostazione predefinita, il compilatore creerà output diversi anche se non sono state apportate modifiche. 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 updateType = Manifest versions && updateOnlyChanged = true.

Specifica il nome dell'artefatto contenente il pacchetto dell'applicazione per il confronto.

logAllChanges - Registra tutte le modifiche
boolean. Opzionale. Usare quando updateType = Manifest versions && 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, questo valore booleano 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 updateType = Manifest versions && updateOnlyChanged = true. Valori consentiti: LastSuccessful (ultima compilazione riuscita), Specific (build specifica). Valore predefinito: LastSuccessful

Specifica se confrontare con l'ultima compilazione completata e completata correttamente o con una compilazione specifica.

buildNumber - numero di build
string. Opzionale. Usare quando updateType = Manifest versions && compareType = Specific.

Specifica il numero di build per il confronto.

overwriteExistingPkgArtifact - sovrascrivere gli elementi del pacchetto esistenti
boolean. Opzionale. Usare quando updateType = Manifest versions && updateOnlyChanged = true. Valore predefinito: true

Scarica una nuova copia dell'artefatto. In caso contrario, questo valore booleano usa una copia esistente, se presente.

imageNamesPath - percorso nomi immagine
string. Opzionale. Usare quando updateType = Docker image settings.

Specifica il percorso di un file di testo che contiene i nomi delle immagini Docker associate all'applicazione di Service Fabric da aggiornare con digest. Ogni nome dell'immagine deve trovarsi nella propria riga e deve trovarsi nello stesso ordine dei digest nel file Image Digests. Se le immagini vengono create dal progetto di Service Fabric, questo file viene generato come parte della destinazione del pacchetto e il relativo percorso di output viene controllato dalla proprietà BuiltDockerImagesFilePath.

imageDigestsPath - percorso digest immagine
string. Obbligatorio quando updateType = Docker image settings.

Specifica il percorso di un file di testo che contiene i valori digest delle immagini Docker associate all'applicazione di Service Fabric. Questo file può essere restituito dall'attività Docker quando si usa l'azione push. Il file deve contenere righe di testo nel formato di registry/image_name@digest_value.

Opzioni di controllo delle attività

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

Variabili di output

Nessuno.

Osservazioni:

Nota

Questa attività richiede Windows PowerShell.

Questa attività non è disponibile nelle pipeline di versione.

Questa attività può essere usata solo in una pipeline di compilazione per aggiornare automaticamente le versioni di un'app di Service Fabric in pacchetto.

Questa attività supporta due tipi di aggiornamenti:

versione manifesto: aggiorna le versioni del servizio e dell'applicazione specificate nei file manifesto in un pacchetto dell'applicazione di Service Fabric. Se specificato, manifest version confronta i file correnti con una build precedente e aggiorna la versione solo per i servizi modificati.
impostazioni dell'immagine Docker: aggiorna le impostazioni dell'immagine del contenitore Docker specificate nei file manifesto in un pacchetto dell'applicazione service fabric. Le impostazioni dell'immagine da inserire vengono selezionate da due file:

a. file nomi immagine: questo file viene generato dall'attività di compilazione.

b. file digest immagine: questo file viene generato dall'attività Docker quando esegue il push delle immagini nel Registro di sistema.

Esempi

* 'attività di distribuzione dell'applicazione di Service Fabric

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
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