パッチオーケストレーションアプリケーションの使用

[アーティクル]
06/01/2023

重要

2019 年 4 月 30 日の時点で、パッチオーケストレーションアプリケーションバージョン 1.2.* はサポートされなくなりました。必ず最新バージョンにアップグレードしてください。

パッチオーケストレーションアプリケーション (POA) は、Azure Service Fabric Repair Manager サービスのラッパーであり、Azure 以外でホストされるクラスターに対して構成ベースの OS 修正プログラムスケジュールを有効にします。 POA は、Azure 以外でホストされるクラスターには必要ありませんが、更新ドメインによる修正プログラムのインストールのスケジュール設定は、ダウンタイムを発生させることなく Service Fabric クラスターホストに修正プログラムを適用するために必要です。

POA は、ダウンタイムを発生させることなく、Service Fabric クラスターでのオペレーティングシステムへの修正プログラムの適用を自動化する Service Fabric アプリケーションです。

POA では次の機能が提供されます。

オペレーティングシステムの更新プログラムの自動インストール: オペレーティングシステムの更新プログラムが自動的にダウンロードされ、インストールされます。クラスターノードは、クラスターのダウンタイムを発生させることなく、必要に応じて再起動されます。
クラスター対応のパッチ適用と正常性の統合: POA が更新プログラムを適用している間に、クラスターノードの正常性を監視します。クラスターノードの場合、一度に 1 つのノード、または一度に 1 つの更新ドメインが更新されます。修正プログラムの適用によってクラスターの正常性が低下した場合、問題の悪化を防ぐために修正プログラムの適用が停止されます。

POA の内部詳細

POA は、次のサブコンポーネントで構成されます。

コーディネーターサービス:このサービスの役割は次のとおりです。
- クラスター全体における Windows Update ジョブを調整する。
- 完了した Windows Update 操作の結果を保存する。
ノードエージェントサービス:このステートレスサービスは、すべての Service Fabric クラスターノードで実行されます。このサービスは次の役割を担います。
- ノードエージェント NTService をブートストラップする。
- ノードエージェント NTService の監視。
ノードエージェント NTService:この Windows NT サービスは、上位の特権 (SYSTEM) で実行されます。一方、ノードエージェントサービスとコーディネーターサービスは、下位の特権 (NETWORK SERVICE) で実行されます。このサービスは、全クラスターノードで次の Windows Update ジョブを実行する役割を担います。
- ノードでの Windows の自動更新を無効にする。
- ユーザーが指定したポリシーに従って、Windows 更新プログラムをダウンロードしてインストールする。
- Windows 更新プログラムのインストール後にマシンを再起動する。
- Windows Update の結果をコーディネーターサービスにアップロードする。
- 再試行回数の上限に達した後、操作が失敗した場合に正常性レポートを生成する。

Note

POA では Service Fabric Repair Manager サービスを使用して、ノードを無効または有効にし、正常性チェックを実行します。 POA によって作成される修復タスクでは、各ノードの Windows Update の進行状況を追跡します。

前提条件

Note

最低限必要な .NET Framework バージョンは 4.6 です。

Repair Manager サービスを有効にする (まだ実行されていない場合)

POA を使用するには、クラスターで Repair Manager サービスを有効にする必要があります。

Azure クラスター

シルバー持続性層の Azure クラスターでは、Repair Manager サービスが既定で有効になっています。ゴールド持続性層の Azure クラスターでは、クラスターが作成された時期に応じて、Repair Manager サービスが有効になっている場合となっていない場合があります。ブロンズ持続性層の Azure クラスターでは、既定では Repair Manager サービスは有効になっていません。サービスが既に有効になっている場合、Service Fabric Explorer のシステムサービスセクションでそれが実行されていることを確認できます。

Azure ポータル

クラスターを設定するときに、Azure portal から Repair Manager を有効にすることができます。クラスターの構成時に、 [アドオン機能] の下にある [Repair Manager を含める] オプションを選択します。

Azure portal からの Repair Manager の有効化の画像

Azure Resource Manager デプロイモデル

Azure Resource Manager デプロイモデルを使用して、新規および既存の Service Fabric クラスターで Repair Manager サービスを有効にすることもできます。デプロイするクラスター用テンプレートを用意します。サンプルテンプレートを使用することも、カスタムの Azure Resource Manager デプロイモデルテンプレートを作成することもできます。

Azure Resource Manager デプロイモデルテンプレートを使用して Repair Manager サービスを有効にするには、次のようにします。

