オンプレミス配置でのバッチのみおよび対話型のみの AOS ノードのコンフィギュレーション

[アーティクル]
06/19/2024

重要

この機能は、アプリケーション更新 10.0.12 (プラットフォーム更新 36) 以降でサポートされます。

この記事では、環境をコンフィギュレーションして、バッチのみおよび対話型のみの Application Object Server (AOS) ノードを配置できるようにする方法について説明します。

この機能を使用できるようにするために、Microsoft は 2 つの新しい Microsoft Azure Service Fabric ノードタイプを導入しました。バッチ専用 AOS ノードの場合、新しいノードタイプは BatchOnlyAOSNodeType です。対話型のみの AOS ノードの場合、新しいノードタイプは InteractiveOnlyAOSNodeType です。

メモ

従来の配置オプションでは、AOS ノードが対話型でバッチジョブを実行している場合でもサポートされますが、これらの変更による影響はありません。

サイズ変更

サンドボックス環境では、各タイプのノードを 2 つ以上使用することをお勧めします。

運用環境では、それぞれのタイプのノードを 3 つ以上にする必要があります。

新しい配置

オンプレミス環境の設定と展開で説明されている構成を記述する場合は、configtemplate.xml ファイルを編集して新しいノードタイプを有効化します。完了すると、テンプレートは次のサンプルのようになります。

<NodeType name="AOSNodeType" primary="false" namePrefix="AOS" purpose="AOS" disabled="true">
    <VMList>
        <VM name="aos1" ipAddress="" faultDomain="fd:/fd0" updateDomain="ud0" hasSSIS="false" />
        <VM name="aos2" ipAddress="" faultDomain="fd:/fd1" updateDomain="ud1" hasSSIS="false" />
        <VM name="aos3" ipAddress="" faultDomain="fd:/fd0" updateDomain="ud2" hasSSIS="false" />
    </VMList>
</NodeType>
<NodeType name="InteractiveOnlyAOSNodeType" primary="false" namePrefix="AOS" purpose="AOS" disabled="false">
    <VMList>
        <VM name="LBDE05FS1AOS01" ipAddress="192.168.5.51" faultDomain="fd:/fd0" updateDomain="ud0" hasSSIS="false" />
        <VM name="LBDE05FS1AOS02" ipAddress="192.168.5.52" faultDomain="fd:/fd1" updateDomain="ud1" hasSSIS="false" />
        <VM name="LBDE05FS1AOS03" ipAddress="192.168.5.53" faultDomain="fd:/fd0" updateDomain="ud2" hasSSIS="false" />
    </VMList>
</NodeType>
<NodeType name="BatchOnlyAOSNodeType" primary="false" namePrefix="AOS" purpose="AOS" disabled="false">
    <VMList>
        <VM name="LBDE05FS1AOS04" ipAddress="192.168.5.54" faultDomain="fd:/fd0" updateDomain="ud0" hasSSIS="false" />
        <VM name="LBDE05FS1AOS05" ipAddress="192.168.5.55" faultDomain="fd:/fd1" updateDomain="ud1" hasSSIS="false" />
        <VM name="LBDE05FS1AOS06" ipAddress="192.168.5.56" faultDomain="fd:/fd0" updateDomain="ud2" hasSSIS="false" />
    </VMList>
</NodeType>

オンプレミス環境の設定と配置の残りの指示に通常どおりに従います。

既存の配置

コンフィギュレーションファイルを保存する時点まで、AOS ノードの削除の手順に従います。

重要

オプション 1「構成ファイルを使用する (推奨オプション)」を使用する必要があります。オプション 2 は使用しないでください。

ClusterConfig.json ファイルの編集を続け、新しいノードタイプを NodeTypes セクションに追加します。完了すると、NodeTypes セクションは次の例のようになります。

