Udostępnij za pośrednictwem

Update-ServiceFabricClusterUpgrade

  • Odwołanie
Moduł:
ServiceFabric

Modyfikuje opis uaktualnienia aktywnego uaktualnienia klastra.

Składnia

Update-ServiceFabricClusterUpgrade
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-MaxPercentUnhealthyApplications <Byte>]
      [-MaxPercentUnhealthyNodes <Byte>]
      [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
      [-EnableDeltaHealthEvaluation <Boolean>]
      [-MaxPercentDeltaUnhealthyNodes <Byte>]
      [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
      [-Force]
      [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Update-ServiceFabricClusterUpgrade modyfikuje parametry opisu uaktualnienia klastra, gdy uaktualnienie jest nadal aktywne. Usługa Service Fabric wykrywa i stosuje zmiany zgodnie z wartością FabricUpgradeStatusPollInterval , jak określono w manifeście klastra. Z wyjątkiem zasad oceny kondycji to polecenie cmdlet aktualizuje tylko określone parametry. Nieokreślone parametry pozostają niezmienione. Należy zaktualizować następujące zasady oceny kondycji razem, a nie osobno:

  • RozważwarningAsError
  • MaxPercent W złej kondycjiAplikacje
  • MaxPercentUnhealthyNodes

Aby zarządzać klastrami usługi Service Fabric, uruchom Windows PowerShell przy użyciu opcji Uruchom jako administrator. Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .

Przykłady

Przykład 1. Aktualizowanie wartości uaktualnienia klastra

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

To polecenie ustawia limit czasu sprawdzania zestawu replik na wartość 0 dla oczekującego uaktualnienia klastra. Aktualizacja pozostawia wszystkie inne wartości uaktualnienia.

Przykład 2. Aktualizowanie zasad kondycji dla uaktualnienia klastra

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

To polecenie zmienia zasady kondycji klastra uaktualniania klastra. Określa mapę zasad kondycji typu aplikacji zawierającą typ aplikacji CriticalAppType, który nie tolerował żadnych awarii. Pozostałe aplikacje są oceniane przy użyciu 20% maksymalnej kondycji procentu.

Polecenie aktualizuje również zasady kondycji aplikacji używane do oceny kondycji sieci szkieletowej:/System w ramach oceny kondycji uaktualnienia klastra. Nowe zasady tolerują wszystkie błędy partycji.

Parametry

-ApplicationHealthPolicyMap

Określa element System.Fabric.Health.ApplicationHealthPolicyMap , który zawiera niestandardowe zasady kondycji dla niektórych lub wszystkich aplikacji. Jeśli nie określisz tego parametru lub jeśli nie dołączysz wpisu do mapy aplikacji, ta aplikacja jest oceniana przy użyciu zasad kondycji aplikacji zdefiniowanych w manifeście aplikacji, jeśli istnieje, lub w przeciwnym razie zasady domyślne.

Type:ApplicationHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeHealthPolicyMap

Określa mapę, która definiuje maksymalny procent aplikacji w złej kondycji dozwolonych dla każdego typu aplikacji. Typy aplikacji na tej mapie są oceniane przy użyciu określonych wartości procentowych, a nie globalnej wartości procentowej MaxPercent W złej kondycjiAplikacje .

Jeśli na przykład niektóre aplikacje typu mają krytyczne znaczenie, administrator klastra może dodać wpis do mapy dla tego typu aplikacji i przypisać mu wartość 0% (czyli nie tolerować żadnych awarii). Wszystkie inne aplikacje można ocenić za pomocą parametru MaxPercentUnhealthyApplications ustawionego na 20%, aby tolerować niektóre błędy z tysięcy wystąpień aplikacji.

Mapa zasad kondycji typu aplikacji jest używana tylko wtedy, gdy manifest klastra umożliwia ocenę kondycji typu aplikacji przy użyciu wpisu konfiguracji healthManager/EnableApplicationTypeHealthEvaluation.

Type:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsiderWarningAsError

Wskazuje, czy raport kondycji ostrzeżenia ma być traktowany jako błąd podczas oceny kondycji.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDeltaHealthEvaluation

Wskazuje, czy włączyć kontrole kondycji różnicowej podczas oceny kondycji w monitorowanych uaktualnieniach. Jeśli określisz wartość $True, usługa Service Fabric tworzy migawkę kondycji na początku uaktualnienia. Po zakończeniu uaktualniania każdej domeny uaktualnienia testy kondycji porównują bieżący stan klastra z migawką. Jeśli występuje spadek kondycji, który nie uwzględnia maksymalnych wartości procentowych z bieżących zasad kondycji uaktualniania klastra, testy kondycji kończą się niepowodzeniem.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureAction

Określa akcję, która ma być wykonywana, jeśli monitorowane uaktualnienie zakończy się niepowodzeniem. Dopuszczalne wartości dla tego parametru to:

  • Wycofywanie
  • ręcznie.
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wskazuje, że to polecenie cmdlet pomija komunikat ostrzegawczy i wymusza aktualizację.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceRestart

Wskazuje, czy należy ponownie uruchomić węzeł usługi Service Fabric, nawet jeśli tylko konfiguracje dynamiczne uległy zmianie.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckRetryTimeoutSec

Określa czas trwania w sekundach, po którym usługa Service Fabric ponawia próbę sprawdzenia kondycji, jeśli poprzednia kontrola kondycji zakończy się niepowodzeniem.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckStableDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric w celu sprawdzenia, czy klaster jest stabilny, zanim przejdzie do następnej domeny uaktualnienia lub ukończy uaktualnienie. Ten czas oczekiwania uniemożliwia niezakryte zmiany kondycji bezpośrednio po wykonaniu kontroli kondycji.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckWaitDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric przed wykonaniem początkowej kontroli kondycji po zakończeniu uaktualniania w domenie uaktualnienia.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceCloseDelayDurationSec

Określa czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, na które ma wpływ uaktualnienie klastra, aby umożliwić bezproblemowe opróżnianie aktywnych żądań. Ten czas oczekiwania jest skuteczny tylko dla wystąpień tych usług bezstanowych, które mają wartość niezerową skonfigurowaną dla klasy InstanceCloseDelayDuration i zastąpią wstępnie skonfigurowaną wartość. Aby uzyskać szczegółowe informacje, zobacz InstanceCloseDelayDuration .

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentDeltaUnhealthyNodes

Określa maksymalny tolerowany procent węzłów różnicowych w złej kondycji, które mogą mieć zagregowane stany kondycji błędu. Jeśli bieżące węzły w złej kondycji nie przestrzegają wartości procentowej względem stanu na początku uaktualnienia, klaster jest w złej kondycji.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyApplications

Określa maksymalny tolerowany procent aplikacji, które mogą mieć zagregowany stan kondycji błędu. Jeśli uaktualnienie przekroczy tę wartość procentową, klaster jest w złej kondycji.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyNodes

Określa maksymalny tolerowany procent węzłów, które mogą mieć zagregowane stany kondycji błędu. Jeśli uaktualnienie przekroczy tę wartość procentową, klaster jest w złej kondycji.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Określa maksymalny tolerowany procent węzłów różnicowych domeny uaktualnienia, które mogą mieć zagregowany stan kondycji błędu. Jeśli istnieje jakakolwiek domena uaktualnienia, w której bieżące węzły w złej kondycji nie przestrzegają wartości procentowej względem stanu na początku uaktualnienia, klaster jest w złej kondycji.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeTypeHealthPolicyMap

Definiuje mapę z maksymalnymi wartościami procentowymi węzłów w złej kondycji dla określonych typów węzłów.

Mapa zasad kondycji typu węzła może być używana podczas oceny kondycji klastra w celu opisania specjalnych typów węzłów. Typy węzłów uwzględnione w mapie są oceniane względem wartości procentowej uwzględnionej w mapie, a także z globalnymi (zobacz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Węzły typów węzłów określonych na mapie są również liczone względem globalnej puli węzłów; są to niezależne kontrole.

Type:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeDomainTimeoutSec

Określa maksymalny czas w sekundach potrzebny do uaktualnienia pojedynczej domeny uaktualnienia przez usługę Service Fabric. Po upływie tego okresu uaktualnienie zakończy się niepowodzeniem.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeMode

Określa nowy tryb UpgradeMode dla uaktualnienia.

Type:RollingUpgradeMode
Accepted values:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeReplicaSetCheckTimeoutSec

Określa maksymalny czas w sekundach, który usługa Service Fabric czeka na ponowne skonfigurowanie repliki w bezpiecznym stanie, jeśli nie jest jeszcze w bezpiecznym stanie, zanim usługa Service Fabric przejdzie do uaktualnienia.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeTimeoutSec

Określa maksymalny czas w sekundach potrzebny na całe uaktualnienie usługi Service Fabric. Po upływie tego okresu uaktualnienie zakończy się niepowodzeniem.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

System.Object