Service Fabric 노드 형식을 제거하는 방법

아티클
02/13/2024

이 문서에서는 클러스터에서 기존 노드 유형을 제거하여 Azure Service Fabric 클러스터의 크기를 조정하는 방법을 설명합니다. Service Fabric 클러스터는 마이크로 서비스가 배포되고 관리되는 네트워크로 연결된 가상 또는 실제 머신 집합입니다. 클러스터의 일부인 머신 또는 VM을 노드라고 합니다. 가상 머신 확장 집합은 가상 머신의 모음을 집합으로 배포하고 관리하는 데 사용할 수 있는 Azure 컴퓨팅 리소스입니다. Azure 클러스터에 정의된 모든 노드 유형은 별도의 확장 집합으로 설정됩니다. 각 노드 형식을 별도로 관리할 수 있습니다. Service Fabric 클러스터를 만든 후에 노드 유형(가상 머신 확장 집합) 및 모든 노드를 제거하여 클러스터를 수평 확장할 수 있습니다. 클러스터에서 워크로드가 실행되는 경우에도 언제든지 클러스터의 크기를 조정할 수 있습니다. 클러스터의 크기를 조정하면 애플리케이션 크기도 자동으로 조정됩니다.

Warning

이 방법을 사용하여 프로덕션 클러스터에서 노드 형식을 제거하는 것은 자주 사용하지 않는 것이 좋습니다. 노드 유형 뒤의 가상 머신 확장 집합 리소스가 삭제되므로 위험한 명령입니다.

내구성 특징

Remove-AzServiceFabricNodeType을 사용하는 경우 속도보다 안전성을 우선으로 합니다. 다음과 같은 이유로 노드 유형은 실버 또는 골드 내구성 수준이어야 합니다.

Bronze는 상태 정보 저장이 전혀 보장되지 않습니다.
실버 및 골드 내구성은 확장 집합에 대한 모든 변경 내용을 트래핑합니다.
골드의 경우 확장 집합 아래에 있는 Azure 업데이트를 제어할 수도 있습니다.

Service Fabric은 데이터가 손실되지 않도록 내부 변경 및 업데이트를 "오케스트레이션"합니다. 단, 브론즈 내구성으로 노드 형식을 제거하면 상태 정보가 손실될 수 있습니다. 주 노드 형식을 제거하는 중이며 애플리케이션이 상태 비저장이면 브론즈가 허용됩니다. 프로덕션에서 상태 저장 워크로드를 실행하는 경우에는 최소 구성이 Silver여야 합니다. 마찬가지로 프로덕션 시나리오의 경우 주 노드 유형은 항상 Silver 또는 Gold여야 합니다.

Bronze 내구성에 대한 자세한 정보

Bronze 노드 유형을 제거하면 노드 유형의 모든 노드가 즉시 다운됩니다. Service Fabric은 브론즈 노드 확장 집합 업데이트를 트래핑하지 않기 때문에 모든 VM이 즉시 다운됩니다. 해당 노드에 상태 저장 항목이 있으면 데이터가 손실됩니다. 이제 상태 비저장이더라도 Service Fabric의 모든 노드가 링에 참여하기 때문에 전체 환경이 손실되어 클러스터 자체가 불안정해질 수 있습니다.

노드 형식 제거

