Service Fabric ノードタイプを削除する方法

[アーティクル]
10/15/2024

この記事では、クラスターから既存のノードタイプを削除することで、Azure Service Fabric クラスターをスケーリングする方法について説明します。 Service Fabric クラスターは、ネットワークで接続された一連の仮想マシンまたは物理マシンで、マイクロサービスがデプロイおよび管理されます。クラスターに属しているコンピューターまたは VM を "ノード" と呼びます。仮想マシンスケールセットは、セットとして仮想マシンのコレクションをデプロイおよび管理するために使用する Azure コンピューティングリソースです。 Azure クラスターで定義されているすべてのノードの種類は、異なるスケールセットとしてセットアップされます。その後は、ノードの種類ごとに個別に管理できます。 Service Fabric クラスターを作成した後は、ノードタイプ (仮想マシンスケールセット) とそのノードすべてを削除することで、クラスターを水平方向にスケーリングできます。クラスターは、クラスターでワークロードを実行中であっても、いつでもスケーリングできます。クラスターをスケーリングすると、アプリケーションも自動的にスケーリングされます。

警告

運用環境のクラスターからノードタイプを削除するためにこの方法を使用することは、頻繁に使用する場合は推奨されません。ノードタイプの背後にある仮想マシンスケールセットリソースが削除されるため、危険なコマンドです。

耐久性の特性

Remove-AzServiceFabricNodeType の使用時には、速度よりも安全性が優先されます。次に示す理由から、ノードタイプはシルバーまたはゴールドの耐久性レベルにする必要があります。

ブロンズでは、状態情報の保存に関する保証が一切提供されしません。
シルバーとゴールドの耐久性では、スケールセットに対するすべての変更がトラップされます。
ゴールドでは、スケールセットの下にある Azure の更新に対する制御も与えられます。

Service Fabric では、データが失われないように、基になっている変更や更新が "調整" されます。ただし、ブロンズの持続性を持つノードタイプを削除すると、状態情報が失われる可能性があります。プライマリノードタイプを削除しようとしていて、アプリケーションがステートレスである場合は、ブロンズで問題ありません。運用環境でステートフルワークロードを実行する場合は、最小構成をシルバーにする必要があります。同様に、運用環境であれば、プライマリノードタイプは常にシルバーまたはゴールドにする必要があります。

ブロンズの耐久性に関する詳細

ブロンズであるノードタイプを削除すると、そのノードタイプに含まれるすべてのノードが直ちに停止します。 Service Fabric では、ブロンズノードのスケールセットの更新は一切トラップされないため、すべての VM が直ちに停止します。それらのノードに何かステートフルなものがあった場合、データは失われます。ステートレスであった場合でも、Service Fabric 内にあるノードはすべてリングに参加しているため、近隣全体が失われる可能性があり、そのために、クラスター自体が不安定になることがあります。

ノードタイプを削除する

処理を開始する前に、次の前提条件に対処してください。
- クラスターが正常である。
- ノードタイプが削除された後も依然として十分な容量 (必要なレプリカ数を配置するためのノードの数など) がある。
ノードタイプを使用するための配置制約があるすべてのサービスを、そのノードタイプから移動します。
- ノードタイプを参照しなくなるようにアプリケーション/サービスマニフェストを変更します。
- 変更内容をデプロイします。
その後、次のことを検証します。
- 上記で変更したすべてのサービスが、そのノードタイプに属しているノードで実行されなくなっている。
- すべてのサービスが正常である。
node-type を非プライマリとしてマークを解除します (非プライマリノードタイプの場合はスキップします)
- デプロイに使用する 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。
- これらのリソースを削除するには、手順 6 と同じ PowerShell コマンドを使用し、特定のリソースの種類と API バージョンを指定します。
- シルバーとゴールドの持続性では、クラスターに残っている修復タスクが、削除された nodetype に存在していたノードのいずれかをターゲットにしている場合、次のコマンドを使用して完了する必要があります。
```
   Complete-ServiceFabricRepairTask -TaskId <repair task name>
```

Note

同じロードバランサーと IP がノードタイプ間で再使用される場合、この手順は任意です。

次のステップ

クラスターの耐久性の特性についてさらに学習します。
ノードタイプと Virtual Machine Scale Sets についてさらに学習します。
Service Fabric クラスターのスケーリングについてさらに学習します。

次の方法で共有

Service Fabric ノードタイプを削除する方法

耐久性の特性

ブロンズの耐久性に関する詳細

ノードタイプを削除する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Service Fabric ノード タイプを削除する方法

耐久性の特性

ブロンズの耐久性に関する詳細

ノード タイプを削除する

次のステップ

フィードバック

その他のリソース

Service Fabric ノードタイプを削除する方法

ノードタイプを削除する