Data Grid Operator ガイド

手順

1. ネイティブ Data Grid CLI ディストリビューションの .zip アーカイブを展開します。

2. ネイティブ実行ファイルをコピーするか、kubectl-infinispan という名前のファイルにハードリンクを作成します。以下に例を示します。

   cp redhat-datagrid-cli kubectl-infinispan

3. kubectl-infinispan を PATH に追加します。

4. CLI がインストールされていることを確認します。

   oc plugin list
   
   The following compatible plugins are available:
   /path/to/kubectl-infinispan

5. infinispan --help コマンドを使用して、利用可能なコマンドを表示します。

   oc infinispan --help

手順

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

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

   インストールモード

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

   更新チャネル

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

   承認ストラテジー

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

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

手順

1. 以下のように、oc infinispan install コマンドを実行して Data Grid Operator サブスクリプションを作成します。

   oc infinispan install --channel=8.3.x
                              --source=redhat-operators
                              --source-namespace=openshift-marketplace

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

   oc get pods -n openshift-operators | grep infinispan-operator
   NAME                                   READY   STATUS
   infinispan-operator-<id>               1/1     Running

手順

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

   注記

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

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

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

手順

1. infinispan create cluster コマンドを実行します。

   たとえば、以下のように 2 つの Pod を含めて Data Grid クラスターを作成します。

   oc infinispan create cluster --replicas=3 -Pservice.type=DataGrid infinispan

2. Data Grid Operator が Data Grid Pod を作成するのを監視します。

   oc get pods -w

手順

1. Infinispan CR を定義する YAML ファイルを作成します。

   たとえば、Data Grid Pod の数を 2 に変更する my_infinispan.yaml ファイルを作成します。

   cat > cr_minimal.yaml<<EOF
   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: infinispan
   spec:
     replicas: 2
     service:
       type: DataGrid
   EOF

2. Infinispan CR を適用します。

   oc apply -f my_infinispan.yaml

3. Data Grid Operator で Data Grid Pod がスケーリングされることを確認します。

   oc get pods -w

手順

1. spec.replicas フィールドを 0 に変更し、Data Grid クラスターを停止します。

   spec:
     replicas: 0

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

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

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

   spec:
     replicas: 6

手順

1. ConfigMap の data フィールドの infinispan-config.[xml|yaml|json] キーに Data Grid 設定を追加します。

   XML

   apiVersion: v1
   kind: ConfigMap
   metadata:
      name: cluster-config
      namespace: rhdg-namespace
   data:
      infinispan-config.xml: >
        <infinispan>
          <!-- Custom configuration goes here. -->
        </infinispan>

   YAML

   apiVersion: v1
   kind: ConfigMap
   metadata:
      name: cluster-config
      namespace: rhdg-namespace
   data:
      infinispan-config.yaml: >
        infinispan:
          # Custom configuration goes here.

   JSON

   apiVersion: v1
   kind: ConfigMap
   metadata:
      name: cluster-config
      namespace: rhdg-namespace
   data:
      infinispan-config.json: >
        {
          "infinispan": {
          }
        }

2. YAML ファイルから ConfigMap を作成します。

   oc apply -f cluster-config.yaml

3. Infinispan CR の spec.configMapName フィールドで ConfigMap の名前を指定し、変更を適用します。

   spec:
     configMapName: "cluster-config"

1. 既存のクラスターを正常にシャットダウンします。
2. 既存のクラスターを削除します。
3. ターゲットバージョンで新しいクラスターを作成します。

1. 既存のクラスターと並行して実行されるターゲットバージョンを使用して、新しい Data Grid クラスターを作成します。
2. 既存のクラスターから新しいクラスターにデータを転送するためのリモートキャッシュストアを作成します。
3. すべてのクライアントを新しいクラスターにリダイレクトします。
4. すべてのデータおよびクライアント接続が新しいクラスターに転送されるときに、既存のクラスターを削除します。

手順

1. デフォルトである spec.upgrades.type フィールドの値として Shutdown が設定されていることを確認します。

   spec:
     upgrades:
       type: Shutdown

2. 必要に応じて、変更を適用します。

手順

1. spec.upgrades.type フィールドの値として HotRodRolling を指定します。

   spec:
     upgrades:
       type: HotRodRolling

2. 変更を適用します。

手順

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

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

   重要

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

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

手順

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

2. 必要に応じて、ephemeralStorage フィールドまたは storageClassName フィールド を設定します。

   注記

   これらのフィールドは同時に使用でいません。どちらか 1 つだけを Infinispan CR に追加します。

3. 変更を適用します。

手順

1. spec.container.cpu フィールドで CPU ユニットの数を割り当てます。