프로세스를 시작하기 전에 다음 필수 조건을 확인합니다.
- 클러스터가 정상입니다.
- 노드 형식을 제거한 후에도 충분한 용량이 있습니다(예: 필요한 복제본 수를 배치할 노드 수).
배치 제약 조건이 있는 모든 서비스를 이동하여 해당 노드 형식 이외의 노드 형식을 사용하도록 합니다.
- 더 이상 해당 노드 형식을 참조하지 않도록 애플리케이션/서비스 매니페스트를 수정합니다.
- 변경 내용을 배포합니다.
그런 다음, 다음 사항을 확인합니다.
- 위에서 수정된 모든 서비스가 더 이상 해당 노드 형식에 속하는 노드에서 실행되지 않습니다.
- 모든 서비스가 정상입니다.
노드 형식을 주 노드가 아닌 노드로 표시 해제합니다(주 노드가 아닌 노드 형식의 경우 건너뜀).
- 배포에 사용되는 Azure Resource Manager 템플릿을 찾습니다.
- Service Fabric 섹션에서 노드 형식과 관련된 섹션을 찾습니다.
- isPrimary 속성을 false로 변경합니다. ** 이 작업의 노드 형식과 관련된 섹션을 제거하지 마세요.
- 수정된 Azure Resource Manager 템플릿을 배포합니다. ** 클러스터 구성에 따라 이 단계는 시간이 오래 걸릴 수 있습니다.
그런 다음, 다음 사항을 확인합니다.
- 포털의 Service Fabric 섹션에 클러스터가 준비된 것으로 나타냅니다.
- 클러스터가 정상입니다.
- 해당 노드 형식에 속하는 어떤 노드도 시드 노드로 표시되지 않습니다.
해당 노드 형식의 각 노드를 사용하지 않도록 설정합니다.

PowerShell을 사용하여 클러스터에 연결하고 다음 단계를 실행합니다.
```
$nodeType = "" # specify the name of node type
$nodes = Get-ServiceFabricNode

foreach($node in $nodes)
{
  if ($node.NodeType -eq $nodeType)
  {
    $node.NodeName

    Disable-ServiceFabricNode -Intent RemoveNode -NodeName $node.NodeName -Force
  }
}
```
- 브론즈 내구성의 경우 모든 노드가 사용할 수 없는 상태가 될 때까지 기다립니다.
- 실버 및 골드 내구성의 경우 일부 노드는 사용할 수 없는 상태로 전환되고 다른 노드는 사용하지 않도록 설정 중인 상태가 됩니다. 사용하지 않도록 설정 중인 상태의 노드가 모두 인프라 서비스 파티션에 대한 쿼럼 보장 단계에 멈춰 있는 경우 계속 진행해도 안전한지 해당 노드의 세부 정보 탭을 확인하세요.

노드 형식에 대한 데이터를 중지합니다.

PowerShell을 사용하여 클러스터에 연결하고 다음 단계를 실행합니다.

foreach($node in $nodes)
{
  if ($node.NodeType -eq $nodeType)
  {
    $node.NodeName

    Start-ServiceFabricNodeTransition -Stop -OperationId (New-Guid) -NodeInstanceId $node.NodeInstanceId -NodeName $node.NodeName -StopDurationInSeconds 10000
  }
}

노드 형식의 모든 노드가 다운으로 표시될 때까지 기다립니다.

원본 가상 머신 확장 집합에서 노드 할당을 취소합니다.

확장 집합이 배포된 Azure 구독에 로그인하여 가상 머신 확장 집합을 제거합니다.

$scaleSetName="myscaleset"
$scaleSetResourceType="Microsoft.Compute/virtualMachineScaleSets"

Remove-AzResource -ResourceName $scaleSetName -ResourceType $scaleSetResourceType -ResourceGroupName $resourceGroupName -Force

노드 형식에 대한 데이터를 제거합니다.

