Update-ServiceFabricApplication

  • Référence
Module:
ServiceFabric

Met à jour ou supprime la capacité de l’application.

Syntaxe

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Description

La Update-ServiceFabricApplication mises à jour de l’applet de commande ou supprime la capacité d’application pour une application qui a déjà été créée.

La capacité d’application définit les nœuds maximum/minimum d’une application, ainsi que la capacité par nœud pour ses métriques.

Exemples

Exemple 1 : Mettre à jour maximumNodes et métriques

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Cette commande met à jour l’infrastructure d’application :/MyApp pour utiliser un maximum de six nœuds. Chaque nœud a une charge réservée de deux unités et une charge maximale de 12 unités pour la métrique processeur sur chaque nœud. La capacité totale de l’application est de 16 unités pour la métrique du processeur. La valeur de MinimumNodes reste inchangée.

Exemple 2 : Mettre à jour MaximumNodes et réinitialiser les métriques

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()

Cette commande met à jour l’infrastructure d’application :/MyApp pour utiliser un maximum de six nœuds et supprime les capacités de toutes les métriques. S’il existe des capacités définies précédemment, elles sont effacées après cette commande. La valeur de MinimumNodes n’est pas modifiée.

Exemple 3 : Mettre à jour tous les paramètres de capacité d’application

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Cette commande met à jour l’infrastructure d’application :/MyApp pour utiliser un maximum de six nœuds. Chaque nœud a une charge réservée de deux unités et une charge maximale de 12 unités pour le processeur de métriques sur chaque nœud. La capacité totale de l’application est de 16 unités pour la métrique du processeur. La valeur des nœuds minimum est mise à jour à 2, afin que Service Fabric réserve une capacité totale de quatre unités pour la métrique de processeur dans le cluster.

Exemple 4 : Supprimer tous les paramètres de capacité d’application

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity

Cette commande met à jour l’infrastructure d’application :/MyApp afin qu’elle n’ait aucun paramètre de capacité d’application défini. Si MyApp avait des paramètres de capacité précédemment définis, cette opération les efface.

Paramètres

-ApplicationName

Spécifie le nom de l’application à mettre à jour.

Type:Uri
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaximumNodes

Spécifie le nombre maximal de nœuds sur lesquels placer une application. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est 0, ce qui indique que l’application peut être placée sur n’importe quel nombre de nœuds du cluster.

Si vous ne spécifiez pas ce paramètre, l’application utilise le nombre maximal de nœuds existant défini pour l’application.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Metrics

Spécifie un tableau de métriques. Ces métriques sont utilisées par Service Fabric Cluster Resource Manager pour gérer les ressources dans le cluster. Pour plus d’informations sur les métriques et la gestion des ressources dans Service Fabric, consultez Présentation de Service Fabric Cluster Resource Manager. Chaque métrique peut suivre le modèle MetricName,NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity, ou spécifier MetricName et utiliser des noms de paramètres NodeReservationCapacity,MaximumNodeCapacity, TotalApplicationCapacity suivi d’une valeur de paramètre séparée par un signe deux-points. Chaque paramètre name :value paire peut apparaître au maximum une fois.

  • MetricName. Spécifie le nom de la métrique.
  • NodeReservationCapacity. Spécifie la quantité de charge métrique réservée sur les nœuds qui ont des instances de cette application. Si MinimumNodes est spécifié, le produit de ces valeurs est la capacité réservée dans le cluster pour l’application.
  • MaximumNodeCapacity. Spécifie la charge maximale d’une instance de cette application sur un seul nœud. Même si la capacité du nœud est supérieure à cette valeur, Service Fabric limite la charge totale des réplicas enfants de l’application à cette valeur.
  • TotalApplicationCapacity. Spécifie la capacité totale de l’application dans le cluster. Service Fabric tente de limiter la somme des charges des réplicas enfants de l’application à cette valeur.

Lors de la mise à jour de la capacité, Service Fabric effectue les validations suivantes et échoue la commande si elle ne passe pas :

  • NodeReservationCapacity ne doit pas être supérieur à MaximumNodeCapacity.
  • Si la métrique MinimumNodes et NodeReservationCapacity sont spécifiées, le produit de MinimumNodes et NodeReservationCapacity ne doit pas être supérieur à TotalApplicationCapacity.
Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MinimumNodes

Spécifie le nombre de nœuds d’un cluster sur lequel la capacité est réservée à cette application, cela ne signifie pas que l’application est garantie d’avoir des réplicas sur tous ces nœuds. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est zéro, ce qui signifie qu’aucune capacité n’est réservée à l’application.

Si MinimumNodes est défini sur 0, aucune capacité n’est réservée.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveApplicationCapacity

Indique que cette opération efface tous les paramètres liés à la capacité de l’application. Si vous spécifiez ce paramètre, vous ne pouvez pas spécifier le paramètre Metrics pour mettre à jour la capacité de l’application.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object