Microsoft.ServiceFabric/clusters リソースに対して、apiVersion が 2017-07-01-preview に設定されていることを確認します。異なる場合は、apiVersion を 2017-07-01.txt-preview 以降に更新する必要があります。
```
{
    "apiVersion": "2017-07-01-preview",
    "type": "Microsoft.ServiceFabric/clusters",
    "name": "[parameters('clusterName')]",
    "location": "[parameters('clusterLocation')]",
    ...
}
```
fabricSettings セクションの後に次の addonFeatures セクションを追加して、Repair Manager サービスを有効にします。
```
"fabricSettings": [
    ...      
],
"addonFeatures": [
    "RepairManager"
],
```
これらの変更でクラスターテンプレートを更新した後、変更を適用して更新を完了させます。これで、Repair Manager サービスがクラスターで実行されていることがわかります。これは、Service Fabric Explorer のシステムサービスセクションでは fabric:/System/RepairManagerService と呼ばれます。

スタンドアロンオンプレミスクラスター

新規または既存の Service Fabric クラスターで Repair Manager サービスを有効にする場合は、スタンドアロン Windows クラスターの構成設定を使用できます。

Repair Manager サービスを有効にするには、次のようにします。

次のように、一般的なクラスター構成の apiVersion が 04-2017 以降に設定されていることを確認します。
```
{
    "name": "SampleCluster",
    "clusterConfigurationVersion": "1.0.0",
    "apiVersion": "04-2017",
    ...
}
```
次のように、fabricSettings セクションの後に以下の addonFeatures セクションを追加して、Repair Manager サービスを有効にします。
```
"fabricSettings": [
    ...      
],
"addonFeatures": [
    "RepairManager"
],
```
更新されたクラスターマニフェストを使用して、新しいクラスターを作成するか、クラスター構成をアップグレードして、これらの変更でクラスターマニフェストを更新します。

更新されたクラスターマニフェストを使用してクラスターが実行された後、クラスターで実行されている Repair Manager サービスを確認できます。これは fabric:/System/RepairManagerService と呼ばれ、Service Fabric Explorer のシステムサービスセクションにあります。

すべてのノードの Windows 更新プログラムを構成する

Windows の自動更新では、複数のクラスターノードが同時に再起動される可能性があるため、可用性が失われる場合があります。 POA では、既定で、各クラスターノードでの Windows の自動更新の無効化が試行されます。ただし、管理者またはグループポリシーによって設定が管理されている場合は、"ダウンロードする前に通知する" ように Windows Update ポリシーを明示的に設定することをお勧めします。

アプリケーションパッケージをダウンロードする

アプリケーションパッケージをダウンロードするには、GitHub のパッチオーケストレーションアプリケーションのリリースページに移動します。

POA の動作を構成する

ニーズに合わせて POA の動作を構成することができます。アプリケーションを作成または更新するときにアプリケーションパラメーターを渡して、既定値をオーバーライドします。 Start-ServiceFabricApplicationUpgrade または New-ServiceFabricApplication コマンドレットに ApplicationParameter を指定することで、アプリケーションパラメーターを指定できます。

