Update-ServiceFabricClusterUpgrade
활성 클러스터 업그레이드에 대한 업그레이드 설명을 수정합니다.
Syntax
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>] Description
Update-ServiceFabricClusterUpgrade cmdlet은 업그레이드가 활성 상태인 동안 클러스터 업그레이드 설명의 매개 변수를 수정합니다. Service Fabric은 클러스터 매니페스트에 지정된 대로 FabricUpgradeStatusPollInterval 값에 따라 변경 내용을 검색하고 적용합니다. 상태 평가 정책을 제외하고 이 cmdlet은 지정한 매개 변수만 업데이트합니다. 지정되지 않은 매개 변수는 영향을 받지 않습니다. 다음 상태 평가 정책을 개별적으로 업데이트하지 않고 함께 업데이트해야 합니다.
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Service Fabric 클러스터를 관리하려면 관리자 권한으로 실행 옵션을 사용하여 Windows PowerShell 시작합니다. Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.
예제
예제 1: 클러스터 업그레이드에 대한 값 업데이트
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0이 명령은 보류 중인 클러스터 업그레이드에 대한 복제본 집합 확인 시간 제한 기간을 0으로 설정합니다. 업데이트는 다른 모든 업그레이드 값만 남습니다.
예제 2: 클러스터 업그레이드에 대한 상태 정책 업데이트
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이 명령은 클러스터 업그레이드 클러스터 상태 정책을 변경합니다. 실패를 용납하지 않는 애플리케이션 유형 CriticalAppType을 포함하는 애플리케이션 유형 상태 정책 맵을 지정합니다. 나머지 애플리케이션은 20%의 최대 비정상 백분율을 사용하여 평가됩니다.
또한 이 명령은 클러스터 업그레이드 상태 평가의 일부로 fabric:/System 애플리케이션을 평가하는 데 사용되는 애플리케이션 상태 정책을 업데이트합니다. 새 정책은 모든 파티션 오류를 허용합니다.
매개 변수
-ApplicationHealthPolicyMap
일부 또는 모든 애플리케이션에 대한 사용자 지정 상태 정책을 포함하는 System.Fabric.Health.ApplicationHealthPolicyMap 을 지정합니다. 이 매개 변수를 지정하지 않거나 애플리케이션에 대한 맵에 항목을 포함하지 않으면 해당 애플리케이션이 있는 경우 애플리케이션 매니페스트에 정의된 애플리케이션 상태 정책을 사용하여 평가되거나, 그렇지 않으면 기본 정책으로 평가됩니다.
| Type: | ApplicationHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeHealthPolicyMap
애플리케이션 유형별로 허용되는 비정상 애플리케이션의 최대 비율을 정의하는 맵을 지정합니다. 이 맵의 애플리케이션 유형은 전역 MaxPercentUnhealthyApplications 백분율이 아닌 특정 백분율을 사용하여 평가됩니다.
예를 들어 한 형식의 일부 애플리케이션이 중요한 경우, 클러스터 관리자는 항목을 해당 애플리케이션 유형에 대한 맵에 추가하고 0%의 값을 할당할 수 있습니다(즉, 오류를 허용하지 않음). 다른 모든 애플리케이션은 MaxPercentUnhealthyApplications 를 20%로 설정하여 수천 개의 애플리케이션 인스턴스에서 일부 오류를 허용할 수 있습니다.
애플리케이션 유형 상태 정책 맵은 클러스터 매니페스트가 HealthManager/EnableApplicationTypeHealthEvaluation에 대한 구성 항목을 사용하여 애플리케이션 유형 상태 평가를 사용하도록 설정하는 경우에만 사용됩니다.
| Type: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인을 요청합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsiderWarningAsError
상태 평가 중 경고 상태 보고서를 오류로 처리할지 여부를 나타냅니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDeltaHealthEvaluation
모니터링되는 업그레이드에서 상태를 평가하는 동안 델타 상태 검사를 사용할지 여부를 나타냅니다. $True 값을 지정하는 경우 Service Fabric은 업그레이드 시작 시 상태의 스냅샷을 만듭니다. 각 업그레이드 도메인이 업그레이드를 완료한 후 상태 검사는 클러스터의 현재 상태를 스냅샷과 비교합니다. 현재 클러스터 업그레이드 상태 정책의 최대 허용 비율을 준수하지 않는 상태 저하가 있는 경우 상태 검사가 실패합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailureAction
모니터링되는 업그레이드가 실패할 경우 수행할 작업을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 롤백
- 수동.
| Type: | UpgradeFailureAction |
| Accepted values: | Invalid, Rollback, Manual |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
이 cmdlet은 경고 메시지를 건너뛰고 강제로 업데이트를 수행했음을 나타냅니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceRestart
동적 구성만 변경된 경우에도 Service Fabric 노드를 다시 시작할지 여부를 나타냅니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
이전 상태 검사가 실패하면 Service Fabric이 상태 검사를 다시 시도한 기간(초)을 지정합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckStableDurationSec
클러스터가 다음 업그레이드 도메인으로 계속 진행되거나 업그레이드를 완료하기 전에 클러스터가 안정적인지 확인하기 위해 Service Fabric이 대기하는 기간(초)을 지정합니다. 이 대기 기간은 상태 검사가 수행된 직후에 감지되지 않은 상태 변경을 방지합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Service Fabric이 업그레이드 도메인에서 업그레이드를 완료한 후 초기 상태 검사를 수행하기 전에 대기하는 기간(초)을 지정합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
활성 요청이 정상적으로 드레이닝될 수 있도록 클러스터 업그레이드의 영향을 받는 상태 비정상 인스턴스가 닫히기 전까지 대기하는 기간(초)을 지정합니다. 이 대기 기간은 InstanceCloseDelayDuration에 대해 0이 아닌 값을 구성하고 미리 구성된 값을 재정의하는 상태 비저장 서비스의 인스턴스에만 적용됩니다. 자세한 내용은 InstanceCloseDelayDuration 을 참조하세요.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentDeltaUnhealthyNodes
집계된 상태 오류 상태를 가질 수 있는 델타 비정상 노드의 최대 허용 비율을 지정합니다. 현재 비정상 노드가 업그레이드 시작 시 상태에 상대적인 백분율을 존중하지 않으면 클러스터가 비정상입니다.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyApplications
집계된 오류 상태를 가질 수 있는 애플리케이션의 최대 허용 비율을 지정합니다. 업그레이드가 이 비율을 초과하면 클러스터가 비정상입니다.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyNodes
집계된 오류 상태를 가질 수 있는 노드의 최대 허용 비율을 지정합니다. 업그레이드가 이 비율을 초과하면 클러스터가 비정상입니다.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
집계된 상태 오류 상태를 가질 수 있는 업그레이드 도메인 델타 비정상 노드의 최대 허용 비율을 지정합니다. 현재 비정상 노드가 업그레이드 시작 시 상태에 상대적인 백분율을 존중하지 않는 업그레이드 도메인이 있는 경우 클러스터가 비정상입니다.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
특정 노드 형식에 대해 최대 백분율이 비정상 노드인 맵을 정의합니다.
클러스터 상태를 평가하는 동안 노드 유형 상태 정책 맵을 사용하여 특수 노드 유형을 설명할 수 있습니다. 맵에 포함된 노드 형식은 맵에 포함된 백분율 및 전역(System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes 참조)에 대해 평가됩니다. 맵에 지정된 노드 형식의 노드도 노드의 전역 풀에 대해 계산됩니다. 독립적인 검사입니다.
| Type: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
작업의 제한 시간(초)을 지정합니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Service Fabric이 단일 업그레이드 도메인을 업그레이드하는 데 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeMode
업그레이드에 대한 새 UpgradeMode 를 지정합니다.
| Type: | RollingUpgradeMode |
| Accepted values: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Service Fabric이 업그레이드를 진행하기 전에 복제본 집합이 안전한 상태로 다시 구성될 때까지 대기하는 최대 시간(초)을 지정합니다( 아직 안전한 상태가 아닌 경우).
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeTimeoutSec
Service Fabric이 전체 업그레이드에 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
None
출력
System.Object