ServiceFabricUpdateManifests@2 - Aggiornare i manifesti di Service Fabric v2

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.

Input

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 nei 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 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 il formato del numero di compilazione direttamente o usare un comando di registrazione per impostare dinamicamente una variabile in un formato. Ad esempio, è possibile usare $(VersionSuffix) definito in un'attività di PowerShell:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - Comportamento della versione
string. Facoltativa. 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 - Aggiornare solo se modificato
boolean. Facoltativa. Usare quando updateType = Manifest versions. Valore predefinito: false.

Aggiunge il suffisso della nuova versione solo ai pacchetti che sono stati modificati da una compilazione 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 garantire che le compilazioni con gli stessi input producano gli stessi output.

pkgArtifactName - Nome artefatto pacchetto
string. Facoltativa. Usare quando updateType = Manifest versions && updateOnlyChanged = true.

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

logAllChanges - Registrare tutte le modifiche
boolean. Facoltativa. 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 booleano confronta i file in un pacchetto solo finché non viene trovata la prima modifica per prestazioni più veloci.

compareType - Confrontare con
string. Facoltativa. Usare quando updateType = Manifest versions && updateOnlyChanged = true. Valori consentiti: LastSuccessful (ultima compilazione riuscita), Specific (compilazione specifica). Valore predefinito: LastSuccessful.

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

buildNumber - Numero di compilazione
string. Facoltativa. Usare quando updateType = Manifest versions && compareType = Specific.

Specifica il numero di compilazione per il confronto.

overwriteExistingPkgArtifact - Sovrascrivere l'artefatto del pacchetto esistente
boolean. Facoltativa. Usare quando updateType = Manifest versions && updateOnlyChanged = true. Valore predefinito: true.

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

imageNamesPath - Percorso nomi immagini
string. Facoltativa. Usare quando updateType = Docker image settings.

Specifica il percorso di un file di testo contenente i nomi delle immagini Docker associate all'applicazione Service Fabric che deve essere aggiornata con i digest. Ogni nome 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 Service Fabric, questo file viene generato come parte della destinazione Pacchetto e il relativo percorso di output viene controllato dalla proprietà BuiltDockerImagesFilePath.

imageDigestsPath - Percorso dei digest delle immagini
string. Obbligatorio quando updateType = Docker image settings.

Specifica il percorso di un file di testo contenente i valori di digest delle immagini Docker associate all'applicazione 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 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

No.

Osservazioni

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.

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:

1. Versione manifesto: Aggiornamenti versioni del servizio e dell'applicazione specificate nei file manifesto in un pacchetto dell'applicazione service fabric. Se specificato, manifest version confronta i file correnti rispetto a una build precedente e aggiorna la versione solo per tali servizi modificati.

2. Impostazioni dell'immagine Docker: Aggiornamenti 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 di digest delle immagini: questo file viene generato dall'attività docker quando esegue il push delle immagini nel Registro di sistema.

Esempio

• *Attività di distribuzione di applicazioni di Service Fabric

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: Cmd
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.95.0 o versione successiva
Categoria attività	Utilità