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ć razem następujące zasady oceny kondycji, a nie osobno:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

Aby zarządzać klastrami usługi Service Fabric, uruchom program 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 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 toleruje żadnych błędów. 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 System.Fabric.Health.ApplicationHealthPolicyMap, która 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 dla aplikacji, ta aplikacja zostanie oceniona przy użyciu zasad kondycji aplikacji zdefiniowanych w manifeście aplikacji, jeśli istnieje, lub w przeciwnym razie zasady domyślne.

Typ:ApplicationHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeHealthPolicyMap

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

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ą MaxPercentUnhealthyApplications ustawioną na 20%, aby tolerować niektóre awarie 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 dla HealthManager/EnableApplicationTypeHealthEvaluation.

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConsiderWarningAsError

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 dozwolonych z bieżących zasad kondycji uaktualniania klastra, testy kondycji kończą się niepowodzeniem.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FailureAction

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

  • Wycofywanie
  • Ręcznie.
Typ:UpgradeFailureAction
Dopuszczalne wartości:Invalid, Rollback, Manual
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ForceRestart

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 zapobiega niezkrytym zmianom kondycji bezpośrednio po wykonaniu kontroli kondycji.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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ą niezerową wartość skonfigurowaną dla klasy InstanceCloseDelayDuration i zastąpią wstępnie skonfigurowaną wartość. Aby uzyskać szczegółowe informacje, zobacz InstanceCloseDelayDuration.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 zawarte w mapie są oceniane względem wartości procentowej uwzględnionej w mapie, a także z globalnym (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.

Typ:NodeTypeHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeDomainTimeoutSec

Określa maksymalny czas (w sekundach), który zajmuje usłudze Service Fabric uaktualnienie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeMode

Określa nowy UpgradeMode uaktualnienia.

Typ:RollingUpgradeMode
Dopuszczalne wartości:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeTimeoutSec

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

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object