Visual Studio での Service Fabric アプリケーションのアップグレードの構成

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

Visual Studio Service Fabric ツールは、ローカルまたはリモートクラスターへの発行のアップグレードサポートを提供します。テストやデバッグ中にアプリケーションを置き換えるのではなく、アプリケーションを新しいバージョンにアップグレードしたくなるシナリオが 3 つあります。

1 つは、アップグレード中にアプリケーションデータが失われないことです。
もう 1 つは、複数のアップグレードドメインにわたって十分な数のサービスインスタンスが存在すれば、アップグレード中にサービスの中断が発生しないので、高可用性が実現されることです。
アプリケーションのアップグレード中に、アプリケーションに対してテストを実行できます。

アップグレードに必要なパラメーター

標準とアップグレードの 2 種類のデプロイメントから選択できます。標準デプロイメントではクラスター上の以前のデプロイメント情報とデータが消去され、アップグレードデプロイメントではこれらが保持されます。 Visual Studio で Service Fabric アプリケーションをアップグレードするときには、アプリケーションアップグレードパラメーターと正常性チェックポリシーを提供する必要があります。アプリケーションアップグレードパラメーターによってアップグレードが制御され、正常性チェックポリシーによってアップグレードが成功したかどうかが判断されます。詳細については、「アプリケーションアップグレードのパラメーター」を参照してください。

Monitored、UnmonitoredAuto、UnmonitoredManual の 3 種類のアップグレードモードがあります。

Monitored アップグレードでは、アップグレードとアプリケーションの正常性チェックが自動化されます。
UnmonitoredAuto アップグレードでは、アップグレードは自動化されますが、アプリケーションの正常性チェックは省略されます。
UnmonitoredManual アップグレードを実行する場合は、各アップグレードドメインを手動でアップグレードする必要があります。

各アップグレードモードには、それぞれ異なるパラメーターセットが必要です。使用できるアップグレードオプションの詳細については、「アプリケーションアップグレードのパラメーター」を参照してください。

Visual Studio での Service Fabric アプリケーションのアップグレード

Visual Studio Service Fabric ツールを使用して Service Fabric アプリケーションをアップグレードする場合、 [アプリケーションのアップグレード] チェックボックスをオンにして、発行プロセスが標準デプロイメントではなくアップグレードデプロイメントであることを指定できます。

アップグレードパラメーターを構成するには

チェックボックスの横の [設定] ボタンをクリックします。 [アップグレードパラメーターの編集] ダイアログボックスが表示されます。 [アップグレードパラメーターの編集] ダイアログボックスでは、Monitored、UnmonitoredAuto、UnmonitoredManual の各アップグレードモードをサポートしています。
使用するアップグレードモードを選択し、パラメーターグリッドに値を入力します。

各パラメーターには既定値があります。オプションパラメーターの DefaultServiceTypeHealthPolicy は、ハッシュテーブルの入力を受け取ります。 DefaultServiceTypeHealthPolicyのハッシュテーブルの入力形式の例を次に示します。
```
@{ ConsiderWarningAsError = "false"; MaxPercentUnhealthyDeployedApplications = 0; MaxPercentUnhealthyServices = 0; MaxPercentUnhealthyPartitionsPerService = 0; MaxPercentUnhealthyReplicasPerPartition = 0 }
```
ServiceTypeHealthPolicyMap は、次の形式のハッシュテーブルの入力を受け取るもう 1 つのオプションパラメーターです。
```
@ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}
```
実際の例を次に示します。
```
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
```
UnmonitoredManual アップグレードモードを選択した場合は、PowerShell コンソールを手動で起動してアップグレードプロセスを続行し、プロセスを完了する必要があります。手動アップグレードのしくみについては、「 Service Fabric アプリケーションのアップグレード: 高度なトピック」を参照してください。

PowerShell を使用したアプリケーションのアップグレード

PowerShell コマンドレットを使用して、Service Fabric アプリケーションをアップグレードできます。詳細については、「Service Fabric アプリケーションのアップグレードチュートリアル」および「Start-ServiceFabricApplicationUpgrade」を参照してください。

アプリケーションマニフェストファイルでの正常性チェックポリシーの指定

Service Fabric アプリケーションの各サービスでは、既定値をオーバーライドした独自の正常性ポリシーパラメーターを使用できます。これらのパラメーター値は、アプリケーションマニフェストファイルで指定できます。

次の例は、アプリケーションマニフェストで、サービスごとに独自の正常性チェックポリシーを適用する方法を示しています。

<Policies>
    <HealthPolicy ConsiderWarningAsError="false" MaxPercentUnhealthyDeployedApplications="20">
        <DefaultServiceTypeHealthPolicy MaxPercentUnhealthyServices="20"               
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />
        <ServiceTypeHealthPolicy ServiceTypeName="ServiceTypeName1"
                MaxPercentUnhealthyServices="20"
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />      
    </HealthPolicy>
</Policies>

次の手順

アプリケーションのアップグレードの詳細については、Visual Studio を使用したアプリケーションのアップグレードに関するページを参照してください。