OpenShift での Data Grid の実行

手順

1. OpenShift Web コンソールにログインします。
2. OperatorHub に移動します。
3. Data Grid Operator を見つけ、これを選択します。
4. Install を選択し、Create Operator Subscription に進みます。

5. サブスクリプションのオプションを指定します。

   インストールモード

   Data Grid Operator は、特定の namespace または すべての namespace にインストールできます。

   更新チャネル

   Data Grid Operator 8.1.x の更新を取得します。

   承認ストラテジー

   8.1.x チャネルから更新を自動的にインストールするか、インストール前に承認が必要です。

6. Subscribe を選択して Data Grid Operator をインストールします。
7. Installed Operators に移動し、Data Grid Operator のインストールを確認します。

手順

1. プロジェクトを設定します。

   1. Data Grid Operator のプロジェクトを作成します。

   2. Data Grid Operator が特定の Data Grid クラスターのみを制御する必要がある場合は、そのクラスターのプロジェクトを作成します。

      $ oc new-project ${INSTALL_NAMESPACE} 

      1

      
      $ oc new-project ${WATCH_NAMESPACE} 

      2

      1

      Data Grid Operator をインストールするプロジェクトを作成します。

      2

      Data Grid Operator がすべてのプロジェクトを監視する必要がない場合は、オプションとして特定の Data Grid クラスターのプロジェクトを作成します。

2. OperatorGroup リソースを作成します。

   すべての Data Grid クラスターの制御

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
    name: datagrid
    namespace: ${INSTALL_NAMESPACE}
   EOF

   特定の Data Grid クラスターの制御

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
    name: datagrid
    namespace: ${INSTALL_NAMESPACE}
   spec:
    targetNamespaces:
    - ${WATCH_NAMESPACE}
   EOF

3. Data Grid Operator のサブスクリプションを作成します。

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
    name: datagrid-operator
    namespace: ${INSTALL_NAMESPACE}
   spec:
    channel: 8.1.x
    installPlanApproval: Automatic 

   1

   
    name: datagrid
    source: redhat-operators
    sourceNamespace: openshift-marketplace
   EOF

   1

   8.1.x チャネルからの更新を手動で承認する場合は、Manual を指定します。

4. インストールを確認します。

   $ oc get pods -n ${INSTALL_NAMESPACE}
   NAME                                   READY   STATUS
   infinispan-operator-<id>               1/1     Running

手順

1. Infinispan CR の spec.replicas で、クラスター内の Data Grid ノードの数を指定します。

   たとえば、以下のように cr_minimal.yaml ファイルを作成します。

   $ cat > cr_minimal.yaml<<EOF
   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
   EOF

2. Infinispan CR を適用します。

   $ oc apply -f cr_minimal.yaml

3. Data Grid Operator が Data Grid ノードを作成するのを監視します。

   $ oc get pods -w
   
   NAME                        READY  STATUS              RESTARTS   AGE
   example-infinispan-1        0/1    ContainerCreating   0          4s
   example-infinispan-2        0/1    ContainerCreating   0          4s
   example-infinispan-3        0/1    ContainerCreating   0          5s
   infinispan-operator-0       1/1    Running             0          3m
   example-infinispan-3        1/1    Running             0          8s
   example-infinispan-2        1/1    Running             0          8s
   example-infinispan-1        1/1    Running             0          8s

手順

1. Infinispan CR を作成します。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
     service:
       type: Cache 

   1

   1

   キャッシュサービスノードを作成します。これは Infinispan CR のデフォルトです。

2. Infinispan CR を適用して、クラスターを作成します。

手順

1. Infinispan CR の spec.service.type の値として DataGrid を指定します。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
     service:
       type: DataGrid

   注記

   ノードの作成後に spec.service.type フィールドを変更することはできません。サービスタイプを変更するには、既存のノードを削除してから新規のノードを作成する必要があります。

2. 他の Data Grid サービスリソースを使用してノードを設定します。
3. Infinispan CR を適用して、クラスターを作成します。

手順

1. Infinispan CR を開いて編集します。
2. Data Grid Operator が metadata.annotations を使用してリソースに割り当てるラベルを追加します。

3. metadata.labels を使用してラベルの値を追加します。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     annotations:
       # Add labels that you want to attach to services.
       infinispan.org/targetLabels: svc-label1, svc-label2
       # Add labels that you want to attach to pods.
       infinispan.org/podTargetLabels: pod-label1, pod-label2
     labels:
       # Add values for your labels.
       svc-label1: svc-value1
       svc-label2: svc-value2
       pod-label1: pod-value1
       pod-label2: pod-value2
       # The operator does not attach these labels to resources.
       my-label: my-value
       environment: development

4. Infinispan CR を適用します。

手順

1. Infinispan CR に spec.expose を追加します。

2. spec.expose.type でサービスタイプとして LoadBalancer を指定します。

   spec:
     ...
     expose:
       type: LoadBalancer 

   1

   
       nodePort: 30000 

   2

   1

   ポート 11222 のロードバランサーサービスを通じて、ネットワーク上に Data Grid を公開します。

   2

   必要に応じて、ロードバランサーサービスがトラフィックを転送するノードポートを定義します。

