手順

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

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

   インストールモード

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

   更新チャネル

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

   承認ストラテジー

   8.2.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.2.x
    installPlanApproval: Automatic
    name: datagrid
    source: redhat-operators
    sourceNamespace: openshift-marketplace
   EOF

   注記

   8.2.x チャネルから更新を手動で承認する場合は、spec.installPlanApproval フィールドの値を Manual に変更します。

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

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

手順

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

   たとえば、以下のように 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 Pod を作成するのを監視します。

   $ 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. spec.replicas フィールドを 0 に変更し、Data Grid クラスターを停止します。

   spec:
     replicas: 0

2. クラスターを再起動する前に、Pod の数が正しいことを確認してください。

   $ oc get infinispan example-infinispan -o=jsonpath='{.status.replicasWantedAtRestart}'

3. spec.replicas フィールドを同じ Pod 数に変更して、Data Grid クラスターを再起動します。

   spec:
     replicas: 6

手順

1. spec.service.type: DataGrid を設定し、他のデータグリッドサービスリソースを設定する Infinispan CR を作成します。

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

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

手順

1. spec.service.type: DataGrid を設定し、他のキャッシュサービスリソースを設定する Infinispan CR を作成します。

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

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

手順

1. ストレージリソースを spec.service.container.storage フィールドで割り当てます。

2. オプションで、必要に応じて ephemeralStorage および storageClassName フィールドを設定します。

   spec:
     service:
       type: DataGrid
       container:
         storage: 2Gi
         ephemeralStorage: false
         storageClassName: my-storage-class

3. 変更を適用します。

手順

1. Infinispan CR の spec.logging.categories フィールドで、Data Grid ロギングを設定します。

   spec:
     logging:
       categories:
         org.infinispan: debug
         org.jgroups: debug

2. 変更を適用します。

3. 必要に応じて、Data Grid Pod からログを取得します。

   $ oc logs -f $POD_NAME

手順

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

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

   1. metadata.annotations.infinispan.org/targetLabels フィールドでサービスに割り当てるラベルを指定します。
   2. metadata.annotations.infinispan.org/podTargetLabels フィールドで Pod に割り当てるラベルを指定します。

   3. metadata.labels フィールドでラベルの値を定義します。

      apiVersion: infinispan.org/v1
      kind: Infinispan
      metadata:
        annotations:
          infinispan.org/targetLabels: svc-label1, svc-label2
          infinispan.org/podTargetLabels: pod-label1, pod-label2
        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. 追加する認証情報を使って identities.yaml ファイルを作成します。

   credentials:
   - username: myfirstusername
     password: changeme-one
   - username: mysecondusername
     password: changeme-two

2. identities.yaml から認証シークレットを作成します。

   $ oc create secret generic --from-file=identities.yaml connect-secret

3. Infinispan CR の spec.security.endpointSecretName で認証シークレットを指定し、変更を適用します。

   spec:
     security:
       endpointSecretName: connect-secret

手順

1. false を Infinispan CR の spec.security.endpointAuthentication フィールドの値として設定します。

   spec:
     security:
       endpointAuthentication: false

2. 変更を適用します。

手順

1. Infinispan CR の spec.security.endpointEncryption.clientCert フィールドの値として、Validate または Authenticate を設定します。

   注記

   デフォルト値は None です。

2. クライアントトラストストアを含むシークレットを spec.security.endpointEncryption.clientCertSecretName フィールドで指定します。

   デフォルトでは、Data Grid Operator は <cluster-name>-client-cert-secret という名前のトラストストアシークレットを想定します。

   注記

   シークレットは OpenShift クラスターの各 Infinispan CR インスタンスに固有のものである必要があります。Infinispan CR を削除すると、OpenShift は関連付けられたシークレットも自動的に削除します。

   spec:
     security:
       endpointEncryption:
           type: Service
           certSecretName: tls-secret
           clientCert: Validate
           clientCertSecretName: example-infinispan-client-cert-secret

3. 変更を適用します。

手順