パラメーター	Type	詳細
MaxResultsToCache	Long	キャッシュする必要がある Windows Update の結果の最大数。既定値は 3000 で、以下が前提となります。 - ノード数が 20 である。 - 月あたりのノードの更新数が 5 である。 - 操作あたりの結果の数を 10 にできる。 - 過去 3 か月の結果を格納する必要がある。
TaskApprovalPolicy	列挙型 { NodeWise, UpgradeDomainWise }	TaskApprovalPolicy は、コーディネーターサービスが、Service Fabric クラスターノードに Windows Update をインストールする際に使用するポリシーを示しています。使用できる値は、次のとおりです。 NodeWise:Windows 更新プログラムは、一度に 1 つのノードにインストールされます。 UpgradeDomainWise:Windows 更新プログラムは、一度に 1 つの更新ドメインにインストールされます (最大で、更新ドメインに属するすべてのノードに Windows 更新プログラムを適用できます)。 FAQ に関するセクションを参照してください。これは、クラスターに最適なポリシーを決定するのに役立ちます。
LogsDiskQuotaInMB	Long (既定値:1024)	パッチオーケストレーションアプリのログの最大サイズ (MB 単位)。このサイズまで、ノードでローカルに保存することができます。
WUQuery	string (既定値:IsInstalled=0)	Windows 更新プログラムを取得するためのクエリ。詳細については、WuQuery に関するページをご覧ください。
InstallWindowsOSOnlyUpdates	Boolean (既定値: false)	このフラグを使用して、どの更新プログラムをダウンロードしてインストールするかを制御します。次の値が許可されています true - Windows オペレーティングシステムの更新プログラムのみをインストールします。 false - マシンで使用可能なすべての更新プログラムをインストールします。
WUOperationTimeOutInMinutes	int (既定値:90)	Windows Update 操作 (検索、ダウンロード、インストール) のタイムアウトを指定します。指定したタイムアウト時間内に操作が完了しなかった場合は、操作が中止されます。
WURescheduleCount	int (既定値:5)	操作が繰り返し失敗する場合に、サービスで Windows 更新プログラムの再スケジュールを行う最大回数。
WURescheduleTimeInMinutes	int (既定値:30)	問題が解決しない場合に、サービスで Windows 更新プログラムの再スケジュールを行う間隔。
WUFrequency	コンマ区切りの文字列 (既定値:Weekly, Wednesday, 7:00:00)	Windows 更新プログラムをインストールする頻度。形式と指定できる値は次のとおりです。 - Monthly, DD, HH:MM:SS (例:Monthly, 5, 12:22:32)。 DD (日) フィールドに使用できる値は、1 から 28 の数字と last です。 - Weekly, Day, HH:MM:SS (例:Weekly, Tuesday, 12:22:32) - Daily, HH:MM:SS (例:Daily, 12:22:32) - MonthlyByWeekAndDay, Week, Day, HH:MM:SS (例:MonthlyByWeekAndDay, 2, Friday, 21:00:00 は、毎月第 2 週の金曜日の午後 9:00 UTC を示します) - None は、Windows 更新プログラムが実行されないことを示します。時刻は UTC 形式です。
AcceptWindowsUpdateEula	Boolean (既定値: true)	このフラグを設定すると、コンピューターの所有者に代わって、アプリケーションが Windows Update の使用許諾契約に同意します。

ヒント

Windows 更新プログラムをすぐに実行する場合は、アプリケーションのデプロイ時間を基準として WUFrequency を設定します。たとえば、5 ノードテストクラスターがあり、UTC 時刻の午後 5 時頃にアプリケーションをデプロイする予定であるとします。アプリケーションのアップグレードまたはデプロイに最大 30 分かかると想定される場合、WUFrequency を Daily, 17:30:00 に設定します。

POA をデプロイする

前提条件となるすべての手順を実行してクラスターを準備します。
他の Service Fabric アプリと同様に POA をデプロイします。 PowerShell を使用してデプロイする場合は、「PowerShell を使用してアプリケーションのデプロイと削除を実行する」を参照してください。
デプロイ時にアプリケーションを構成するには、ApplicationParameter を New-ServiceFabricApplication コマンドレットに渡します。利便性のために、アプリケーションと共に Deploy.ps1 スクリプトが用意されています。このスクリプトを使用するには、次の手順に従います。
- Connect-ServiceFabricCluster を使用して Service Fabric クラスターに接続します。
- 適切な ApplicationParameter 値を指定して、Deploy.ps1 PowerShell スクリプトを実行します。

Note

スクリプトとアプリケーションフォルダー PatchOrchestrationApplication は同じディレクトリに保存してください。

POA をアップグレードする

PowerShell を使用して POA のバージョンをアップグレードするには、「PowerShell を使用した Service Fabric アプリケーションのアップグレード」の手順に従います。

POA を削除する

アプリケーションを削除するには、「PowerShell を使用してアプリケーションのデプロイと削除を実行する」の手順に従います。

参考までに、アプリケーションと共に Undeploy.ps1 スクリプトを提供しています。このスクリプトを使用するには、次の手順に従います。

Connect-ServiceFabricCluster を使用して Service Fabric クラスターに接続します。
Undeploy.ps1 PowerShell スクリプトを実行します。

Note

スクリプトとアプリケーションフォルダー PatchOrchestrationApplication は同じディレクトリに保存してください。

Windows Update の結果の確認

POA では、結果の履歴をユーザーに表示するための REST API を公開しています。結果の JSON の例を次に示します。