3. 変更を適用します。

4. -external サービスが使用できることを確認します。

   $ oc get services | grep external
   
   NAME                         TYPE            CLUSTER-IP    EXTERNAL-IP   PORT(S)
   example-infinispan-external  LoadBalancer    192.0.2.24    hostname.com  11222/TCP

手順

1. Infinispan CR に spec.expose を追加します。

2. spec.expose.type でサービスタイプとして NodePort を指定します。

   spec:
     ...
     expose:
       type: NodePort 

   1

   
       nodePort: 30000 

   2

   1

   ノードポートサービスを通じてネットワーク上に Data Grid を公開します。

   2

   Data Grid が公開されるポートを定義します。ポートを定義しない場合は、プラットフォームによってポートが選択されます。

3. 変更を適用します。

4. -external サービスが使用できることを確認します。

   $ oc get services | grep external
   
   NAME                         TYPE            CLUSTER-IP       EXTERNAL-IP   PORT(S)
   example-infinispan-external  NodePort        192.0.2.24       <none>        11222:30000/TCP

手順

1. Infinispan CR に spec.expose を追加します。
2. spec.expose.type でサービスタイプとして Route を指定します。

3. 必要に応じて、spec.expose.host を使用してホスト名を追加します。

   spec:
     ...
     expose:
       type: Route 

   1

   
       host: www.example.org 

   2

   1

   OpenShift Route を通じてネットワーク上に Data Grid を公開します。

   2

   必要に応じて、Data Grid が公開されるホスト名を指定します。

4. 変更を適用します。

5. ルートが利用可能であることを確認します。

   $ oc get routes
   
   NAME                 CLASS    HOSTS   ADDRESS   PORTS   AGE
   example-infinispan   <none>   *                 443     73s

手順

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

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

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

   $ oc create sa lon
   serviceaccount/lon created

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

   $ oc policy add-role-to-user view system:serviceaccount:<namespace>:lon

4. 他の OpenShift クラスターで直前の手順を繰り返します。

手順

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

2. 以下のコマンドを使用して、バックアップの場所のサービスアカウントトークンを追加します。

   $ oc create secret generic <token-name> --from-literal=token=<token>

   たとえば、NYC で OpenShift クラスターにログインし、以下のように lon-token シークレットを作成します。

   $ oc create secret generic lon-token --from-literal=token=eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9...

3. 他の OpenShift クラスターで直前の手順を繰り返します。

手順

1. 各 Data Grid クラスターに Infinispan CR を作成します。
2. metadata.name を使用して、各 Data Grid クラスターに同じ名前を指定します。
3. ローカルサイトの名前を spec.service.sites.local.name で指定します。
4. spec.service.sites.local.expose.type を使用して、ローカルサイトの公開サービスタイプを設定します。

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

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

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 3
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
           locations:
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token

   • NYC

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 2
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
           locations:
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token

6. クロスサイトレプリケーションのロギングレベルを次のように調整します。

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

   前述の設定では、JGroups TCP および RELAY2 プロトコルのロギングを減らします。これにより、コンテナーストレージを使用するログファイルが大量に生成される可能性があるクラスターバックアップ操作に関する過剰なメッセージを減らします。

7. 他の Data Grid サービスリソースを使用してノードを設定します。
8. Infinispan CR を適用します。

9. ノードログをチェックして、Data Grid クラスターがクロスサイトビューを形成していることを確認します。次に例を示します。

   $ oc logs example-infinispan-0 | grep x-site
   
   INFO  [org.infinispan.XSITE] (jgroups-5,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC]
   INFO  [org.infinispan.XSITE] (jgroups-7,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC, LON]

手順

1. StringData マップ内の Data Grid サービスクラスターにアクセスするための有効なユーザー認証情報を提供する Secret オブジェクトタイプを定義します。

   たとえば、次のように developer ユーザーの認証情報を提供する basic-auth.yaml ファイルを作成します。

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: G8ZdJvSaY3lOOwfM 

   2

   
   kind: Secret
   metadata:
     name: basic-auth 

   3

   
   type: Opaque

   1

   キャッシュを作成できるユーザーに名前を付けます。

   2

   ユーザーに対応するパスワードを指定します。

   3

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

2. 次の例のように、ファイルからシークレットを作成します。

   $ oc apply -f basic-auth.yaml

手順

1. 作成する XML キャッシュ定義を含む Cache CR を作成します。

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     template: <infinispan><cache-container><distributed-cache name="mycache" mode="SYNC"><persistence><file-store/></persistence></distributed-cache></cache-container></infinispan> 

   5

   1

   Cache CR に名前を付けます。

   2

   username と password のキーを認証情報に提供するシークレット、またはカスタム認証情報シークレットのオーバーライドを指定します。

   3

   Data Grid Operator がキャッシュを作成するターゲット Data Grid クラスターの名前を指定します。

   4

   Data Grid クラスター上のキャッシュに名前を付けます。

   5

   キャッシュを作成するための XML キャッシュ定義を指定します。name 属性は無視されることに注意してください。生成されるキャッシュには spec.name のみが適用されます。