1. クライアントトラストストアを含むシークレットの名前を metadata.name フィールドの値として指定します。

   注記

   この名前は spec.security.endpointEncryption.clientCertSecretName フィールドの値に一致する必要があります。

2. トラストストアのパスワードを stringData.truststore-password フィールドで指定します。

3. data.truststore.p12 フィールドでトラストストアを指定します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: example-infinispan-client-cert-secret
   type: Opaque
   stringData:
       truststore-password: changme
   data:
       truststore.p12:  "<base64_encoded_PKCS12_trust_store>"

4. 変更を適用します。

手順

1. クライアントトラストストアを含むシークレットの名前を metadata.name フィールドの値として指定します。

   注記

   この名前は spec.security.endpointEncryption.clientCertSecretName フィールドの値に一致する必要があります。

2. 署名証明書または CA 証明書バンドルを data.trust.ca フィールドの値として指定します。

3. Authenticate ストラテジーを使用してクライアント ID を検証する場合は、data.trust.cert.<name> フィールドで Data Grid エンドポイントに接続可能な各クライアントの証明書を追加します。

   注記

   Data Grid Operator は、<name> の値をトラストストアの生成時に証明書のエイリアスとして使用します。

4. オプションで、stringData.truststore-password フィールドでトラストストアのパスワードを指定します。

   指定しない場合、Data Grid Operator は password をトラストストアのパスワードとして設定します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: example-infinispan-client-cert-secret
   type: Opaque
   stringData:
       truststore-password: changme
   data:
       trust.ca: "<base64_encoded_CA_certificate>"
       trust.cert.client1: "<base64_encoded_client_certificate>"
       trust.cert.client2: "<base64_encoded_client_certificate>"

5. 変更を適用します。

手順

1. None を Infinispan CR の spec.security.endpointEncryption.type フィールドの値として設定します。

   spec:
     security:
       endpointEncryption:
         type: None

2. 変更を適用します。

手順

1. 暗号化シークレットを OpenShift namespace に追加します。以下に例を示します。

   $ oc apply -f tls_secret.yaml

2. Infinispan CR の spec.security.endpointEncryption.certSecretName フィールドで暗号化シークレットを指定します。

   spec:
     security:
       endpointEncryption:
         type: Secret
         certSecretName: tls-secret

3. 変更を適用します。

手順

1. true を Infinispan CR の spec.security.authorization.enabled フィールドの値として設定します。

   spec:
     security:
       authorization:
         enabled: true

2. 変更を適用します。

手順

1. ロールをユーザーに割り当てる identities.yaml ファイルを作成します。

   credentials:
     - username: admin
       password: changeme
     - username: my-user-1
       password: changeme
       roles:
         - admin
     - username: my-user-2
       password: changeme
       roles:
         - monitor

2. identities.yaml から認証シークレットを作成します。

   必要に応じて、既存のシークレットを最初に削除します。

   $ oc delete secret connect-secret --ignore-not-found
   $ oc create secret generic --from-file=identities.yaml connect-secret

3. Infinispan CR の spec.security.endpointSecretName で認証シークレットを指定し、変更を適用します。

   spec:
     security:
       endpointSecretName: connect-secret

手順

1. Infinispan CR を開いて編集します。

2. カスタムロールおよびそれらに関連付けられたパーミッションを spec.security.authorization.roles フィールドで指定します。

   spec:
     security:
       authorization:
         enabled: true
         roles:
           - name: my-role-1
             permissions:
               - ALL
           - name: my-role-2
             permissions:
               - READ
               - WRITE

3. 変更を適用します。

手順

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

3. オプションで、サービスが spec.expose.port フィールドで公開されるネットワークポートを指定します。デフォルトのポートは 7900 です。

   spec:
     expose:
       type: LoadBalancer
       port: 65535

4. 変更を適用します。

5. -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. NodePort を spec.expose.type フィールドでサービスタイプとして指定します。

3. Data Grid が spec.expose.nodePort フィールドで公開されるポートを定義します。

   spec:
     expose:
       type: NodePort
       nodePort: 30000