[
  {
    "NodeName": "_stg1vm_1",
    "WindowsUpdateOperationResults": [
      {
        "OperationResult": 0,
        "NodeName": "_stg1vm_1",
        "OperationTime": "2019-05-13T08:44:56.4836889Z",
        "OperationStartTime": "2019-05-13T08:44:33.5285601Z",
        "UpdateDetails": [
          {
            "UpdateId": "7392acaf-6a85-427c-8a8d-058c25beb0d6",
            "Title": "Cumulative Security Update for Internet Explorer 11 for Windows Server 2012 R2 (KB3185319)",
            "Description": "A security issue has been identified in a Microsoft software product that could affect your system. You can help protect your system by installing this update from Microsoft. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article. After you install this update, you may have to restart your system.",
            "ResultCode": 0,
            "HResult": 0
          }
        ],
        "OperationType": 1,
        "WindowsUpdateQuery": "IsInstalled=0",
        "WindowsUpdateFrequency": "Daily,10:00:00",
        "RebootRequired": false
      }
    ]
  },
  ...
]

JSON のフィールドについては、次の表で説明します。

フィールド	値	詳細
OperationResult	0 - 成功 1 - 成功 (エラーあり) 2 - 失敗 3 - 中止 4 - タイムアウトにより中止	操作全体 (通常は 1 つまたは複数の更新プログラムのインストールを含む) の結果を示します。
ResultCode	OperationResult と同じ	このフィールドでは、個々の更新プログラムのインストール操作の結果が示されます。
OperationType	1 - インストール 0 - 検索とダウンロード	既定では、インストールが、結果に表示される唯一の OperationType です。
WindowsUpdateQuery	既定値は "IsInstalled=0"	更新プログラムの検索に使用された Windows Update クエリ。詳細については、WuQuery に関するページを参照してください。
RebootRequired	true - 再起動が必要 false - 再起動は不要	更新プログラムのインストールを完了するのに再起動が必要だったかどうかを示します。
OperationStartTime	DateTime	操作 (ダウンロード/インストール) が開始した時刻を示します。
OperationTime	DateTime	操作 (ダウンロード/インストール) が完了した時刻を示します。
HResult	0 - 成功その他 - 失敗	updateID "7392acaf-6a85-427c-8a8d-058c25beb0d6" で Windows 更新プログラムの失敗の理由を示します。

更新がまだスケジュールされていない場合、結果の JSON は空になります。

Windows Update の結果を照会するには、クラスターにサインインします。コーディネーターサービスのプライマリアドレス用のレプリカ IP アドレスを見つけて、ブラウザーから http://<REPLICA-IP>:<ApplicationPort>/PatchOrchestrationApplication/v1/GetWindowsUpdateResults という URL を開きます。

コーディネーターサービスの REST エンドポイントには動的ポートがあります。正確な URL を確認するには、Service Fabric Explorer を参照します。たとえば、http://10.0.0.7:20000/PatchOrchestrationApplication/v1/GetWindowsUpdateResults で結果を入手できます。

REST エンドポイントの画像

クラスターでリバースプロキシが有効になっている場合は、クラスターの外部からも URL にアクセスできます。

ヒットする必要があるエンドポイントは、http://<SERVERURL>:<REVERSEPROXYPORT>/PatchOrchestrationApplication/CoordinatorService/v1/GetWindowsUpdateResults です。

クラスターでリバースプロキシを有効にするには、「Azure Service Fabric のリバースプロキシ」の手順に従います。

警告

リバースプロキシが構成された後、クラスター内の、HTTP エンドポイントを公開するすべてのマイクロサービスが、クラスターの外部からアドレス指定可能になります。

診断および正常性イベント

このセクションでは Service Fabric クラスターの POA を使用して、修正プログラムの問題をデバッグまたは診断する方法について説明します。

Note

以下に示されている自己診断の機能向上の多くを得るには、POA バージョン 1.4.0 以降がインストールされている必要があります。

ノードエージェント NTService では、ノードに更新プログラムをインストールするために修復タスクを作成します。その後、各タスクは、タスク承認ポリシーに従って、コーディネーターサービスによって準備されます。最後に、準備されたタスクは Repair Manager によって承認されますが、クラスターが異常な状態にある場合は、どのタスクも承認されません。

ノードでの更新プログラムの進行について理解できるように、段階的に見ていきましょう。

すべてのノード上で実行されている NodeAgentNTService では、スケジュールされた時刻に使用可能な Windows 更新プログラムを検索します。更新プログラムが使用可能な場合、それらをノード上にダウンロードします。
更新プログラムがダウンロードされた後、ノードエージェント NTService では POS___<unique_id> の名前で、ノードの対応する修復タスクを作成します。これらの修復タスクは、Get-ServiceFabricRepairTask コマンドレットを使用するか、ノードの詳細セクションで SFX を使用して表示できます。修復タスクが作成された後、すぐに要求済み状態に移ります。
コーディネーターサービスでは、定期的に要求済み状態の修復タスクを検索し、TaskApprovalPolicy に基づいてそれらを準備中状態に更新します。 TaskApprovalPolicy が NodeWise になるように構成されている場合、現在、準備中、承認済み、実行中、または復元中の状態になっている他の修復タスクがない場合にのみ、ノードに対応した修復タスクが準備されます。

