Freigeben über


Start-ServiceFabricComposeDeploymentUpgrade

VORSCHAU. Aktualisiert eine Service Fabric-Verfassenbereitstellung mit einer neuen Verfassendatei.

Syntax

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>]

Beschreibung

Dieses Cmdlet befindet sich in PREVIEW und kann in den nächsten Versionen geändert werden. Es gibt keine Kompatibilitätsgarantie.

Das Cmdlet "Start-ServiceFabricComposeDeploymentUpgrade" aktualisiert eine Service Fabric-Erstellungsbereitstellung. Dieses Cmdlet startet das Upgrade auf dem Cluster.

Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Anleitungen zur Bereitstellung von Service Fabric zum Verfassen finden Sie unter: Verfassen der Bereitstellung in Service Fabric

Beispiele

Beispiel 1: Upgrade einer Verfassenbereitstellung

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

Der Befehl führt ein überwachtes automatisches Upgrade für die Erstellungsbereitstellung mit dem Namen "mydeployment" aus der Datei "docker-compose.yml" aus. Das Upgrade wird rollback ausgeführt, wenn das überwachte Upgrade fehlschlägt. Es ist nicht erforderlich, den Anwendungstyp vorher zu registrieren.

Parameter

-Compose

Gibt den Dateipfad zu einer Zielerstellungsdatei an, die die Bereitstellung von Service Fabric zum Verfassen beschreibt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusereignis während der Integritätsauswertung als Fehlerereignis behandelt werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultServiceTypeHealthPolicy

Gibt die Integritätsrichtlinie für den Standarddiensttyp an, der für das überwachte Upgrade im Format MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices verwendet werden soll. Beispielsweise zeigen 5, 10 und 15 die folgenden Werte an:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeploymentName

Gibt den Namen der Bereitstellung zum Verfassen an. Das Cmdlet aktualisiert die Bereitstellung zum Verfassen mit diesem Namen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FailureAction

Gibt die auszuführende Aktion an, wenn das überwachte Upgrade fehlschlägt. Zulässige Werte für diesen Parameter:

  • Rollback
  • Manuell
Typ:UpgradeFailureAction
Zulässige Werte:Invalid, Rollback, Manual
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Gibt an, dass dieses Cmdlet die Warnmeldung überspringt und das Upgrade erzwingt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceRestart

Gibt an, dass alle Container in der Verfassendatei neu erstellt werden sollten, auch wenn sich die Dienstbeschreibungen in der neuen Verfassendatei nicht geändert haben.

Typ:SwitchParameter
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HealthCheckRetryTimeoutSec

Gibt die Dauer in Sekunden an, nach der Service Fabric die Integritätsprüfung erneut überprüft, wenn die vorherige Integritätsprüfung fehlschlägt.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HealthCheckStableDurationSec

Gibt die Dauer in Sekunden an, auf die Service Fabric wartet, um zu überprüfen, ob die bereitgestellte Anwendung stabil ist, bevor Sie zur nächsten Upgradedomäne wechseln oder das Upgrade abschließen. Diese Wartezeit verhindert nicht erkannte Änderungen der Integrität direkt nach der Ausführung der Integritätsprüfung.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HealthCheckWaitDurationSec

Gibt die Dauer in Sekunden an, auf die Service Fabric wartet, bevor die anfängliche Integritätsprüfung ausgeführt wird, nachdem sie das Upgrade für die Upgradedomäne abgeschlossen hat.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPercentUnhealthyDeployedApplications

Gibt den maximalen Prozentsatz der Anwendungsinstanzen an, die auf den Knoten im Cluster bereitgestellt werden, die einen Fehlerstatus aufweisen, bevor der Anwendungsstatus für den Cluster fehler ist.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Monitored

Gibt an, dass das Upgrade überwacht wird. Nachdem das Cmdlet ein Upgrade für eine Upgradedomäne abgeschlossen hat, aktualisiert Service Fabric die nächste Upgradedomäne, wenn die Integrität der Upgradedomäne und des Clusters Ihren definierten Integritätsrichtlinien entspricht. Wenn die Upgradedomäne oder der Cluster die Integritätsrichtlinien nicht erfüllt, schlägt das Upgrade fehl, und Service Fabric setzt das Upgrade für die Upgradedomäne zurück oder stellt den manuellen Modus gemäß der angegebenen Richtlinie wieder her. Dies ist der empfohlene Modus zum Verfassen von Bereitstellungsupgrades in einer Produktionsumgebung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PasswordEncrypted

Gibt an, ob RegistryPassword durch Invoke-ServiceFabricEncryptText verschlüsselt ist.

Typ:SwitchParameter
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RegistryPassword

Gibt das Kennwort der Containerregistrierung an. Wenn dieses Parmameter bereitgestellt wird, muss RegistryUserName zusammen bereitgestellt werden.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RegistryUserName

Gibt den Benutzernamen der Containerregistrierung an. Wenn dieses Parmameter bereitgestellt wird, muss RegistryPassword zusammen bereitgestellt werden.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceTypeHealthPolicyMap

Gibt die Zuordnung der Integritätsrichtlinie an, die für verschiedene Diensttypen als Hashtabelle im folgenden Format verwendet werden soll: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Beispiel:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UnmonitoredAuto

Gibt an, dass das Upgrade automatisch ausgeführt und nicht überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, aktualisiert Service Fabric die nächste Upgradedomäne unabhängig vom Integritätszustand der Anwendung. Dieser Modus wird für die Produktion nicht empfohlen und ist nur bei der Entwicklung einer Verfassenbereitstellung nützlich.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UnmonitoredManual

Gibt an, dass das Upgrade manuell ausgeführt und nicht überwacht wird. Nachdem Service Fabric eine Upgradedomäne aktualisiert hat, wartet die Plattform darauf, dass Sie die nächste Upgradedomäne mit dem Cmdlet Resume-ServiceFabricApplicationUpgrade aktualisieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradeDomainTimeoutSec

Gibt die maximale Zeit in Sekunden an, die Service Fabric benötigt, um eine einzelne Upgradedomäne zu aktualisieren. Nach diesem Zeitraum schlägt das Upgrade fehl.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradeReplicaSetCheckTimeoutSec

Gibt die maximale Zeit an, zu der Service Fabric wartet, bis ein Dienst in einen sicheren Zustand neu konfiguriert wird, sofern nicht bereits in einem sicheren Zustand, bevor Service Fabric mit dem Upgrade fortfährt.

Typ:UInt32
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradeTimeoutSec

Gibt die maximale Zeit in Sekunden an, die Service Fabric für das gesamte Upgrade benötigt. Nach diesem Zeitraum schlägt das Upgrade fehl.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object