Partager via

Start-ServiceFabricComposeDeploymentUpgrade

  • Référence
Module:
ServiceFabric

APERÇU. Met à niveau un déploiement de composition Service Fabric avec un nouveau fichier de composition.

Syntaxe

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Cette applet de commande est en préversion et peut être modifiée dans la ou les versions suivantes. Il n’existe aucune garantie de compatibilité.

L’applet de commande Start-ServiceFabricComposeDeploymentUpgrade met à niveau un déploiement de composition Service Fabric. Cette applet de commande démarre la mise à niveau sur le cluster.

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster.

Pour obtenir des conseils sur le déploiement de Service Fabric Compose, reportez-vous à : Déploiement Compose dans Service Fabric

Exemples

Exemple 1 : Mettre à niveau un déploiement compose

PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback

La commande effectue une mise à niveau automatique surveillée sur le déploiement compose nommé mydeployment à partir du fichier de composition docker-compose.yml. La mise à niveau se restaure en cas d’échec de la mise à niveau surveillée. Il n’est pas nécessaire d’inscrire au préalable le type d’application.

Paramètres

-Compose

Spécifie le chemin d’accès du fichier à un fichier de composition cible qui décrit le déploiement de composition Service Fabric.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-ConsiderWarningAsError

Indique s’il faut traiter un événement d’intégrité d’avertissement comme un événement d’erreur pendant l’évaluation de l’intégrité.

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

-DefaultServiceTypeHealthPolicy

Spécifie la stratégie d’intégrité du type de service par défaut à utiliser pour la mise à niveau surveillée au format MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Par exemple, 5 10 15 indiquent les valeurs suivantes :

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
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

-DeploymentName

Spécifie le nom du déploiement de composition. L’applet de commande met à niveau le déploiement compose avec ce nom.

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

-FailureAction

Spécifie l’action à entreprendre si la mise à niveau surveillée échoue. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Rollback
  • Manuelle
Type:UpgradeFailureAction
Valeurs acceptées:Invalid, Rollback, Manual
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Indique que cette applet de commande ignore le message d’avertissement et force la mise à niveau.

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

-ForceRestart

Indique que tous les conteneurs du fichier de composition doivent être recréés même si les descriptions du service ne changent pas dans le nouveau fichier de composition.

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

-HealthCheckRetryTimeoutSec

Spécifie la durée, en secondes, après laquelle Service Fabric retente le contrôle d’intégrité si le contrôle d’intégrité précédent échoue.

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

-HealthCheckStableDurationSec

Spécifie la durée, en secondes, que Service Fabric attend pour vérifier que l’application qui compose le déploiement déployé est stable avant de passer au domaine de mise à niveau suivant ou de terminer la mise à niveau. Cette durée d’attente empêche les modifications non détectées de l’intégrité juste après l’exécution du contrôle d’intégrité.

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

-HealthCheckWaitDurationSec

Spécifie la durée, en secondes, que Service Fabric attend avant d’effectuer le contrôle d’intégrité initial une fois la mise à niveau terminée sur le domaine de mise à niveau.

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

-MaxPercentUnhealthyDeployedApplications

Spécifie le pourcentage maximal d’instances d’application déployées sur les nœuds du cluster qui ont un état d’intégrité d’erreur avant l’état d’intégrité de l’application pour le cluster.

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

-Monitored

Indique que le mode de mise à niveau est surveillé. Une fois que l’applet de commande a terminé une mise à niveau pour un domaine de mise à niveau, si l’intégrité du domaine de mise à niveau et le cluster répondent aux stratégies d’intégrité que vous définissez, Service Fabric met à niveau le domaine de mise à niveau suivant. Si le domaine de mise à niveau ou le cluster ne répond pas aux stratégies d’intégrité, la mise à niveau échoue et Service Fabric restaure la mise à niveau pour le domaine de mise à niveau ou rétablit le mode manuel selon la stratégie spécifiée. Il s’agit du mode recommandé pour composer des mises à niveau de déploiement dans un environnement de production.

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

-PasswordEncrypted

Indique si RegistryPassword est chiffré par Invoke-ServiceFabricEncryptText.

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

-RegistryPassword

Indique le mot de passe du registre de conteneurs. Si ce parmamètre est fourni, RegistryUserName doit être fourni ensemble.

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

-RegistryUserName

Indique le nom d’utilisateur du registre de conteneurs. Si ce parmamètre est fourni, RegistryPassword doit être fourni ensemble.

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

-ServiceTypeHealthPolicyMap

Spécifie la carte de la stratégie d’intégrité à utiliser pour différents types de service en tant que table de hachage au format suivant : @ { »ServiceTypeName" : « MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Par exemple:

@{ « ServiceTypeName01 » = « 5,10,5 » ; « ServiceTypeName02 » = « 5,5,5 » }

Type:Hashtable
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

-UnmonitoredAuto

Indique que le mode de mise à niveau n’est pas surveillé automatiquement. Une fois Service Fabric mis à niveau un domaine de mise à niveau, Service Fabric met à niveau le domaine de mise à niveau suivant, quel que soit l’état d’intégrité de l’application. Ce mode n’est pas recommandé pour la production et n’est utile que pendant le développement d’un déploiement compose.

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

-UnmonitoredManual

Indique que le mode de mise à niveau n’est pas surveillé manuellement. Une fois Service Fabric mis à niveau un domaine de mise à niveau, il attend que vous mettez à niveau le domaine de mise à niveau suivant à l’aide de l’applet de commande Resume-ServiceFabricApplicationUpgrade.

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

-UpgradeDomainTimeoutSec

Spécifie la durée maximale, en secondes, que Service Fabric prend pour mettre à niveau un domaine de mise à niveau unique. Après cette période, la mise à niveau échoue.

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

-UpgradeReplicaSetCheckTimeoutSec

Spécifie la durée maximale pendant laquelle Service Fabric attend qu’un service se reconfigure dans un état sécurisé, s’il n’est pas déjà dans un état sûr, avant que Service Fabric continue la mise à niveau.

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

-UpgradeTimeoutSec

Spécifie la durée maximale, en secondes, que Service Fabric prend pour toute la mise à niveau. Après cette période, la mise à niveau échoue.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
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