同様に、UpgradeWise TaskApprovalPolicy の場合は、同じ更新ドメインに属しているノードに対してのみ、上記の状態でタスクが存在します。修復タスクが準備中状態に移された後、対応する Service Fabric ノードが、再起動の意図で無効になります。

POA バージョン 1.4.0 以降では、CoordinatorService の ClusterPatchingStatus プロパティを使用してイベントをポストし、修正プログラムが適用されているノードを表示します。次の画像に示すように、更新プログラムは _poanode_0 にインストールされます。
ノードが無効になった後、修復タスクは実行中状態に移されます。

Note

無効状態でスタックしているノードでは、新しい修復タスクがブロックされる可能性があり、これにより、クラスターでの修正プログラムの適用操作が停止します。

修復タスクが実行中状態になると、そのノードへの修正プログラムのインストールが開始されます。修正プログラムがインストールされた後、ノードは、修正プログラムに応じて、再起動される場合とされない場合があります。次に、修復タスクが修復中状態に移され、これにより、ノードが再び有効になります。その後、修復タスクが完了済みとマークされます。

POA バージョン 1.4.0 以降では、WUOperationStatus-<NodeName> プロパティを使用して NodeAgentService の正常性イベントを表示して、更新プログラムの状態を確認できます。下の画像で強調表示されたセクションには、ノード poanode_0 および poanode_2 での Windows 更新プログラムの状態が示されています。

PowerShell を使用して詳細を取得することもできます。これを行うには、クラスターに接続し、Get-ServiceFabricRepairTask を使用して修復タスクの状態を取り込みます。

次の例では、"POS__poanode_2_125f2969-933c-4774-85d1-ebdf85e79f15" タスクは DownloadComplete 状態にあります。これは、更新プログラムが poanode_2 ノードにダウンロードされており、タスクが実行中状態に移ったときにインストールが試みられることを意味します。

 D:\service-fabric-poa-bin\service-fabric-poa-bin\Release> $k = Get-ServiceFabricRepairTask -TaskId "POS__poanode_2_125f2969-933c-4774-85d1-ebdf85e79f15"

 D:\service-fabric-poa-bin\service-fabric-poa-bin\Release> $k.ExecutorData
 {"ExecutorSubState":2,"ExecutorTimeoutInMinutes":90,"RestartRequestedTime":"0001-01-01T00:00:00"}

問題が解決しない場合は、ご利用の仮想マシン (VM) または複数の VM にサインインし、Windows イベントログを使用して詳細を確認してください。前述の修復タスクは、次の Executor の下位状態でのみ存在できます。

ExecutorSubState	説明
None=1	ノードに実行中の操作がなかったことを意味します。状態が遷移中である可能性があります。
DownloadCompleted=2	ダウンロード操作が成功したか、一部失敗したか、失敗したかを示します。
InstallationApproved=3	ダウンロード操作が以前に完了しており、Repair Manager でインストールが承認されたことを示します。
InstallationInProgress=4	修復タスクの実行の状態に対応します。
InstallationCompleted=5	インストールが成功したか、一部成功したか、失敗したかを示します。
RestartRequested=6	修正プログラムのインストールが完了し、ノード上に保留中の再起動アクションがあることを示します。
RestartNotNeeded=7	修正プログラムのインストールの完了後に再起動が必要なかったことを示します。
RestartCompleted=8	再起動が正常に完了したことを示します。
OperationCompleted=9	Windows Update 操作が正常に完了しました。
OperationAborted=10	Windows Update 操作が中止されたことを示します。

POA バージョン 1.4.0 以降では、ノードの更新の試行が完了した場合、Windows 更新プログラムのダウンロードとインストールの次回の試行が開始されるときに通知するために、"WUOperationStatus-[NodeName]" プロパティを使用するイベントが NodeAgentService にポストされます。これは次の画像のように表示されます。

診断ログ

パッチオーケストレーションアプリケーションのログは、Service Fabric のランタイムログの一部として収集されます。

ログは、任意の診断ツールまたはパイプラインを使用してキャプチャできます。 POA では次の固定プロバイダー ID を使用して、イベントソースを介してイベントをログに記録します。