"NodeTypes": [
    {
        "Name": "AOSNodeType",
        "PlacementProperties": {
            "IsAosEnabled": "True"
        },
        "ClientConnectionEndpointPort": 19000,
        "HttpGatewayEndpointPort": 19080,
        "ReverseProxyEndpointPort": 19081,
        "LeaseDriverEndpointPort": 19002,
        "ClusterConnectionEndpointPort": 19001,
        "ServiceConnectionEndpointPort": 19003,
        "ApplicationPorts": {
            "StartPort": 20001,
            "EndPort": 20031
        },
        "IsPrimary": false
    },
    {
        "Name": "BatchOnlyAOSNodeType",
        "PlacementProperties": {
            "IsAosEnabled": "True"
        },
        "ClientConnectionEndpointPort": 19000,
        "HttpGatewayEndpointPort": 19080,
        "ReverseProxyEndpointPort": 19081,
        "LeaseDriverEndpointPort": 19002,
        "ClusterConnectionEndpointPort": 19001,
        "ServiceConnectionEndpointPort": 19003,
        "ApplicationPorts": {
            "StartPort": 20001,
            "EndPort": 20031
        },
        "IsPrimary": false
    },
    {
        "Name": "InteractiveOnlyAOSNodeType",
        "PlacementProperties": {
            "IsAosEnabled": "True"
        },
        "ClientConnectionEndpointPort": 19000,
        "HttpGatewayEndpointPort": 19080,
        "ReverseProxyEndpointPort": 19081,
        "LeaseDriverEndpointPort": 19002,
        "ClusterConnectionEndpointPort": 19001,
        "ServiceConnectionEndpointPort": 19003,
        "ApplicationPorts": {
            "StartPort": 20001,
            "EndPort": 20031
        },
        "IsPrimary": false
    },
    ...
]

クラスターからのノードの削除が完了するまで、停止したポイントから AOS ノードの削除の手順に引き続き従ってください。
Service Fabric Cluster から削除したコンピューターで、次の手順を実行します。
1. Service Fabric データルート (C:\ProgramData\SF) と Service Fabric ログルート (C:\ProgramData\SF\Log) の内容を削除します。
2. Windows Server 用 Service Fabric のスタンドアロンパッケージをバーチャルマシン (VM) またはコンピューターにコピーまたはダウンロードします。
3. パッケージを解凍します (C:\Temp\ServiceFabricStandalone)。
4. Windows PowerShell を管理者として開きます。
5. 次のコマンドを実行します。
  
  重要
  
  使用しているコンピューターコンフィギュレーションのパラメーターを必要に応じて置き換えます。
```
cd C:\Temp\ServiceFabricStandalone
.\AddNode.ps1 -NodeName AOS_12 -NodeType BatchOnlyAOSNodeType -NodeIpAddressOrFQDN 192.168.5.12 -ExistingClientConnectionEndpoint 192.168.5.21:19000 -UpgradeDomain ud0 -FaultDomain fd:/fd0 -X509Credential -ServerCertThumbprint 1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A -AcceptEULA -StoreLocation LocalMachine -StoreName MY -FindValueThumbprint 1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A
```
  メモ
  
  最初にノードが Service Fabric Explorer に再表示されたときは、古いノードタイプが表示されている可能性があります。ただし、数分後に更新されたノードタイプが表示されます。

ClusterConfig.json ファイルについて、Service Fabric Cluster を再度照会します。

Get-ServiceFabricClusterConfiguration -UseApiVersion -ApiVersion 10-2017 > C:\Temp\ClusterConfig.json

fabricSettings セクションで、NodesToBeRemoved パラメーターを削除します。完了すると、fabricSettings セクションは次の例のようになります。

"fabricSettings": [
    {
        "name": "Setup",
        "parameters": [
            {
                "name": "FabricDataRoot",
                "value": "C:\\\\ProgramData\\\\SF"
            },
            {
                "name": "FabricLogRoot",
                "value": "C:\\\\ProgramData\\\\SF\\\\Log"
            }
        ]
    }
]

セキュリティ セクションから次の行を削除します。
```
"WindowsIdentities": {
    "\$id": "3"
},
```
メモ

これらの行を削除しないと、後続の処理でで次のエラーメッセージが表示されます：

ValidationException: 認証タイプをセキュリティで保護されていないものから Windows に変更することはできません。
構成ファイルのバージョン番号をインクリメントします。この変更は最小限の増分で行ってください。次の例では、バージョン番号を 1.0.1 から 1.0.2 に変更しました。
```
"ClusterConfigurationVersion": "1.0.2"
```
構成ファイルを保存します。

管理者として Windows PowerShell を開き、次のコマンドを実行します。

Connect-ServiceFabricCluster
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath C:\Temp\ClusterConfig.json
Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 30

アップグレードを監視するには、次のコマンドを実行します。
```
Get-ServiceFabricClusterUpgrade
```
LCS からのアップグレードが完了したら、環境の更新をトリガーするために設定を変更しないで [設定の更新] ボタンを使用します。または、最新の修正プログラムを適用することもできます。

重要

この手順により、ダウンタイムが発生するため、しばらくの間環境を使用できなくなる可能性があることを確認してください。

次の方法で共有

オンプレミス配置でのバッチのみおよび対話型のみの AOS ノードのコンフィギュレーション

サイズ変更

新しい配置

既存の配置

フィードバック

フィードバック

その他のリソース