4. 変更を適用します。

5. -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. Route を spec.expose.type フィールドでサービスタイプとして指定します。

3. オプションで、spec.expose.host フィールドでホスト名を追加します。

   spec:
     expose:
       type: Route
       host: www.example.org

4. 変更を適用します。

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

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

1. OpenShift Web コンソールで、</> Developer パースペクティブを選択してから、Monitoring を選択します。
2. Data Grid クラスターが実行される namespace の Dashboard タブを開きます。

3. Metrics タブを開き、以下のような Data Grid メトリクスをクエリーできることを確認します。

   vendor_cache_manager_default_cluster_size

手順

1. Grafana が Prometheus から Data Grid メトリクスを読み取りできるようにする ServiceAccount を作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: infinispan-monitoring

   1. ServiceAccount を適用します。

      $ oc apply -f service-account.yaml

   2. cluster-monitoring-view パーミッションを ServiceAccount に付与します。

      $ oc adm policy add-cluster-role-to-user cluster-monitoring-view -z infinispan-monitoring

2. Grafana データソースを作成します。

   1. ServiceAccount のトークンを取得します。

      $ oc serviceaccounts get-token infinispan-monitoring
      
      eyJhbGciOiJSUzI1NiIsImtpZCI6Imc4O...

   2. 以下の例のように、spec.datasources.secureJsonData.httpHeaderValue1 フィールドにトークンが含まれる GrafanaDataSource を定義します。

      apiVersion: integreatly.org/v1alpha1
      kind: GrafanaDataSource
      metadata:
        name: grafanadatasource
      spec:
        name: datasource.yaml
        datasources:
          - access: proxy
            editable: true
            isDefault: true
            jsonData:
              httpHeaderName1: Authorization
              timeInterval: 5s
              tlsSkipVerify: true
            name: Prometheus
            secureJsonData:
              httpHeaderValue1: >-
                Bearer
                eyJhbGciOiJSUzI1NiIsImtpZCI6Imc4O...
            type: prometheus
            url: 'https://thanos-querier.openshift-monitoring.svc.cluster.local:9091'

3. GrafanaDataSource を適用します。

   $ oc apply -f grafana-datasource.yaml

手順

1. Data Grid Operator namespace に infinispan-operator-config という名前の ConfigMap を作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: infinispan-operator-config
   data:
     grafana.dashboard.namespace: example-infinispan
     grafana.dashboard.name: infinispan
     grafana.dashboard.monitoring.key: middleware

2. Data Grid クラスターの namespace を data.grafana.dashboard.namespace プロパティーで指定します。

   注記

   このプロパティーの値を削除すると、ダッシュボードが削除されます。値を変更すると、Dashboard はその namespace に移動します。

3. data.grafana.dashboard.name プロパティーでダッシュボードの名前を指定します。
4. 必要な場合は、モニターリングキーを data.grafana.dashboard.monitoring.key プロパティーで指定します。

5. infinispan-operator-config を作成するか、設定を更新します。

   $ oc apply -f infinispan-operator-config.yaml

6. 以下で入手可能な Grafana UI を開きます。

   $ oc get routes grafana-route -o jsonpath=https://"{.spec.host}"

手順

1. 各 Data Grid クラスターに Infinispan CR を作成します。
2. ローカルサイトの名前を spec.service.sites.local.name で指定します。
3. spec.service.sites.local.expose.type フィールドの値を NodePort または LoadBalancer のいずれかに設定します。

4. 必要に応じて、以下のフィールドを使用してポートを設定します。

   • spec.service.sites.local.expose.nodePort (NodePort を使用する場合)
   • spec.service.sites.local.expose.port (LoadBalancer を使用する場合)

5. spec.service.sites.locations でバックアップの場所として動作する各 Data Grid クラスターの名前と静的 URL を指定します。以下に例を示します。

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 3
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
               port: 65535
           locations:
             - name: NYC
               url: infinispan+xsite://infinispan-nyc.myhost.com:7900
       logging:
         categories:
           org.jgroups.protocols.TCP: error
           org.jgroups.protocols.relay.RELAY2: error

   • NYC

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 2
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
               port: 65535
           locations:
             - name: LON
               url: infinispan+xsite://infinispan-lon.myhost.com
       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

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

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

   1. Infinispan CR を取得します。

      $ oc get infinispan -o yaml

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

