Partager via

ApplicationUpgradeDescription

  • Article

Décrit les paramètres d’une mise à niveau d’application. Notez que la description de la mise à niveau remplace la description de l’application existante. Cela signifie que si les paramètres ne sont pas spécifiés, les paramètres existants sur les applications seront remplacés par la liste de paramètres vide. Cela se traduirait par l’utilisation par l’application de la valeur par défaut des paramètres à partir du manifeste d’application. Si vous ne souhaitez pas modifier les valeurs de paramètre existantes, obtenez d’abord les paramètres d’application à l’aide de la requête GetApplicationInfo, puis fournissez ces valeurs en tant que Paramètres dans cette ApplicationUpgradeDescription.

Propriétés

Nom Type Obligatoire
Name string Oui
TargetApplicationTypeVersion string Oui
Parameters tableau d’ApplicationParameter Non
UpgradeKind string (enum) Oui
RollingUpgradeMode string (enum) Non
UpgradeReplicaSetCheckTimeoutInSeconds integer (int64) Non
ForceRestart boolean Non
SortOrder string (enum) Non
MonitoringPolicy MonitoringPolicyDescription Non
ApplicationHealthPolicy ApplicationHealthPolicy Non
InstanceCloseDelayDurationInSeconds integer (int64) Non
ManagedApplicationIdentity ManagedApplicationIdentityDescription Non

Name

Type : chaîne
Obligatoire : Oui

Nom de l’application cible, y compris le schéma d’URI « fabric: ».

TargetApplicationTypeVersion

Type : chaîne
Obligatoire : Oui

La version du type d’application cible (trouvée dans le manifeste de l’application) pour la mise à niveau de l’application.

Parameters

Type : tableau d’ApplicationParameter
Obligatoire : Non

Liste des paramètres d’application avec des valeurs remplacées à partir de leurs valeurs par défaut spécifiées dans le manifeste de l’application.

UpgradeKind

Type : chaîne (énumération)
Obligatoire : Oui
Par défaut : Rolling

Type de mise à niveau des valeurs possibles suivantes.

Les valeurs possibles sont les suivantes :

  • Invalid - Indique que le type de mise à niveau n’est pas valide. Toutes les énumérations Service Fabric ont le type non valide. La valeur est égale à zéro.
  • Rolling - La mise à niveau progresse d’un domaine de mise à niveau à la fois. La valeur est 1

RollingUpgradeMode

Type : chaîne (énumération)
Obligatoire : Non
Par défaut : UnmonitoredAuto

Mode utilisé pour surveiller l’intégrité pendant une mise à niveau propagée. Les valeurs sont UnmonitoredAuto, UnmonitoredManual, Monitored et UnmonitoredDeferred.

Les valeurs possibles sont les suivantes :

  • Invalid - Indique que le mode de mise à niveau n’est pas valide. Toutes les énumérations Service Fabric ont le type non valide. La valeur est égale à zéro.
  • UnmonitoredAuto - La mise à niveau se poursuit automatiquement sans effectuer de surveillance de l’intégrité. La valeur est 1
  • UnmonitoredManual - La mise à niveau s’arrête après chaque domaine de mise à niveau, ce qui donne la possibilité de surveiller manuellement l’intégrité avant de continuer. La valeur est 2
  • Monitored - La mise à niveau s’arrête une fois chaque domaine de mise à niveau terminé et surveille automatiquement l’intégrité avant de continuer. La valeur est 3
  • UnmonitoredDeferred - Effectuer une mise à niveau nœud par nœud. Aucune action n’est effectuée au démarrage de la mise à niveau ; La mise à niveau est appliquée à chaque nœud lorsqu’il est désactivé avec un redémarrage intentionnel ou une version ultérieure. La valeur est 4

UpgradeReplicaSetCheckTimeoutInSeconds

Type : integer (int64)
Obligatoire : Non

Durée maximale pendant laquelle bloquer le traitement d’un domaine de mise à niveau et éviter la perte de disponibilité en cas de problèmes inattendus. Lorsque ce délai d’attente expire, le traitement du domaine de mise à niveau se poursuit, indépendamment des problèmes de perte de disponibilité. Le délai d’expiration est réinitialisé au début de chaque domaine de mise à niveau. Les valeurs valides sont comprises entre 0 et 42949672925 inclus. (entier 32 bits non signé).

ForceRestart

Type : booléen
Obligatoire : Non

Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau, même lorsque la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données).

SortOrder

Type : chaîne (énumération)
Obligatoire : Non
Par défaut : Default

Définit l’ordre dans lequel une mise à niveau passe par le cluster.

Les valeurs possibles sont les suivantes :

  • Invalid - Indique que cet ordre de tri n’est pas valide. Toutes les énumérations Service Fabric ont le type non valide. La valeur est égale à 0.
  • Default - Indique que l’ordre de tri par défaut (tel que spécifié dans le manifeste du cluster) sera utilisé. La valeur est égale à 1.
  • Numeric - Indique que l’ordre de tri numérique (noms UD triés comme nombres) sera utilisé. La valeur est égale à 2.
  • Lexicographical - Indique que l’ordre de tri lexicographique avant (noms UD triés en tant que chaînes) sera utilisé. La valeur est 3.
  • ReverseNumeric - Indique que l’ordre de tri numérique inversé (noms UD triés sous forme de nombres) sera utilisé. La valeur est égale à 4.
  • ReverseLexicographical - Indique que l’ordre de tri lexicographique inverse (noms UD triés sous forme de chaînes) sera utilisé. La valeur est 5.

MonitoringPolicy

Type : MonitoringPolicyDescription
Obligatoire : Non

Décrit les paramètres de surveillance d’une mise à niveau en mode supervisé.

ApplicationHealthPolicy

Type : ApplicationHealthPolicy
Obligatoire : Non

Définit une stratégie d’intégrité utilisée pour évaluer l’intégrité d’une application ou de l’une de ses entités enfants.

InstanceCloseDelayDurationInSeconds

Type : integer (int64)
Obligatoire : Non

Durée en secondes, pour attendre avant la fermeture d’une instance sans état, pour permettre aux requêtes actives de se vider correctement. Cela serait effectif lorsque le instance se ferme pendant la mise à niveau de l’application/du cluster, uniquement pour les instances dont la durée de délai est différente de zéro configurée dans la description du service. Pour plus d’informations, consultez la propriété InstanceCloseDelayDurationSeconds dans $ref : « #/definitions/StatelessServiceDescription.yaml ». Notez que la valeur par défaut de InstanceCloseDelayDurationInSeconds est 4294967295, ce qui indique que le comportement dépend entièrement du délai configuré dans la description du service sans état.

ManagedApplicationIdentity

Type : ManagedApplicationIdentityDescription
Obligatoire : Non

Description de l’identité d’application managée.