2. メモリーの量 (バイト単位) を spec.container.memory フィールドで割り当てます。

   cpu および memory フィールドでは <limit>:<requests> 形式で値を指定します。たとえば、cpu: "2000m:1000m" は Pod を最大 2000m の CPU に制限し、起動時に各 Pod に対して 1000m の CPU を要求します。値を 1 つ指定すると、制限と要求の両方が設定されます。

3. Infinispan CR を適用します。

   クラスターが実行されている場合には、Data Grid Operator は Data Grid Pod を再起動して変更を有効にします。

手順

1. Infinispan CR にファイルされた spec.container を使用して JVM オプションを設定します。

2. Infinispan CR を適用します。

   クラスターが実行されている場合には、Data Grid Operator は Data Grid Pod を再起動して変更を有効にします。

手順

1. Infinispan CR の spec.container フィールドで JVM オプションを設定します。

   spec:
     container:
       extraJvmOpts: "-Dcom.redhat.fips=false"
       cliExtraJvmOpts: "-Dcom.redhat.fips=false"
       routerExtraJvmOpts: "-Dcom.redhat.fips=false"

2. Infinispan CR を適用します。

手順

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. spec.service.type: Cache を設定し、他のキャッシュサービスリソースを設定する Infinispan CR を作成します。

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

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

手順

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

2. ラベルとアノテーションを metadata.annotations セクションの Data Grid リソースに添付します。

   • アノテーションの値を metadata.annotations セクションで直接定義します。
   • metadata.labels フィールドを使用してラベルの値を定義します。
3. 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: Secret
           certSecretName: tls-secret
           clientCert: Validate
           clientCertSecretName: 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: 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: 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 フィールドで公開されるネットワークポートを指定します。

   spec:
     expose:
       type: LoadBalancer
       port: 65535

4. 変更を適用します。

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

   oc get services | grep external

手順

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

手順

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

手順

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

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: infinispan
     spec:
       replicas: 3
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
               port: 65535
             maxRelayNodes: 1
           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: infinispan
     spec:
       replicas: 2
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
               port: 65535
             maxRelayNodes: 1
           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

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

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

   1. Infinispan CR を取得します。

      oc get infinispan -o yaml

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

手順

1. クロスサイト暗号化シークレットを作成します。

   1. キーストアシークレットを作成します。
   2. デフォルトの Java トラストストアを使用しない場合は、トラストストアのシークレットを作成します。
2. 各 Data Grid クラスターの Infinispan CR を変更し、encryption.transportKeyStore.secretName および encryption.routerKeyStore.secretName フィールドのシークレット名を指定します。

3. 必要に応じて RELAY メッセージを暗号化するように他のフィールドを設定して変更を適用します。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: infinispan
   spec:
     replicas: 2
     expose:
       type: LoadBalancer
     service:
       type: DataGrid
       sites:
         local:
           name: SiteA
           # ...
           encryption:
             protocol: TLSv1.3
             transportKeyStore:
               secretName: transport-tls-secret
               alias: transport
               filename: keystore.p12
             routerKeyStore:
               secretName: router-tls-secret
               alias: router
               filename: keystore.p12
             trustStore:
               secretName: truststore-tls-secret
               filename: truststore.p12
         locations:
           # ...

手順

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
           maxRelayNodes: 1
         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. 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

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

手順

1. metadata.name フィールドに一意の値を使用して Cache CR を作成します。
2. ターゲット Data Grid クラスターを spec.clusterName フィールドで指定します。

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

   注記

   キャッシュ設定の name 属性は有効になりません。spec.name フィールドで名前を指定しない場合、キャッシュは metadata.name フィールドの値を使用します。

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

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

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

手順

1. Batch CR を作成します。

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

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

      apiVersion: infinispan.org/v2alpha1
      kind: Batch
      metadata:
        name: mybatch
      spec:
        cluster: 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: 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.3
         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: 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: 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. infinispan shell コマンドを実行して、Data Grid クラスターに接続します。

   oc infinispan shell <cluster_name>

   注記

   認証シークレットにアクセスでき、Data Grid ユーザーが 1 つしかない場合には、kubectl-infinispan プラグインは認証情報を自動的に検出して Data Grid に対して認証します。デプロイメントに複数の Data Grid 認証情報がある場合は、--username 引数を使用してユーザーを指定し、プロンプトが表示されたら、対応するパスワードを入力します。

2. 必要に応じて CLI 操作を実行します。

   ヒント

   Tab キーを押すか、--help 引数を使用して、利用可能なオプションとヘルプテキストを表示します。

3. quit コマンドを使用して、リモートシェルセッションを終了します。