e39b723c-590c-4090-abb0-11e3e6616346
fc0028ff-bfdc-499f-80dc-ed922c52c5e9
24afa313-0d3b-4c7c-b485-1047fd964b60
05dc046c-60e9-4ef7-965e-91660adffa68

正常性レポート

また、POA では、次のシナリオでノードエージェントサービスまたはコーディネーターサービスに対して正常性レポートを発行します。

ノードエージェント NTService がダウンしている場合

ノードでノードエージェント NTService がダウンしている場合、ノードエージェントサービスに対して警告レベルの正常性レポートが生成されます。
Repair Manager サービスが有効になっていない場合

クラスターで Repair Manager サービスが見つからない場合、コーディネーターサービスに対して警告レベルの正常性レポートが生成されます。

よく寄せられる質問

Q:POA の実行中に、クラスターがエラー状態になるのはなぜですか?

A:インストールプロセス中に、POA ではノードを無効にするか再起動します。これにより、一時的にクラスターが異常な状態になる可能性があります。

アプリケーションのポリシーに応じて、修正プログラムの適用操作中にいずれか 1 つのノードがダウンするか、または更新ドメイン全体が同時にダウンすることがあります。

Windows 更新プログラムのインストールが完了するまでに、ノードは再起動後に再び有効になります。

次の例では、2 つのノードがダウンし、MaxPercentageUnhealthyNodes ポリシーに違反しているため、クラスターが一時的にエラー状態になっています。このエラーは、修正プログラムの適用操作を開始できるようになるまでの一時的なものです。

異常なクラスターの画像

問題が解決しない場合は、「トラブルシューティング」を参照してください。

Q:POA が警告状態にある場合はどうすればよいですか?

A:アプリケーションに対してポストされた正常性レポートで根本原因が示されているかどうかを確認してください。通常、警告には問題の詳細が含まれています。問題が一時的なものである場合、アプリケーションは自動的に回復することが予想されます。

Q:クラスターに異常があり、オペレーティングシステムの更新をすぐに実行する必要がある場合はどうすればよいですか?

A:クラスターに異常がある間は、POA によって更新プログラムはインストールされません。 POA ワークフローのブロックを解除するために、クラスターが正常な状態になるようにしてみてください。

Q:クラスターの "NodeWise" または "UpgradeDomainWise" として TaskApprovalPolicy を設定する必要はありますか?

A:"UpgradeDomainWise" 設定では、更新ドメインに属するすべてのノードに並列して修正プログラムを適用することで、クラスター全体の修復を高速化します。このプロセス中は、更新ドメイン全体に属するノードを使用できません (無効状態になっている)。

これに対して、"NodeWise" 設定では、一度に 1 つのノードのみに修正プログラムが適用されます。これは、クラスター全体の修正プログラムの適用に時間がかかる可能性があることを意味します。ただし、修正プログラムの適用プロセス中に利用不可 (無効状態) になるのは、最大でも 1 つのノードのみです。

修正プログラムの適用サイクル中に、ご自分のクラスターで N-1 個の更新ドメイン (N はクラスター上の更新ドメインの総数) 上での実行を許容できる場合は、ポリシーを "UpgradeDomainWise" として設定できます。それ以外の場合は、"NodeWise" に設定します。

Q:ノードに修正プログラムを適用するにはどのくらい時間がかかりますか?

A:ノードへの修正プログラムの適用には、数分 (たとえば、Windows Defender 定義の更新プログラム) から数時間 (たとえば、Windows の累積的な更新プログラム) かかることがあります。ノードに修正プログラムを適用するために必要な時間は、主に以下によって異なります。

更新プログラムのサイズ。
修正プログラムの適用期間内に適用する必要がある、更新プログラムの数。
更新プログラムのインストール、ノードの再起動 (必要な場合)、および再起動後のインストール手順の完了にかかる時間。
VM またはマシンのパフォーマンス、およびネットワークの状態。

Q:クラスター全体に修正プログラムを適用するにはどのくらい時間がかかりますか?

A:クラスター全体に修正プログラムを適用するために必要な時間は、以下によって異なります。

ノードに修正プログラムを適用するために必要な時間。
コーディネーターサービスのポリシー。既定のポリシーである "NodeWise" では、一度に 1 つのノードのみに修正プログラムが適用されます。この方法では、"UpgradeDomainWise" を使用するよりも低速になります。

