Helm を使用した Data Grid クラスターのビルドおよびデプロイ

手順

1. OpenShift Web コンソールにログインします。
2. Developer パースペクティブを選択します。
3. Add ビューを開き、Helm Chart を選択して Red Hat 開発者カタログを参照します。
4. Data Grid チャートを探し、選択します。
5. チャートの名前を指定し、バージョンを選択します。

6. Data Grid チャートの以下のセクションで値を定義します。

   • Images は、Data Grid クラスターの Pod を作成する際に使用するコンテナーイメージを設定します。

   • Deploy は Data Grid クラスターを設定します。

     ヒント

     各値の説明を見つけるには、YAML ビュー オプションを選択し、スキーマにアクセスします。yaml 設定を編集して、Data Grid チャートをカスタマイズします。

7. Install を選択します。

検証

1. Developer パースペクティブで Helm ビューを選択します。
2. 作成した Helm リリースを選択して、詳細、リソース、およびその他の情報を表示します。

手順

1. Data Grid クラスターを設定する values ファイルを作成します。

   たとえば、以下の values ファイルは、2 つのノードで設定されるクラスターを作成します。

   $ cat > infinispan-values.yaml<<EOF
   #Build configuration
   images:
     server: registry.redhat.io/datagrid/datagrid-8-rhel8:latest
     initContainer: registry.access.redhat.com/ubi8-micro
   #Deployment configuration
   deploy:
     #Add a user with full security authorization.
     security:
       batch: "user create admin -p changeme"
     #Create a cluster with two pods.
     replicas: 2
     #Specify the internal Kubernetes cluster domain.
     clusterDomain: cluster.local
   EOF

   Copy to Clipboard Toggle word wrap

2. Data Grid チャートをインストールし、values ファイルを指定します。

   $ helm install infinispan openshift-helm-charts/redhat-data-grid --values infinispan-values.yaml

   Copy to Clipboard Toggle word wrap

手順

1. 適宜、Data Grid デプロイメントの values ファイルを変更します。

2. helm クライアントを使用して変更を適用します。以下に例を示します。

   $ helm upgrade infinispan openshift-helm-charts/redhat-data-grid --values infinispan-values.yaml

   Copy to Clipboard Toggle word wrap

手順

1. インストールされている Data Grid Helm リリースをリスト表示します。

   $ helm list

   Copy to Clipboard Toggle word wrap

2. helm クライアントを使用してリリースをアンインストールし、Data Grid クラスターを削除します。

   $ helm uninstall <helm_release_name>

   Copy to Clipboard Toggle word wrap

3. oc クライアントを使用して、生成されたシークレットを削除します。

   $ oc delete secret <helm_release_name>-generated-secret

   Copy to Clipboard Toggle word wrap

手順

1. "default" セキュリティーレルムから propertiesRealm フィールドを削除します。
2. Data Grid Helm リリースをインストールまたはアップグレードします。

手順

1. null を deploy.infinispan.cacheContainer.security フィールドの値として設定します。

   ヒント

   helm クライアントで --set deploy.infinispan.cacheContainer.security=null 引数を使用します。

2. Data Grid Helm リリースをインストールまたはアップグレードします。

手順

1. デプロイ設定でシークレット名を設定します。

   キーストアを含むシークレットの名前を指定します。

   deploy:
     ssl:
       endpointSecretName: "tls-secret"
       transportSecretName: "tls-transport-secret"

   Copy to Clipboard Toggle word wrap

2. クラスタートランスポートの TLS を有効にします。

   deploy:
     infinispan:
       cacheContainer:
         transport:
            urn:infinispan:server:15.0:securityRealm: >
             "cluster-transport" 

   1

   
       server:
         security:
           securityRealms:
             - name: cluster-transport
               serverIdentities:
                 ssl:
                   keystore: 

   2

   
                     alias: "server"
                     path: "/etc/encrypt/transport/cert.p12"
                     credentialReference: 

   3

   
                       store: credentials
                       alias: keystore
                   truststore: 

   4

   
                     path: "/etc/encrypt/transport/cert.p12"
                     credentialReference: 

   5

   
                       store: credentials
                       alias: truststore

   Copy to Clipboard Toggle word wrap

   1

   指定のセキュリティーレルムを使用してクラスターの暗号化を提供するようにトランスポートスタックを設定します。

   2

   トランスポートレルムでキーストアパスを設定します。シークレットは /etc/encrypt/transport にマウントされます。

   3 5

   同じキーストアを使用してトラストストアを設定し、ノードが相互に認証できるようにします。

   4

   シークレットにキーストアが含まれている場合は、エイリアスとパスワードを指定する必要があります。

3. エンドポイントの TLS を有効にします。

   deploy:
     infinispan:
       server:
         security:
           securityRealms:
             - name: default
               serverIdentities:
                 ssl:
                   keystore:
                     path: "/etc/encrypt/endpoint/keystore.p12" 

   1

   
                     alias: "server" 

   2

   
                     credentialReference:
                       store: credentials 

   3

   
                       alias: keystore 

   4

   Copy to Clipboard Toggle word wrap

   1

   エンドポイントレルムでキーストアパスを設定します。シークレットは /etc/encrypt/endpoint にマウントされます。

   2

   シークレットにキーストアが含まれている場合は、エイリアスを指定する必要があります。

   3 4

   パスワードはクレデンシャルキーストア経由で提供する必要があります。

手順

1. deploy.expose.type フィールドに、以下のいずれかを指定します。

   Expand

   オプション	説明
   Route	ルートを使用して Data Grid を公開します。これはデフォルト値です。
   LoadBalancer	ロードバランサーサービスを介して Data Grid を公開します。
   NodePort	ノードポートサービスを介して Data Grid を公開します。
   "" (空の値)	ネットワークに Data Grid を公開するのを無効にします。

   Show more
2. ルートを介して Data Grid を公開する場合は、オプションとして deploy.expose.host フィールドでホスト名を指定します。
3. ノードポートサービスを介して Data Grid を公開する場合は、オプションとして deploy.expose.nodePort フィールドでポートを指定します。
4. Data Grid Helm リリースをインストールまたはアップグレードします。

手順

1. -c 引数の値としてネットワークサービスを指定して、Data Grid CLI を起動します。以下に例を示します。

   $ {native_cli} -c http://cluster-name-myroute.hostname.net/

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

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

   ヒント

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

4. quit コマンドを使用して CLI を終了します。

手順

1. クライアント設定で、Data Grid クラスターの内部ネットワークサービスの詳細を指定します。

   以下の設定例では、$SERVICE_HOSTNAME:$PORT は、Data Grid クラスターへのアクセスが許可されるホスト名およびポートを示します。

2. クライアントが Data Grid に対して認証できるように、認証情報を指定します。

3. 必要に応じてクライアントのインテリジェンスを設定します。

   OpenShift 上で実行される Hot Rod クライアントは、Data Grid Pod の内部 IP アドレスにアクセスできるため、任意のクライアントのインテリジェンスを使用できます。
   デフォルトのインテリジェンスである HASH_DISTRIBUTION_AWARE が推奨されます。これにより、クライアントはリクエストをプライマリーオーナーにルーティングできるようになり、パフォーマンスが向上します。

手順

1. クライアント設定で、Data Grid クラスターの内部ネットワークサービスの詳細を指定します。

   以下の設定例では、$SERVICE_HOSTNAME:$PORT は、Data Grid クラスターへのアクセスが許可されるホスト名およびポートを示します。

2. クライアントが Data Grid に対して認証できるように、認証情報を指定します。
3. BASIC インテリジェンスを使用するようにクライアントを設定します。