Service Fabric マネージド クラスターのアップグレードの管理

Azure Service Fabric クラスターはお客様が所有するリソースですが、一部は Microsoft によって管理されています。 ここでは、Microsoft が Azure Service Fabric マネージド クラスター ランタイムを更新するタイミングとその方法を管理する方法について説明します。

アップグレード モードの設定

Azure Service Fabric マネージド クラスターは、Microsoft がウェーブ デプロイ戦略を使用してリリースしているため、自動 Service Fabric アップグレードを受け取るように既定で設定されます。 また、手動モードのアップグレードも設定でき、その場合、現在サポートされているバージョンの一覧から選択します。 これらの設定は、Azure portal の "ファブリックのアップグレード" コントロール、またはクラスター デプロイ テンプレートの ClusterUpgradeMode 設定を使用して構成できます。

Wave デプロイによる自動アップグレード

ウェーブ デプロイでは、テスト、ステージ、および運用のクラスターを順番にアップグレードするためのパイプラインを作成でき、それぞれが運用クラスターのアップデート前に次期の Service Fabric のバージョンを検証するための組み込みの 'ベイク時間' で区切られています。

自動アップグレードでウェーブ デプロイを選択するには、最初に、クラスターに割り当てるウェーブを決定します。

• ウェーブ 0 (Wave0): クラスターは、新しい Service Fabric ビルドがリリースされるとすぐに更新されます。
• ウェーブ 1 (Wave1): クラスターは、ウェーブ 0 の後に更新され、ベイク時間が許可されます。 ウェーブ 1 は、ウェーブ 0 から少なくとも 7 日後に発生します。
• ウェーブ 2 (Wave2): クラスターは最後に更新され、さらに長いベイク時間が許可されます。 ウェーブ 2 は、ウェーブ 0 から少なくとも 14 日後に発生します。

クラスターのウェーブを設定する

Azure portal の "ファブリックのアップグレード" コントロール、またはクラスター デプロイ テンプレートの ClusterUpgradeMode 設定を使用して、使用可能ないずれかのウェーブにクラスターを設定できます。

Azure portal

Azure portal を使用して、新しい Service Fabric クラスターを作成するとき、使用可能な自動ウェーブのいずれかを選択します。

既存のクラスター リソースの [ファブリックのアップグレード] セクションから、使用可能な自動ウェーブを切り替えることもできます。

Resource Manager テンプレート

Resource Manager テンプレートを使用してクラスター アップグレード モードを変更するには、Microsoft.ServiceFabric/clusters リソース定義の ClusterUpgradeMode プロパティに Automatic または Manual を指定します。 手動アップグレードを選択した場合は、も現在clusterCodeVersionサポートされているファブリック のバージョンに設定します。

手動アップグレード

{
  "apiVersion": "2021-05-01",
  "type": "Microsoft.ServiceFabric/managedClusters",
  "properties": {
    "clusterUpgradeMode": "Manual",
    "clusterCodeVersion": "8.0.514.9590"
  }
}

テンプレートが正常にデプロイされると、クラスター アップグレード モードの変更が適用されます。 クラスターが手動モードの場合、クラスターのアップグレードは自動的に開始されます。

クラスター正常性ポリシー (ノードの正常性と、クラスターで実行されている全アプリケーションの正常性の組み合わせ) は、アップグレードの実行中、遵守されます。 クラスター正常性ポリシーが満たされていない場合は、アップグレードがロールバックされます。

ロールバックが発生した場合、その原因となった問題を解決し、前述の手順に従ってもう一度アップグレードを実行する必要があります。

ウェーブ デプロイによる自動アップグレード

自動アップグレードとウェーブ デプロイを構成するには、ClusterUpgradeMode が Automatic に設定され、Resource Manager テンプレートで上記のウェーブ値のいずれかを使用して clusterUpgradeCadence プロパティが定義されていることを確認するか、そのように追加します。

{
  "apiVersion": "2021-05-01",
  "type": "Microsoft.ServiceFabric/managedClusters",
  "properties": {
    "clusterUpgradeMode": "Automatic",
    "clusterUpgradeCadence": "Wave1"
  }
}

更新されたテンプレートをデプロイすると、クラスターは、自動アップグレードのために、指定されたウェーブに登録されます。

サポートされているクラスター バージョンのクエリ

Azure REST API を使用すると、指定した場所とサブスクリプションで使用可能なすべての Service Fabric ランタイム バージョン (clusterVersions) を一覧表示できます。

サポートされているバージョンとオペレーティング システムの詳細については、Service Fabric バージョンに関するページでも確認できます。

GET https://<endpoint>/subscriptions/{{subscriptionId}}/providers/Microsoft.ServiceFabric/locations/{{location}}/managedclusterVersions?api-version=2021-05-01

"value": [
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/7.2.477.9590",
    "name": "7.2.477.9590",
    "type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
    "properties": {
      "supportExpiryUtc": "2021-11-30T00:00:00",
      "osType": "Windows",
      "clusterCodeVersion": "7.2.477.9590"
    }
  },
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/8.0.514.9590",
    "name": "8.0.514.9590",
    "type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
    "properties": {
      "supportExpiryUtc": "9999-12-31T23:59:59.9999999",
      "osType": "Windows",
      "clusterCodeVersion": "8.0.514.9590"
    }
  }
]

出力の supportExpiryUtc は、特定のリリースの有効期限が近づいているか、期限切れになっていることを報告します。 最新リリースには有効な日付ではなく、9999-12-31T23:59:59.9999999 という値が設定されていますが、これは単に有効期限が設定されていないことを意味するものです。

次の手順

• Service Fabric マネージド クラスター構成をカスタマイズする
• アプリケーションのアップグレード