次に例を示します。ノードに修正プログラムを適用するのに最大 1 時間かかる場合、5 個の更新ドメインがあり、それぞれに 4 個のノードが含まれている、20 個のノード (同じ種類のノード) のクラスターに修正プログラムを適用する場合は、以下が必要です。
- "NodeWise" の場合: 最大 20 時間。
- "UpgradeDomainWise" の場合: 最大 5 時間。
クラスターの負荷。修正プログラムの適用操作ごとに、クラスター内の他の利用可能なノードに顧客のワークロードを再配置する必要があります。修正プログラムが適用されているノードは、この間は無効化中状態になります。クラスターがピーク時の負荷に近い状態で実行されている場合、無効化プロセスには時間がかかります。そのため、このような負荷状態では、修正プログラムの適用プロセス全体が遅く見えることがあります。
修正プログラムの適用中に発生したクラスターの正常性エラー。クラスターの正常性が低下した場合、修正プログラムの適用プロセスは中断されます。この問題により、クラスター全体に修正プログラムを適用するために必要な全体的な時間が増えます。

Q:Windows Update の結果で一部の更新プログラムが REST API 経由で取得されたと表示されますが、マシンの Windows Update 履歴に表示されないのはなぜですか?

A:一部の製品の更新プログラムは、独自の更新プログラムまたは修正プログラムの履歴にのみ表示されます。たとえば、Windows Defender の更新プログラムは、Windows Server 2016 の Windows Update 履歴に表示される場合とされない場合があります。

Q:POA を使用して、自分の開発クラスター (1 ノードクラスター) に修正プログラムを適用できますか?

A:いいえ、POA を使用して 1 ノードクラスターに修正プログラムを適用することはできません。 Service Fabric システムサービスまたはその他の顧客アプリでダウンタイムが発生するため、この制限は設計によるものです。したがって、修復ジョブへの修正プログラムの適用が Repair Manager によって承認されることはありません。

Q:Linux 上のクラスターノードに修正プログラムを適用するにはどうすればよいですか?

A:Linux での更新プログラムのオーケストレーションの詳細については、「Azure 仮想マシンスケールセットによる OS イメージの自動アップグレード」を参照してください。

Q:更新サイクルにこれほど時間がかかるのはなぜですか?

A:結果の JSON を照会し、すべてのノードの更新サイクルに入ってから、OperationStartTime と OperationTime(OperationCompletionTime) を使用してすべてのノードで更新プログラムのインストールにかかる時間を確認してみることができます。

更新が行われていない大きな時間枠がある場合、クラスターはエラー状態にある可能性があるため、Repair Manager では POA の修復タスクを承認できません。任意のノードで更新プログラムのインストールに時間がかかる場合、そのノードはしばらくの間、更新されていない可能性があります。多くの更新プログラムのインストールが保留中である可能性があり、これにより、遅延が発生することがあります。

また、無効化中状態でスタックしているため、ノードへの修正プログラムの適用がブロックされている可能性があります。これは通常、ノードの無効化により、クォーラムまたはデータ損失の状況が発生する可能性があるためです。

Q:POA でノードに修正プログラムを適用するときに、そのノードを無効にする必要があるのはなぜですか?

A:POA では、ノード上で実行されているすべての Service Fabric サービスを停止または再割り当てする、再起動の意図でノードを無効にします。 POA ではこれを行って、アプリケーションで新規および古い DLL を組み合わせて使用することにならないようにします。したがって、ノードを無効にせずに修正プログラムを適用することはお勧めできません。

Q:POA を使用して更新できるノードの最大数はどれだけですか?

A:POA では、Service Fabric Repair Manager を使用して、更新のためのノードの修復タスクを作成します。ただし、一度に存在できる修復タスクは 250 個だけです。現在、POA では各ノードの修復タスクを同時に作成するため、クラスター内の 250 ノードしか更新できません。

免責事項

POA では、ユーザーに代わって、Windows Update の使用許諾契約書に同意します。必要に応じて、アプリケーションの構成でこの設定をオフにすることもできます。
POA では、使用状況とパフォーマンスを追跡するためにテレメトリを収集します。アプリケーションのテレメトリの設定は、Service Fabric ランタイムのテレメトリ設定 (既定でオン) に従います。

トラブルシューティング

このセクションでは、ノードへの修正プログラムの適用に関する問題に対して考えられるトラブルシューティングソリューションを提供します。

ノードが稼働状態に戻らない