PowerShell을 사용하여 클러스터에 연결하고 다음 단계를 실행합니다.
```
foreach($node in $nodes)
{
  if ($node.NodeType -eq $nodeType)
  {
    $node.NodeName

    Remove-ServiceFabricNodeState -NodeName $node.NodeName -Force
  }
}
```
클러스터에서 모든 노드가 제거될 때까지 기다립니다. 노드가 SFX에 표시되어서는 안 됩니다.
Service Fabric 섹션에서 노드 형식을 제거합니다.
- 배포에 사용되는 Azure Resource Manager 템플릿을 찾습니다.
- Service Fabric 섹션에서 노드 형식과 관련된 섹션을 찾습니다.
- 노드 형식에 해당하는 섹션을 제거합니다.
- 실버 이상의 내구성이 있는 클러스터에서만 템플릿의 클러스터 리소스를 업데이트하고 아래 지정된 대로 클러스터 리소스 properties 아래에 applicationDeltaHealthPolicies를 추가하여 fabric:/System 애플리케이션 상태를 무시하도록 상태 정책을 구성합니다. 아래 정책은 기존 오류는 무시하지만 새 상태 오류는 허용하지 않습니다.
```
"upgradeDescription":  
{ 
 "forceRestart": false, 
 "upgradeReplicaSetCheckTimeout": "10675199.02:48:05.4775807", 
 "healthCheckWaitDuration": "00:05:00", 
 "healthCheckStableDuration": "00:05:00", 
 "healthCheckRetryTimeout": "00:45:00", 
 "upgradeTimeout": "12:00:00", 
 "upgradeDomainTimeout": "02:00:00", 
 "healthPolicy": { 
   "maxPercentUnhealthyNodes": 100, 
   "maxPercentUnhealthyApplications": 100 
 }, 
 "deltaHealthPolicy":  
 { 
   "maxPercentDeltaUnhealthyNodes": 0, 
   "maxPercentUpgradeDomainDeltaUnhealthyNodes": 0, 
   "maxPercentDeltaUnhealthyApplications": 0, 
   "applicationDeltaHealthPolicies":  
   { 
       "fabric:/System":  
       { 
           "defaultServiceTypeDeltaHealthPolicy":  
           { 
                   "maxPercentDeltaUnhealthyServices": 0 
           } 
       } 
   } 
 } 
},
```
- 수정된 Azure Resource Manager 템플릿을 배포합니다. ** 이 단계는 시간이 오래 걸립니다(일반적으로 최대 2시간). 이 업그레이드는 설정이 InfrastructureService로 변경되므로 노드를 다시 시작해야 합니다. 이 경우 forceRestart는 무시됩니다. 매개 변수 upgradeReplicaSetCheckTimeout은 아직 안전한 상태가 아닌 경우 Service Fabric에서 파티션이 안전한 상태가 될 때까지 대기하는 최대 시간을 지정합니다. 노드의 모든 파티션에서 안전 검사가 통과되면 Service Fabric은 해당 노드에 대한 업그레이드를 진행합니다. 매개 변수 upgradeTimeout의 값은 6시간으로 줄일 수 있지만 안전이 최대화되도록 12시간을 사용해야 합니다.
그런 다음, 다음 사항을 확인합니다.
- 포털에 Service Fabric 리소스가 준비된 것으로 표시됩니다.
ARM 템플릿에서 노드 형식과 관련된 리소스에 대한 모든 참조를 제거합니다.
- 배포에 사용되는 Azure Resource Manager 템플릿을 찾습니다.
- 템플릿에서 노드 형식과 관련된 가상 머신 확장 집합 및 기타 리소스를 제거합니다.
- 변경 내용을 배포합니다.
다음 작업:
- 배포가 완료될 때까지 기다립니다.
더 이상 사용하지 않는 노드 형식과 관련된 리소스, 예제 부하 분산 장치, 공용 IP를 제거합니다.
- 해당 리소스를 제거하려면 특정 리소스 종류와 API 버전을 지정하는 6단계에서 사용한 것과 같은 PowerShell 명령을 사용할 수 있습니다.
- 실버 및 골드 내구성의 경우 제거된 nodetype에 있는 노드를 대상으로 하는 클러스터에 남아 있는 복구 작업은 다음 명령을 사용하여 완료해야 합니다.
```
   Complete-ServiceFabricRepairTask -TaskId <repair task name>
```

참고 항목

노드 형식 간에 동일한 부하 분산 장치 및 IP가 다시 사용된 경우 이 단계는 선택 사항입니다.

다음 단계

클러스터 내구성 특징에 대해 자세히 알아봅니다.
노드 유형과 Virtual Machine Scale Sets에 대해 자세히 알아봅니다.
Service Fabric 클러스터 크기 조정에 대해 자세히 알아봅니다.

Service Fabric 노드 형식을 제거하는 방법

내구성 특징

Bronze 내구성에 대한 자세한 정보

노드 형식 제거

다음 단계

추가 리소스