2. Cache CR を適用します。以下に例を示します。

   $ oc apply -f mycache.yaml
   cache.infinispan.org/mycachedefinition created

手順

1. 使用するテンプレートの名前を指定する Cache CR を作成します。

   たとえば、次の CR は、org.infinispan.DIST_SYNC キャッシュ設定テンプレートを使用する "mycache" という名前のキャッシュを作成します。

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     templateName: org.infinispan.DIST_SYNC 

   5

   1

   Cache CR に名前を付けます。

   2

   username と password のキーを認証情報に提供するシークレット、またはカスタム認証情報シークレットのオーバーライドを指定します。

   3

   Data Grid Operator がキャッシュを作成するターゲット Data Grid クラスターの名前を指定します。

   4

   Data Grid キャッシュインスタンスに名前を付けます。

   5

   キャッシュを作成するための infinispan.org キャッシュ設定テンプレートを指定します。

2. Cache CR を適用します。以下に例を示します。

   $ oc apply -f mycache.yaml
   cache.infinispan.org/mycachedefinition created

手順

1. 各サイトに同じ名前のキャッシュ設定を作成します。

   各サイトのキャッシュ設定では、異なるキャッシュモードとバックアップストラテジーを使用できます。Data Grid は、キャッシュ名に基づいてデータを複製します。

2. take-offline 要素を使用して、バックアップの場所を自動的にオフラインになるように設定します。

   1. min-wait 属性で、バックアップの場所がオフラインになるまでの時間をミリ秒単位で設定します。
3. その他の有効なキャッシュ設定を定義します。

4. バックアップの場所を、グローバルクラスターのすべてのサイトの名前付きキャッシュに追加します。

   たとえば、NYC のバックアップとして LON を追加する場合、LON のバックアップとして NYC を追加する必要があります。

手順

1. $SERVICE_HOSTNAME:$PORT で任意のブラウザーからコンソールにアクセスします。

   $SERVICE_HOSTNAME:$PORT を、ネットワーク上で Data Grid を使用できるホスト名とポートに置き換えます。

2. プロンプトが表示されたら、Data Grid の認証情報を入力します。

手順

1. Prometheus が Data Grid クラスターで認証できるように、Data Grid 認証情報を含む認証シークレットを作成します。

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: dIRs5cAAsHIeeRIL 

   2

   
   kind: Secret
   metadata:
     name: basic-auth
   type: Opaque

   1

   アプリケーションユーザーを指定します。developer がデフォルトです。

   2

   対応するパスワードを指定します。

2. 認証シークレットを Prometheus namespace に追加します。

   $ oc apply -f basic-auth.yaml

3. Data Grid クラスターを監視するように Prometheus を設定するサービスモニターを作成します。

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       k8s-app: prometheus
     name: datagrid-monitoring 

   1

   
     namespace: infinispan-monitoring 

   2

   
   spec:
     endpoints:
       - targetPort: 11222 

   3

   
         path: /metrics 

   4

   
         honorLabels: true
         basicAuth:
           username:
             key: username
             name: basic-auth 

   5

   
           password:
             key: password
             name: basic-auth
         interval: 30s
         scrapeTimeout: 10s
         scheme: https 

   6

   
         tlsConfig:
           insecureSkipVerify: true
           serverName: example-infinispan 

   7

   
     namespaceSelector:
       matchNames:
         - infinispan 

   8

   
     selector:
       matchLabels:
         app: infinispan-service
         clusterName: example-infinispan 

   9

   1

   サービスモニターインスタンスに名前を付けます。

   2

   Prometheus スタックの namespace を指定します。

   3

   Data Grid メトリクスエンドポイントのポートを 11222 に設定します。

   4

   Data Grid がメトリクスを公開するパスを設定します。

   5

   Data Grid 認証情報を持つ認証シークレットを指定します。

   6

   Data Grid クラスターがエンドポイント暗号化を使用することを指定します。

   7

   Data Grid 暗号化の TLS 証明書の共通名 (CN) を指定します。OpenShift サービス証明書を使用する場合、CN は Data Grid クラスターの metadata.name リソースと一致します。

   8

   Data Grid クラスターの namespace を指定します。

   9

   Data Grid クラスターの名前を指定します。

4. サービスモニターインスタンスを Prometheus namespace に追加します。

   $ oc apply -f service-monitor.yaml

手順

1. spec.affinity ブロックを Infinispan CR に追加します。
2. 必要に応じて anti-affinity ストラテジーを設定します。
3. Infinispan CR を適用します。

手順

1. Infinispan CR の spec.logging でロギング設定を指定してから、変更を適用します。

   spec:
     ...
     logging: 

   1

   
       categories: 

   2

   
         org.infinispan: debug 

   3

   
         org.jgroups: debug

   1

   Data Grid ロギングを設定します。

   2

   ロギングカテゴリーを追加します。

   3

   ロギングカテゴリーとレベルに名前を付けます。

   注記

   ルートロギングカテゴリーは org.infinispan で、デフォルトでは INFO です。

2. 必要に応じて、Data Grid ノードからログを取得します。

   $ oc logs -f $POD_NAME