以下の理由により、ノードが 無効中状態でスタックしている可能性があります。
- 安全性チェックが保留中になっています。この状況を改善するには、十分な数のノードが正常な状態で稼働するように対策を講じてください。
次の理由により、ノードが無効状態でスタックしている可能性があります。
- 手動で無効にされた。
- 進行中の Azure インフラストラクチャジョブによって無効にされた。
- ノードに修正プログラムを適用するために POA によって一時的に無効にされた。
次の理由により、ノードがダウン状態でスタックしている可能性があります。
- 手動でダウン状態にされた。
- 再起動されている (POA によってトリガーされる可能性がある)。
- VM またはマシンに障害があるか、ネットワーク接続に問題がある。

一部のノードで更新がスキップされた

POA では、再スケジュールポリシーに従って、Windows 更新プログラムのインストールを試行します。サービスはアプリケーションポリシーに従って、ノードを復旧し、更新をスキップします。

このような場合、ノードエージェントサービスに対して警告レベルの正常性レポートが生成されます。 Windows Update の結果には、エラーの考えられる理由も含まれます。

更新プログラムのインストール中にクラスターの正常性がエラーになる

Windows 更新プログラムの障害によって、特定のノードまたは更新ドメインでアプリケーションやクラスターの正常性が低下する場合があります。 POA では、クラスターが正常な状態に戻るまで、以降の Windows Update 操作を中断します。

管理者が介入し、Windows Update によってアプリケーションやクラスターが異常な状態になった原因を特定する必要があります。

POA のリリースノート

Note

POA バージョン 1.4.0 以降の場合、リリースノートとリリースは、GitHub のパッチオーケストレーションアプリケーションのリリースページで確認できます。

バージョン 1.1.0

公開リリース

バージョン 1.1.1

NodeAgentNTService をインストールできない NodeAgentService の SetupEntryPoint のバグを修正しました。

バージョン 1.2.0

システム再起動ワークフローに関連するバグを修正しました。
修復タスクの準備中に正常性チェックが予定どおりに実行されないために発生する RM タスク作成時のバグを修正しました。
Windows サービス POANodeSvc のスタートアップモードを auto から delayed-auto に変更しました。

バージョン 1.2.1

クラスターのスケールダウンワークフローのバグ修正。導入された POA 用のガベージコレクションロジックは、存在しないノードに属するタスクを修正します。

バージョン 1.2.2

各種のバグ修正。
バイナリが署名されるようになりました。
アプリケーションの sfpkg リンクを追加しました。

バージョン 1.3.0

InstallWindowsOSOnlyUpdates を false に設定すると、使用可能なすべての更新プログラムがインストールされるようになりました。
自動更新を無効にするロジックを変更しました。これにより、Server 2016 以降で自動更新が無効にならないバグが修正されます。
高度なユースケースのために POA の両方のマイクロサービスのデプロイ制約をパラメーター化しました。

バージョン 1.3.1

自動更新の無効化の失敗により、Windows Server 2012 R2 以前で POA 1.3.0 が動作しない回帰を修正しました。
InstallWindowsOSOnlyUpdates の構成が常に True として選択されるバグを修正しました。
InstallWindowsOSOnlyUpdates の既定値を False に変更します。

バージョン 1.3.2

現在のノード名のサブセットである名前を持つノードがある場合に、ノードでの修正プログラム適用のライフサイクルに影響する問題を修正しました。このようなノードでは、修正プログラムが適用されなかったか、再起動が保留中である可能性があります。

パッチ オーケストレーション アプリケーションの使用

POA の内部詳細

前提条件

Repair Manager サービスを有効にする (まだ実行されていない場合)

Azure クラスター

Azure ポータル

Azure Resource Manager デプロイ モデル

スタンドアロン オンプレミス クラスター

すべてのノードの Windows 更新プログラムを構成する

アプリケーション パッケージをダウンロードする

POA の動作を構成する

POA をデプロイする

POA をアップグレードする

POA を削除する

Windows Update の結果の確認

診断および正常性イベント

診断ログ

正常性レポート

よく寄せられる質問

免責事項

トラブルシューティング

ノードが稼働状態に戻らない

一部のノードで更新がスキップされた

更新プログラムのインストール中にクラスターの正常性がエラーになる

POA のリリース ノート

バージョン 1.1.0

バージョン 1.1.1

バージョン 1.2.0

バージョン 1.2.1

バージョン 1.2.2

バージョン 1.3.0

バージョン 1.3.1

バージョン 1.3.2

その他のリソース

パッチオーケストレーションアプリケーションの使用

Azure Resource Manager デプロイモデル

スタンドアロンオンプレミスクラスター

アプリケーションパッケージをダウンロードする

POA のリリースノート