クラスターで実行される Service Fabric のバージョンをアップグレードする
最新のシステムでは、アップグレードできることが製品の長期的な成功の鍵となります。 Azure Service Fabric クラスターは、ユーザーが所有するリソースの 1 つです。 この記事では、スタンドアロン クラスター上で実行されている Service Fabric のバージョンをアップグレードする方法について説明します。
Note
クラスターで Service Fabric のサポートされているバージョンが常に実行されるようにする必要があります。 Microsoft が Service Fabric の新しいバージョンのリリースを発表すると、前のバージョンのサポート期間の終了が発表日から最短で 60 日後に設定されます。 新しいリリースは、Service Fabric チーム ブログで発表されます。 その時点で新しいリリースを選択できるようになります。
各 Service Fabric ノードが別個の物理または仮想マシンに割り当てられる、運用スタイルのノード構成を使用している場合にのみ、クラスターを新しいバージョンにアップグレードできます。 1 台の物理マシンまたは仮想マシンに複数の Service Fabric ノードが存在する開発クラスターがある場合、新しいバージョンでクラスターを再構築する必要があります。
2 つの異なるワークフローで、Service Fabric の最新バージョンまたはサポートされているバージョンにクラスターをアップグレードできます。 1 つは、最新バージョンを自動的にダウンロードするための接続を使用できるクラスター向けのワークフローです。 もう 1 つは、Service Fabric の最新バージョンをダウンロードするための接続を使用できないクラスター向けのワークフローです。
クラスターの Service Fabric バージョンの自動アップグレードを有効にする
Microsoft が新しいバージョンをリリースしたときに、クラスターが Service Fabric の更新プログラムをダウンロードするように設定するには、fabricClusterAutoupgradeEnabled クラスター構成を true に設定します。 クラスターに適用する Service Fabric のサポートされているバージョンを手動で選択するには、fabricClusterAutoupgradeEnabled クラスター構成を false に設定します。
最新のコードと構成をダウンロードするための接続を使用できるクラスターをアップグレードする
クラスター ノードがインターネットを通じて Microsoft ダウンロード センターに接続できる場合、次の手順でクラスターをサポートされているバージョンにアップグレードします。
Microsoft ダウンロード センターに接続できるクラスターについては、マイクロソフトが Service Fabric の新しいバージョンが利用可能であるかどうかを定期的に確認します。
Service Fabric の新しいバージョンが利用可能になると、パッケージがローカルのクラスターにダウンロードされ、アップグレードの準備が行われます。 さらに、この新しいバージョンの情報をお客様に伝えるために、クラスターの正常性に関する次のような警告が表示されます。
「現在のクラスター バージョン [バージョン番号] のサポートは [日付] に終了します。」
クラスターで最新バージョンが実行されるようになると、この警告は表示されなくなります。
クラスターの正常性に関する警告が表示されたら、クラスターをアップグレードします。
クラスターにノードとして列挙されているすべてのマシンに管理者アクセスできるマシンからクラスターに接続します。 このスクリプトが実行されるマシンがクラスターに属している必要はありません。
###### connect to the secure cluster using certs $ClusterName= "mysecurecluster.something.com:19000" $CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7FG2D630F8F3" Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 ` -X509Credential ` -ServerCertThumbprint $CertThumbprint ` -FindType FindByThumbprint ` -FindValue $CertThumbprint ` -StoreLocation CurrentUser ` -StoreName Myアップグレード可能な Service Fabric のバージョンの一覧を取得します。
###### Get the list of available Service Fabric versions Get-ServiceFabricRegisteredClusterCodeVersion次のような出力が表示されます。
Start-ServiceFabricClusterUpgrade Windows PowerShell コマンドを使用して、利用可能なバージョンへのクラスターのアップグレードを開始します。
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback ###### Here is a filled-out example Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollbackアップグレードの進捗状況を監視するには、Service Fabric Explorer を使用するか、次の PowerShell コマンドを実行します。
Get-ServiceFabricClusterUpgradeクラスター正常性ポリシーが満たされていない場合は、アップグレードがロールバックされます。 Start-ServiceFabricClusterUpgrade コマンドにカスタム正常性ポリシーを指定する方法については、「Start-ServiceFabricClusterUpgrade」をご覧ください。
ロールバックの原因となった問題を解決したら、前述の手順に従って、もう一度アップグレードを開始します。
最新のコードと構成をダウンロードするための接続を使用できないクラスターをアップグレードする
クラスター ノードがインターネットを通じて Microsoft ダウンロード センターに接続できない場合、次の手順でクラスターをサポートされているバージョンにアップグレードします。
Note
インターネットに接続されていないクラスターを実行している場合、新しいリリースの情報は Service Fabric チーム ブログで確認する必要があります。 新しいリリースについて通知する、クラスターの正常性に関する警告は表示されません。
自動プロビジョニングと手動プロビジョニングの比較
最新バージョンのコードの自動ダウンロードおよび自動登録を有効にするには、Service Fabric 更新サービスを設定します。 手順については、スタンドアロン パッケージ内の Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt を参照してください。
手動プロセスの場合は、次の手順に従ってください。
構成のアップグレードを開始する前に、クラスター構成を変更して次のプロパティを false に設定します。
"fabricClusterAutoupgradeEnabled": false,
使用方法について詳しくは、Start-ServiceFabricClusterConfigurationUpgrade PowerShell コマンドに関するページをご覧ください。 構成のアップグレードを開始する前に、JSON の "clusterConfigurationVersion" を必ず更新してください。
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
クラスターのアップグレード ワークフロー
クラスター内のいずれかのノードから Get-ServiceFabricClusterUpgrade を実行し、TargetCodeVersion を書き留めます。
インターネットに接続されているコンピューターから次のスクリプトを実行して、現在のバージョンとアップグレードの互換性があるすべてのバージョンを一覧表示し、関連付けられたダウンロード リンクから対応するパッケージをダウンロードします。
###### Get list of all upgrade compatible packages Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1>クラスターにノードとして列挙されているすべてのマシンに管理者アクセスできるマシンからクラスターに接続します。 このスクリプトが実行されるマシンがクラスターに属している必要はありません。
###### Get the list of available Service Fabric versions Copy-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file including the path to it> -ImageStoreConnectionString "fabric:ImageStore" ###### Here is a filled-out example Copy-ServiceFabricClusterPackage -Code -CodePackagePath .\MicrosoftAzureServiceFabric.5.3.301.9590.cab -ImageStoreConnectionString "fabric:ImageStore"ダウンロードしたパッケージをクラスター イメージ ストアにコピーします。
コピーしたパッケージを登録します。
###### Get the list of available Service Fabric versions Register-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file> ###### Here is a filled-out example Register-ServiceFabricClusterPackage -Code -CodePackagePath MicrosoftAzureServiceFabric.5.3.301.9590.cab利用可能なバージョンへのクラスターのアップグレードを開始します。
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback ###### Here is a filled-out example Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction RollbackService Fabric Explorer を使用するか、次の PowerShell コマンドを実行することで、アップグレードの進行状況を監視できます。
Get-ServiceFabricClusterUpgradeクラスター正常性ポリシーが満たされていない場合は、アップグレードがロールバックされます。 Start-ServiceFabricClusterUpgrade コマンドにカスタム正常性ポリシーを指定する方法については、「Start-ServiceFabricClusterUpgrade」をご覧ください。
ロールバックの原因となった問題を解決したら、前述の手順に従って、もう一度アップグレードを開始します。