Delen via

Start-ServiceFabricComposeDeploymentUpgrade

  • Referentie
Module:
ServiceFabric

VOORBEELD. Hiermee wordt een Implementatie van Service Fabric-opstellen bijgewerkt met een nieuw compose-bestand.

Syntaxis

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

Deze cmdlet bevindt zich in PREVIEW en kan worden gewijzigd in de volgende release(s). Er is geen compatibiliteitsgarantie.

De Start-ServiceFabricComposeDeploymentUpgrade cmdlet upgradet een Service Fabric compose-implementatie. Met deze cmdlet wordt de upgrade gestart op het cluster.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster.

Raadpleeg voor hulp bij de implementatie van Service Fabric compose het volgende: Compose-implementatie in Service Fabric

Voorbeelden

Voorbeeld 1: Een opstellen-implementatie upgraden

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

Met de opdracht wordt een bewaakte automatische upgrade uitgevoerd voor de opstellen-implementatie met de naam mydeployment van het opstellenbestand docker-compose.yml. De upgrade wordt teruggedraaid als de bewaakte upgrade mislukt. U hoeft het toepassingstype niet vooraf te registreren.

Parameters

-Compose

Hiermee geeft u het bestandspad naar een doel opstellen bestand dat de Service Fabric compose-implementatie beschrijft.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConsiderWarningAsError

Hiermee wordt aangegeven of een waarschuwingsstatus gebeurtenis moet worden behandeld als een fout tijdens de statusevaluatie.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultServiceTypeHealthPolicy

Hiermee geeft u het statusbeleid voor het standaardservicetype dat moet worden gebruikt voor de bewaakte upgrade in de indeling MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Bijvoorbeeld: 5.10.15 geeft de volgende waarden aan:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DeploymentName

Hiermee geeft u de naam van de opstellen-implementatie. De cmdlet werkt de opstellen-implementatie bij met deze naam.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FailureAction

Hiermee geeft u de actie op die moet worden uitgevoerd als de bewaakte upgrade mislukt. De acceptabele waarden voor deze parameter zijn:

  • Terugdraaien
  • Handmatig
Type:UpgradeFailureAction
Geaccepteerde waarden:Invalid, Rollback, Manual
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Geeft aan dat deze cmdlet het waarschuwingsbericht overslaat en de upgrade dwingt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ForceRestart

Geeft aan dat alle containers in het opstellenbestand opnieuw moeten worden gemaakt, zelfs als de servicebeschrijvingen niet zijn gewijzigd in het nieuwe opstellenbestand.

Type:SwitchParameter
Position:5
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HealthCheckRetryTimeoutSec

Hiermee geeft u de duur op, in seconden, waarna Service Fabric de statuscontrole opnieuw probeert uit te proberen als de vorige statuscontrole mislukt.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HealthCheckStableDurationSec

Hiermee geeft u de duur, in seconden, op dat Service Fabric wacht om te controleren of de toepassing die de implementatie opstellen, stabiel is voordat u naar het volgende upgradedomein gaat of de upgrade voltooit. Deze wachttijd voorkomt niet-gedetecteerde wijzigingen van de status direct nadat de statuscontrole is uitgevoerd.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HealthCheckWaitDurationSec

Hiermee geeft u de duur in seconden op die Service Fabric wacht voordat de eerste statuscontrole wordt uitgevoerd nadat de upgrade op het upgradedomein is voltooid.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxPercentUnhealthyDeployedApplications

Hiermee geeft u het maximumpercentage op van de toepassingsexemplaren die zijn geïmplementeerd op de knooppunten in het cluster met een status van een fout voordat de status van de toepassing voor het cluster een fout is.

Type:Byte
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Monitored

Geeft aan dat de upgrademodus wordt bewaakt. Nadat de cmdlet een upgrade voor een upgradedomein heeft voltooid, wordt het volgende upgradedomein bijgewerkt als de status van het upgradedomein en het cluster voldoen aan het statusbeleid dat u definieert. Als het upgradedomein of cluster niet voldoet aan het statusbeleid, mislukt de upgrade en wordt de upgrade voor het upgradedomein teruggedraaid of wordt de upgrade teruggezet naar de handmatige modus volgens het opgegeven beleid. Dit is de aanbevolen modus voor het opstellen van implementatie-upgrades in een productieomgeving.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PasswordEncrypted

Geeft aan of RegistryPassword- is versleuteld door Invoke-ServiceFabricEncryptText.

Type:SwitchParameter
Position:4
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RegistryPassword

Geeft het wachtwoord van het containerregister aan. Als deze indexmeter is opgegeven, moet RegistryUserName samen worden verstrekt.

Type:String
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RegistryUserName

Geeft de gebruikersnaam van het containerregister aan. Als deze parmameter wordt verstrekt, moet RegistryPassword samen worden geleverd.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServiceTypeHealthPolicyMap

Hiermee geeft u de kaart van het statusbeleid te gebruiken voor verschillende servicetypen als een hash-tabel in de volgende indeling: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Bijvoorbeeld:

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

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UnmonitoredAuto

Geeft aan dat de upgrademodus automatisch niet wordt bewaakt. Nadat Service Fabric een upgradedomein heeft bijgewerkt, wordt het volgende upgradedomein bijgewerkt, ongeacht de status van de toepassing. Deze modus wordt niet aanbevolen voor productie en is alleen nuttig tijdens het ontwikkelen van een opstellenimplementatie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UnmonitoredManual

Geeft aan dat de upgrademodus niet-bewaakt handmatig is. Nadat Service Fabric een upgradedomein heeft bijgewerkt, wacht het totdat u het volgende upgradedomein bijwerkt met behulp van de cmdlet Resume-ServiceFabricApplicationUpgrade.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UpgradeDomainTimeoutSec

Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft om één upgradedomein bij te werken. Na deze periode mislukt de upgrade.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UpgradeReplicaSetCheckTimeoutSec

Hiermee geeft u de maximale tijd op waarop Service Fabric wacht totdat een service opnieuw wordt geconfigureerd in een veilige status, als deze nog niet in een veilige status is, voordat Service Fabric verdergaat met de upgrade.

Type:UInt32
Position:6
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UpgradeTimeoutSec

Hiermee geeft u de maximale tijd in seconden op die Service Fabric nodig heeft voor de volledige upgrade. Na deze periode mislukt de upgrade.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

System.Object