手順

1. 各 Data Grid クラスターに Infinispan CR を作成します。
2. ローカルサイトの名前を spec.service.sites.local.name で指定します。
3. ClusterIP を spec.service.sites.local.expose.type フィールドの値として設定します。
4. spec.service.sites.locations.clusterName でバックアップの場所として動作する Data Grid クラスターの名前を指定します。

5. 両方の Data Grid クラスターの名前が同じである場合は、spec.service.sites.locations.namespace でバックアップの場所の namespace を指定します。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-clustera
   spec:
     replicas: 1
     expose:
       type: LoadBalancer
     service:
       type: DataGrid
       sites:
         local:
           name: SiteA
           expose:
             type: ClusterIP
         locations:
           - name: SiteB
             clusterName: example-clusterb
             namespace: cluster-namespace

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

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

   1. Infinispan CR を取得します。

      $ oc get infinispan -o yaml

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

手順

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

手順

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

   1. metadata.name フィールドで Cache CR の名前を指定します。
   2. ターゲット Data Grid クラスターを spec.clusterName フィールドで指定します。

   3. spec.name フィールドで、キャッシュに名前を付けます。

      注記

      XML 設定の name 属性は無視されます。spec.name フィールドのみが生成されるキャッシュに適用されます。

   4. spec.template フィールドで XML キャッシュ設定を追加します。

      apiVersion: infinispan.org/v2alpha1
      kind: Cache
      metadata:
        name: mycachedefinition
      spec:
        clusterName: example-infinispan
        name: mycache
        template: <distributed-cache name="mycache" mode="SYNC"><persistence><file-store/></persistence></distributed-cache>

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

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

手順

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

   1. metadata.name フィールドで Cache CR の名前を指定します。
   2. ターゲット Data Grid クラスターを spec.clusterName フィールドで指定します。
   3. spec.name フィールドで、キャッシュに名前を付けます。

   4. spec.template フィールドで、キャッシュテンプレートを指定します。

      以下の例では、org.infinispan.DIST_SYNC キャッシュテンプレートから mycache という名前のキャッシュを作成します。

      apiVersion: infinispan.org/v2alpha1
      kind: Cache
      metadata:
        name: mycachedefinition
      spec:
        clusterName: example-infinispan
        name: mycache
        templateName: org.infinispan.DIST_SYNC

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

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

手順

1. リモートサイトをバックアップの場所として指定するキャッシュ設定を作成します。

   Data Grid は、キャッシュ名に基づいてデータを複製します。このため、キャッシュ設定のサイト名は、Infinispan CR のサイト名 spec.service.sites.local.name と一致する必要があります。

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

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

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

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

手順

1. Batch CR を作成します。

   1. バッチ操作を spec.cluster フィールドの値として実行する Data Grid クラスターの名前を指定します。

   2. 各 CLI コマンドを追加して、spec.config フィールドの行で実行します。

      apiVersion: infinispan.org/v2alpha1
      kind: Batch
      metadata:
        name: mybatch
      spec:
        cluster: example-infinispan
        config: |
          create cache --template=org.infinispan.DIST_SYNC mycache
          put --cache=mycache hello world
          put --cache=mycache hola mundo

2. Batch CR を適用します。

   $ oc apply -f mybatch.yaml

3. Batch CR の status.Phase フィールドをチェックして、操作が正常に完了したことを確認します。

手順

1. 実行するすべてのコマンドが含まれる batch ファイルを作成します。

   たとえば、以下の batch ファイルは、mycache という名前のキャッシュを作成し、2 つのエントリーをこれに追加します。

   create cache mycache --file=/etc/batch/mycache.xml
   put --cache=mycache hello world
   put --cache=mycache hola mundo

   重要

   ConfigMap は、/etc/batch の Data Grid Pod にマウントされます。バッチ操作のすべての --file= ディレクティブの前に、そのパスを付ける必要があります。

