ServiceFabricUpdateAppVersions@1 - Tâche Mettre à jour les versions d’application Service Fabric v1

Article
07/02/2024

Utilisez cette tâche dans un pipeline de build pour mettre à jour automatiquement les versions d’une application Service Fabric empaquetée. Cette tâche ajoute un suffixe de version à toutes les versions de service et d’application, spécifiées dans les fichiers manifeste, dans un package d’application Azure Service Fabric.

Syntaxe

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

Entrées

applicationPackagePath - Package d’application
string. Obligatoire.

Spécifie l’emplacement du package d’application Service Fabric à déployer sur le cluster. Exemple : $(system.defaultworkingdirectory)/**/drop/applicationpackage. Les variables et les caractères génériques peuvent être utilisés dans le chemin d’accès.

versionSuffix - Valeur de version
string. Obligatoire. Valeur par défaut : .$(Build.BuildNumber).

Valeur utilisée pour spécifier la version dans les fichiers manifeste.

Conseil

Vous pouvez modifier le format de numéro de build directement ou utiliser une commande de journalisation pour définir dynamiquement une variable dans n’importe quel format. Par exemple, vous pouvez utiliser $(VersionSuffix) défini dans une tâche PowerShell :

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

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

versionBehavior - Comportement de version
string. Valeurs autorisées : Append, Replace. Valeur par défaut : Append.

Ajoute la valeur de version aux valeurs existantes dans les fichiers manifeste ou les remplace.

updateOnlyChanged - Mettre à jour uniquement en cas de modification
boolean. Valeur par défaut : false.

Met à jour de manière incrémentielle uniquement les packages qui ont changé. Utilisez l’indicateur de compilateur déterministe pour vous assurer que les builds avec les mêmes entrées produisent les mêmes sorties.

pkgArtifactName - Nom de l’artefact de package
string. Optionnel. Utilisez quand updateOnlyChanged = true.

Spécifie le nom de l’artefact contenant le package d’application de la build précédente.

logAllChanges - Journaliser toutes les modifications
boolean. facultatif. Utilisez quand updateOnlyChanged = true. Valeur par défaut : true.

Compare tous les fichiers de chaque package et journalise si le fichier a été ajouté, supprimé ou si son contenu a changé. Sinon, compare les fichiers dans un package uniquement jusqu’à ce que la première modification soit trouvée pour des performances plus rapides.

compareType - Comparer par rapport à
string. Optionnel. Utilisez quand updateOnlyChanged = true. Valeurs autorisées : LastSuccessful (Dernière build réussie), Specific (Build spécifique). Valeur par défaut : LastSuccessful.

Compare à la dernière génération terminée et réussie ou à une build spécifique.

buildNumber - Numéro de build
string. Optionnel. Utilisez quand compareType = Specific.

Spécifie le numéro de build à comparer si la tâche est comparée à une build spécifique.

Options de contrôle des tâches

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Spécifications

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : Cmd
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.95.0 ou version ultérieure
Catégorie de la tâche	Utilitaire

Partager via