Update-ServiceFabricClusterUpgrade
Modifica la descrizione dell'aggiornamento di un aggiornamento del cluster attivo.
Sintassi
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>] Descrizione
Il cmdlet Update-ServiceFabricClusterUpgrade modifica i parametri di una descrizione dell'aggiornamento del cluster mentre l'aggiornamento è ancora attivo. Service Fabric rileva e applica le modifiche in base al valore FabricUpgradeStatusPollInterval , come specificato nel manifesto del cluster. Ad eccezione dei criteri di valutazione dell'integrità, questo cmdlet aggiorna solo i parametri specificati. I parametri non specificati rimangono invariati. È necessario aggiornare i criteri di valutazione dell'integrità seguenti, non singolarmente:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Per gestire i cluster di Service Fabric, avviare Windows PowerShell usando l'opzione Esegui come amministratore. Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .
Esempio
Esempio 1: Aggiornare un valore per un aggiornamento del cluster
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0Questo comando imposta il timeout del set di repliche su 0 per un aggiornamento del cluster in sospeso. L'aggiornamento lascia solo tutti gli altri valori di aggiornamento.
Esempio 2: Aggiornare i criteri di integrità per un aggiornamento del cluster
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 $appHealthPolicyMapQuesto comando modifica i criteri di integrità del cluster di aggiornamento del cluster. Specifica la mappa dei criteri di integrità dei tipi di applicazione che contiene il tipo di applicazione CriticalAppType, che non tollera errori. Le altre applicazioni vengono valutate usando il 20% massimo percentuale non integra.
Il comando aggiorna anche i criteri di integrità dell'applicazione usati per valutare l'applicazione fabric:/System come parte della valutazione dell'integrità dell'aggiornamento del cluster. I nuovi criteri tollerano tutti gli errori di partizione.
Parametri
-ApplicationHealthPolicyMap
Specifica un System.Fabric.Health.ApplicationHealthPolicyMap che include criteri di integrità personalizzati per alcune o tutte le applicazioni. Se non si specifica questo parametro o se non si include una voce nella mappa per un'applicazione, tale applicazione viene valutata con i criteri di integrità dell'applicazione definiti nel manifesto dell'applicazione se esiste o il criterio predefinito in caso contrario.
| Type: | ApplicationHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeHealthPolicyMap
Specifica la mappa che definisce la percentuale massima di applicazioni non integre consentite per ogni tipo di applicazione. I tipi di applicazione in questa mappa vengono valutati usando percentuali specifiche anziché la percentuale globale MaxPercentUnhealthyApplications .
Ad esempio, se alcune applicazioni di un tipo sono di importanza critica, l'amministratore del cluster può aggiungere una voce alla mappa per tale tipo di applicazioni e assegnarle un valore pari a 0% (ovvero, non tollerare alcun errore). Tutte le altre applicazioni possono essere valutate con MaxPercentUnhealthyApplications impostata sul 20% per tollerare alcuni errori fuori dalle migliaia di istanze dell'applicazione.
La mappa dei criteri di integrità dei tipi di applicazione viene usata solo se il manifesto del cluster abilita la valutazione dell'integrità del tipo di applicazione usando la voce di configurazione per HealthManager/EnableApplicationTypeHealthEvaluation.
| Type: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsiderWarningAsError
Indica se considerare un report di integrità degli avvisi come errore durante la valutazione dell'integrità.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDeltaHealthEvaluation
Indica se abilitare i controlli di integrità differenziali durante la valutazione dell'integrità negli aggiornamenti monitorati. Se si specifica un valore di $True, Service Fabric acquisisce uno snapshot dell'integrità all'inizio dell'aggiornamento. Al termine dell'aggiornamento, i controlli di integrità confrontano lo stato corrente del cluster con lo snapshot. Se si verifica una riduzione dell'integrità che non rispetta le percentuali massime consentite dai criteri di integrità dell'aggiornamento del cluster corrente, i controlli di integrità hanno esito negativo.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailureAction
Specifica l'azione da eseguire se l'aggiornamento monitorato ha esito negativo. I valori validi per questo parametro sono:
- Rollback
- manuale.
| Type: | UpgradeFailureAction |
| Accepted values: | Invalid, Rollback, Manual |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Indica che questo cmdlet ignora il messaggio di avviso e forza l'aggiornamento.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceRestart
Indica se riavviare il nodo di Service Fabric anche se sono state modificate solo configurazioni dinamiche.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Specifica la durata, in secondi, dopo la quale Service Fabric esegue il tentativo di verifica dell'integrità se il controllo di integrità precedente ha esito negativo.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Specifica la durata, in secondi, che Service Fabric attende per verificare che il cluster sia stabile prima di continuare con il dominio di aggiornamento successivo o completare l'aggiornamento. Questa durata di attesa impedisce modifiche non rilevate dell'integrità subito dopo l'esecuzione del controllo integrità.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Specifica la durata, in secondi, che Service Fabric attende prima di eseguire il controllo di integrità iniziale al termine dell'aggiornamento nel dominio di aggiornamento.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
Specifica la durata in secondi, per attendere prima che un'istanza senza stato interessata dall'aggiornamento del cluster sia chiusa, per consentire alle richieste attive di svuotare in modo corretto. Questa durata di attesa è valida solo per le istanze di tali servizi senza stato che hanno un valore diverso da zero configurato per InstanceCloseDelayDuration e eseguirà l'override del valore preconfigurato. Per informazioni dettagliate , vedere InstanceCloseDelayDuration .
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentDeltaUnhealthyNodes
Specifica la percentuale massima tollerata di nodi delta non integri che possono avere stati di integrità aggregati di errore. Se i nodi non integri correnti non rispettano la percentuale relativa allo stato all'inizio dell'aggiornamento, il cluster non è integro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyApplications
Specifica la percentuale massima tollerata di applicazioni che possono avere stato di integrità aggregato di errore. Se l'aggiornamento supera questa percentuale, il cluster non è integro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyNodes
Specifica la percentuale massima tollerata di nodi che possono avere stati di integrità aggregati di errore. Se un aggiornamento supera questa percentuale, il cluster non è integro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Specifica la percentuale massima tollerata di nodi del delta del dominio di aggiornamento non integri che possono avere stato di integrità aggregato di errore. Se è presente un dominio di aggiornamento in cui i nodi non integri correnti non rispettano la percentuale relativa allo stato all'inizio dell'aggiornamento, il cluster non è integro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
Definisce una mappa con percentuali massime di nodi non integri per tipi di nodo specifici.
La mappa dei criteri di integrità dei tipi di nodo può essere usata durante la valutazione dell'integrità del cluster per descrivere tipi di nodi speciali. I tipi di nodo inclusi nella mappa vengono valutati rispetto alla percentuale inclusa nella mappa e anche con il globale (vedere System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). I nodi dei tipi di nodo specificati nella mappa vengono conteggiati anche nel pool globale di nodi; sono controlli indipendenti.
| Type: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Specifica il periodo di timeout, in secondi, per l'operazione.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Specifica il tempo massimo, in secondi, che Service Fabric richiede per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeMode
Specifica il nuovo UpgradeMode per l'aggiornamento.
| Type: | RollingUpgradeMode |
| Accepted values: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Specifica il tempo massimo, in secondi, che Service Fabric attende che un set di repliche venga riconfigurato in uno stato sicuro, se non è già in uno stato sicuro, prima che Service Fabric proceda con l'aggiornamento.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeTimeoutSec
Specifica il tempo massimo, in secondi, che Service Fabric richiede per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento ha esito negativo.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Output
System.Object