2. バッチ操作が必要とするすべての設定アーティファクトが、batch ファイルと同じディレクトリーにあることを確認します。

   $ ls /tmp/mybatch
   
   batch
   mycache.xml

3. ディレクトリーから ConfigMap を作成します。

   $ oc create configmap mybatch-config-map --from-file=/tmp/mybatch

手順

1. Data Grid クラスターの名前を spec.cluster フィールドの値として指定する Batch CR を作成します。

2. spec.configMap フィールドで batch ファイルおよび設定アーティファクトを含む ConfigMap の名前を設定します。

   $ cat > mybatch.yaml<<EOF
   apiVersion: infinispan.org/v2alpha1
   kind: Batch
   metadata:
     name: mybatch
   spec:
     cluster: example-infinispan
     configMap: mybatch-config-map
   EOF

3. Batch CR を適用します。

   $ oc apply -f mybatch.yaml

4. Batch CR の status.Phase フィールドをチェックして、操作が正常に完了したことを確認します。

手順

1. metadata.name フィールドで Backup CR に名前を付けます。
2. spec.cluster フィールドでバックアップする Data Grid クラスターを指定します。

3. spec.volume.storage および spec.volume.storage.storageClassName フィールドで、バックアップアーカイブを永続ボリューム (PV) に追加する Persistent Volume Claim(永続ボリューム要求、PVC) を設定します。

   apiVersion: infinispan.org/v2alpha1
   kind: Backup
   metadata:
     name: my-backup
   spec:
     cluster: source-cluster
     volume:
       storage: 1Gi
       storageClassName: my-storage-class

4. 任意で spec.resources フィールドを含めて、バックアップを作成する Data Grid リソースを指定します。

   spec.resources フィールドを含めない場合、Backup CR はすべての Data Grid リソースが含まれるアーカイブを作成します。spec.resources フィールドを指定した場合、Backup CR はそれらのリソースのみが含まれるアーカイブを作成します。

   spec:
     ...
     resources:
       templates:
         - distributed-sync-prod
         - distributed-sync-dev
       caches:
         - cache-one
         - cache-two
       counters:
         - counter-name
       protoSchemas:
         - authors.proto
         - books.proto
       tasks:
         - wordStream.js

   以下の例のように * ワイルドカード文字を使用することもできます。

   spec:
     ...
     resources:
       caches:
         - "*"
       protoSchemas:
         - "*"

5. Backup CR を適用します。

   $ oc apply -f my-backup.yaml

検証

1. status.phase フィールドに Backup CR の Succeeded のステータスがあり、Data Grid ログに以下のメッセージがあることを確認します。

   ISPN005044: Backup file created 'my-backup.zip'

2. 以下のコマンドを実行して、バックアップが正常に作成されていることを確認します。

   $ oc describe Backup my-backup

手順

1. metadata.name フィールドで Restore CR に名前を付けます。
2. spec.backup フィールドで使用する Backup CR を指定します。

3. spec.cluster フィールドで復元する Data Grid クラスターを指定します。

   apiVersion: infinispan.org/v2alpha1
   kind: Restore
   metadata:
     name: my-restore
   spec:
     backup: my-backup
     cluster: target-cluster

4. 任意で spec.resources フィールドを追加して、特定のリソースのみを復元します。

   spec:
     ...
     resources:
       templates:
         - distributed-sync-prod
         - distributed-sync-dev
       caches:
         - cache-one
         - cache-two
       counters:
         - counter-name
       protoSchemas:
         - authors.proto
         - books.proto
       tasks:
         - wordStream.js

5. Restore CR を適用します。

   $ oc apply -f my-restore.yaml

手順

1. Data Grid クラスターの namespace に変更します。

   $ oc project rhdg-namespace

2. 以下のように、カスタムコードアーティファクトの PVC を作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: datagrid-libs
   spec:
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 100Mi

