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