13.2. マネージドのクロスサイトレプリケーション

手順

1. OpenShift クラスターにログインします。

2. サービスアカウントを作成します。

   たとえば、LON でサービスアカウントを作成します。

   oc create sa -n <namespace> lon

3. 以下のコマンドを使用して、ビューロールをサービスアカウントに追加します。

   oc policy add-role-to-user view -n <namespace> -z lon

4. NodePort サービスを使用してネットワーク上で Data Grid クラスターを公開する場合、cluster-reader ロールをサービスアカウントに追加する必要もあります。

   oc adm policy add-cluster-role-to-user cluster-reader -z lon -n <namespace>

5. 他の OpenShift クラスターで直前の手順を繰り返します。
6. 各 OpenShift クラスターでサービスアカウントトークンを交換します。

手順

1. OpenShift クラスターにログインします。

2. 次のようにサービスアカウントトークンのシークレットファイルを作成します。

   sa-token.yaml

   apiVersion: v1
   kind: Secret
   metadata:
     name: ispn-xsite-sa-token 1
     annotations:
       kubernetes.io/service-account.name: "<service-account>" 2
   type: kubernetes.io/service-account-token

   1

   シークレットの名前を指定します。

   2

   サービスアカウント名を指定します。

3. OpenShift クラスターにシークレットを作成します。

   oc -n <namespace> create -f sa-token.yaml

4. サービスアカウントトークンを取得します。

   oc -n <namespace> get secrets ispn-xsite-sa-token -o jsonpath="{.data.token}" | base64 -d

   このコマンドにより、ターミナルにトークンが出力されます。

5. バックアップ OpenShift クラスターにデプロイメント用のトークンをコピーします。
6. バックアップ OpenShift クラスターにログインします。

7. バックアップの場所用のサービスアカウントトークンを追加します。

   oc -n <namespace> create secret generic <token-secret> --from-literal=token=<token>

   <token-secret> は、Infinispan CR で設定したシークレットの名前です。

手順

1. OpenShift クラスターにログインします。

2. サービスアカウント用のバインドされたトークンを作成します。

   oc -n <namespace> create token <service-account>

   注記

   デフォルトでは、サービスアカウントトークンの有効期間は 1 時間です。有効期間を秒単位で指定するには、コマンドオプション --duration を使用してください。

   このコマンドにより、ターミナルにトークンが出力されます。

3. バックアップ OpenShift クラスターにデプロイメント用のトークンをコピーします。
4. バックアップ OpenShift クラスターにログインします。

5. バックアップの場所用のサービスアカウントトークンを追加します。

   oc -n <namespace> create secret generic <token-secret> --from-literal=token=<token>

   <token-secret> は、Infinispan CR で設定したシークレットの名前です。

6. 他の OpenShift クラスターでもこの手順を繰り返します。

1. バックアップ OpenShift クラスターにログインします。

2. 期限切れのシークレット <token-secret> を削除します。

   oc -n <namespace> delete secrets <token-secret>

3. 手順を再度実行して新しいトークンを作成し、新しい <token-secret> を生成します。

手順

1. 各 Data Grid クラスターに Infinispan CR を作成します。
2. ローカルサイトの名前を spec.service.sites.local.name で指定します。

3. クロスサイトレプリケーションの公開タイプを設定します。

   1. spec.service.sites.local.expose.type フィールドの値を次のいずれかに設定します。

      • NodePort
      • LoadBalancer
      • ルート

   2. オプションで、次のフィールドを使用してポートまたはカスタムホスト名を指定します。

      • NodePort サービスを使用する場合の spec.service.sites.local.expose.nodePort。
      • LoadBalancer サービスを使用する場合の spec.service.sites.local.expose.port。
      • OpenShift Route を使用する場合は、spec.service.sites.local.expose.routeHostName を使用します。

4. RELAY メッセージを service.sites.local.maxRelayNodes フィールドで送信できる Pod の数を指定します。

   ヒント

   パフォーマンス向上のため RELAY メッセージを送信するようにクラスター内のすべての Pod を設定します。すべての Pod がバックアップ要求を直接送信する場合には、バックアップ要求を転送する必要はありません。

5. spec.service.sites.locations でバックアップの場所として動作する各 Data Grid クラスターの名前、URL、およびシークレットを指定します。

6. リモートサイトの Data Grid クラスター名または namespace がローカルサイトに一致しない場合は、それらの値を clusterName および namespace フィールドで指定します。

   以下は、LON および NYC の Infinispan CR 定義の例になります。

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: infinispan
     spec:
       replicas: 3
       version: <Data Grid_version>
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
               port: 65535
             maxRelayNodes: 1
           locations:
             - name: NYC
               clusterName: <nyc_cluster_name>
               namespace: <nyc_cluster_namespace>
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token
       logging:
         categories:
           org.jgroups.protocols.TCP: error
           org.jgroups.protocols.relay.RELAY2: error

   • NYC

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: nyc-cluster
     spec:
       replicas: 2
       version: <Data Grid_version>
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
               port: 65535
             maxRelayNodes: 1
           locations:
             - name: LON
               clusterName: infinispan
               namespace: rhdg-namespace
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token
       logging:
         categories:
           org.jgroups.protocols.TCP: error
           org.jgroups.protocols.relay.RELAY2: error

     重要

     JGroups TCP および RELAY2 プロトコルのログレベルを下げるために、Infinispan CR のロギングカテゴリーを調整してください。これにより、多数のログファイルがコンテナーストレージを使用することを防ぎます。

     spec:
       logging:
         categories:
           org.jgroups.protocols.TCP: error
           org.jgroups.protocols.relay.RELAY2: error

7. 他の Data Grid サービスリソースで Infinispan CR を設定してから、変更を適用します。

8. Data Grid クラスターがクロスサイトビューを形成することを確認します。

   1. Infinispan CR を取得します。

      oc get infinispan -o yaml

   2. type: CrossSiteViewFormed 条件を確認します。