3. PVC を適用します。

   $ oc apply -f datagrid-libs.yaml

4. 以下のように、PVC をマウントする Pod を作成します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: datagrid-libs-pod
   spec:
     securityContext:
       fsGroup: 2000
     volumes:
       - name: lib-pv-storage
         persistentVolumeClaim:
           claimName: datagrid-libs
     containers:
       - name: lib-pv-container
         image: registry.redhat.io/datagrid/datagrid-8-rhel8:8.2
         volumeMounts:
           - mountPath: /tmp/libs
             name: lib-pv-storage

5. Pod を Data Grid namespace に追加し、準備ができるまで待機します。

   $ oc apply -f datagrid-libs-pod.yaml
   $ oc wait --for=condition=ready --timeout=2m pod/datagrid-libs-pod

6. コードのアーティファクトを Pod にコピーし、それらが PVC に読み込まれるようにします。

   たとえば、ローカルの locallibs ディレクトリーからコードアーティファクトをコピーするには、以下を実行します。

   $ oc cp --no-preserve=true libs datagrid-libs-pod:/tmp/

7. Pod を削除します。

   $ oc delete pod datagrid-libs-pod

   永続ボリュームを Infinispan CR の spec.dependencies.volumeClaimName で指定してから、変更を適用します。

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

手順

1. spec.dependencies.artifacts フィールドを Infinispan CR に追加します。

   1. HTTP または FTP 経由でダウンロードするファイルの場所を spec.dependencies.artifacts.url フィールドの値として指定します。

   2. オプションで、spec.dependencies.artifacts.hash フィールドでダウンロードの整合性を検証するチェックサムを指定します。

      hash フィールドでは、値が <algorithm>:<checksum> の形式で指定する必要があります。ここで、<algorithm> は sha1|sha224|sha256|sha384|sha512|md5 になります。

   3. 必要に応じて spec.dependencies.artifacts.type フィールドでファイルタイプを設定します。

      ファイルタイプが URL に含まれていない場合や、ファイルタイプが URL のエクステンションと実際には異なる場合は、明示的にファイルタイプを設定する必要があります。

      注記

      type: file を設定する場合、Data Grid Operator は、ファイルをファイルシステムに抽出せずにそのままダウンロードします。

      apiVersion: infinispan.org/v1
      kind: Infinispan
      metadata:
        name: example-infinispan
      spec:
        replicas: 2
        dependencies:
          artifacts:
            - url: http://example.com:8080/path
              hash: sha256:596408848b56b5a23096baa110cd8b633c9a9aef2edd6b38943ade5b4edcd686
              type: zip
        service:
          type: DataGrid

2. 変更を適用します。

手順

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

   1. spec.cloudEvents.acks フィールドで確認応答の数を設定します。値は 0、1、または all です。
   2. Data Grid が spec.cloudEvents.bootstrapServers フィールドでイベントを送信する Kafka サーバーを一覧表示します。

   3. Data Grid イベントの Kafka トピックを spec.cloudEvents.cacheEntriesTopic フィールドで指定します。

      spec:
        cloudEvents:
          acks: "1"
          bootstrapServers: my-cluster-kafka-bootstrap_1.<namespace_1>.svc:9092,my-cluster-kafka-bootstrap_2.<namespace_2>.svc:9092
          cacheEntriesTopic: target-topic

2. 変更を適用します。

手順

1. Data Grid クラスターへの CLI コネクションを作成します。

   サーバーのディストリビューションの使用

   $ bin/cli.sh -c https://$SERVICE_HOSTNAME:$PORT --trustall

   ネイティブ CLI の使用

   $ ./redhat-datagrid-cli -c https://$SERVICE_HOSTNAME:$PORT --trustall

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

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

3. 必要に応じて CLI 操作を実行します。以下に例を示します。

   1. ls コマンドを使用して、クラスターに設定されたキャッシュを一覧表示します。

      [//containers/default]> ls caches
      mycache

   2. describe コマンドでキャッシュ設定を表示します。

      [//containers/default]> describe caches/mycache