Chapter 4. Creating Data Grid clusters

4.1. Infinispan custom resource (CR)
링크 복사

Data Grid Operator adds a new Custom Resource (CR) of type Infinispan that lets you handle Data Grid clusters as complex units on OpenShift.

Data Grid Operator listens for Infinispan Custom Resources (CR) that you use to instantiate and configure Data Grid clusters and manage OpenShift resources, such as StatefulSets and Services.

Infinispan CR

apiVersion: infinispan.org/v1
kind: Infinispan
metadata:
  name: infinispan
spec:
  replicas: 2
  version: <Data Grid_version>
  service:
    type: DataGrid

apiVersion: infinispan.org/v1
kind: Infinispan
metadata:
  name: infinispan
spec:
  replicas: 2
  version: <Data Grid_version>
  service:
    type: DataGrid

Copy to Clipboard

Toggle word wrap

Expand

Field	Description
`apiVersion`	Declares the version of the `Infinispan` API.
`kind`	Declares the `Infinispan` CR.
`metadata.name`	Specifies a name for your Data Grid cluster.
`spec.replicas`	Specifies the number of pods in your Data Grid cluster.
`spec.service.type`	Specifies the type of Data Grid service to create.
`spec.version`	Specifies the Data Grid Server version of your cluster.

4.2. Creating Data Grid clusters
링크 복사

Create Data Grid clusters with the native CLI plugin, kubectl-infinispan.

Prerequisites

Install Data Grid Operator.
Have kubectl-infinispan on your PATH.

Procedure

Run the infinispan create cluster command.
For example, create a Data Grid cluster with two pods as follows:
```
oc infinispan create cluster --replicas=3 -Pservice.type=DataGrid infinispan
```
```
oc infinispan create cluster --replicas=3 -Pservice.type=DataGrid infinispan
```
Copy to Clipboard Toggle word wrap
Tip
Add the --version argument to control the Data Grid version of your cluster. For example, --version=8.4.6-1. If you don’t specify the version, Data Grid Operator creates cluster with the latest supported Data Grid version.
Watch Data Grid Operator create the Data Grid pods.
```
oc get pods -w
```
```
oc get pods -w
```
Copy to Clipboard Toggle word wrap

Next steps

After you create a Data Grid cluster, use the oc to apply changes to Infinispan CR and configure your Data Grid service.

You can also delete Data Grid clusters with kubectl-infinispan and re-create them as required.

oc infinispan delete cluster infinispan

oc infinispan delete cluster infinispan

Copy to Clipboard

Toggle word wrap

Additional resources

kubectl-infinispan command reference

4.3. Verifying Data Grid cluster views
링크 복사

Confirm that Data Grid pods have successfully formed clusters.

Prerequisites

Create at least one Data Grid cluster.

Procedure

Retrieve the Infinispan CR for Data Grid Operator.
```
oc get infinispan -o yaml
```
```
oc get infinispan -o yaml
```
Copy to Clipboard Toggle word wrap
The response indicates that Data Grid pods have received clustered views, as in the following example:
```
conditions:
  - message: 'View: [infinispan-0, infinispan-1]'
    status: "True"
    type: wellFormed
```
```
conditions:
  - message: 'View: [infinispan-0, infinispan-1]'
    status: "True"
    type: wellFormed
```
Copy to Clipboard Toggle word wrap

Tip

Do the following for automated scripts:

oc wait --for condition=wellFormed --timeout=240s infinispan/infinispan

oc wait --for condition=wellFormed --timeout=240s infinispan/infinispan

Copy to Clipboard

Toggle word wrap

Retrieving cluster view from logs

You can also get the cluster view from Data Grid logs as follows:

oc logs infinispan-0 | grep ISPN000094

oc logs infinispan-0 | grep ISPN000094

Copy to Clipboard

Toggle word wrap

INFO  [org.infinispan.CLUSTER] (MSC service thread 1-2) \
ISPN000094: Received new cluster view for channel infinispan: \
[infinispan-0|0] (1) [infinispan-0]

INFO  [org.infinispan.CLUSTER] (jgroups-3,infinispan-0) \
ISPN000094: Received new cluster view for channel infinispan: \
[infinispan-0|1] (2) [infinispan-0, infinispan-1]

INFO  [org.infinispan.CLUSTER] (MSC service thread 1-2) \
ISPN000094: Received new cluster view for channel infinispan: \
[infinispan-0|0] (1) [infinispan-0]

INFO  [org.infinispan.CLUSTER] (jgroups-3,infinispan-0) \
ISPN000094: Received new cluster view for channel infinispan: \
[infinispan-0|1] (2) [infinispan-0, infinispan-1]

Copy to Clipboard

Toggle word wrap

4.4. Modifying Data Grid clusters
링크 복사

Configure Data Grid clusters by providing Data Grid Operator with a custom Infinispan CR.

Prerequisites

Install Data Grid Operator.
Create at least one Data Grid cluster.
Have an oc client.

Procedure

Create a YAML file that defines your Infinispan CR.

For example, create a my_infinispan.yaml file that changes the number of Data Grid pods to two:

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

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

Copy to Clipboard

Toggle word wrap

Apply your Infinispan CR.
```
oc apply -f my_infinispan.yaml
```
```
oc apply -f my_infinispan.yaml
```
Copy to Clipboard Toggle word wrap
Watch Data Grid Operator scale the Data Grid pods.
```
oc get pods -w
```
```
oc get pods -w
```
Copy to Clipboard Toggle word wrap

4.5. Stopping and starting Data Grid clusters
링크 복사

Stop and start Data Grid pods in a graceful, ordered fashion to correctly preserve cluster state.

Clusters of Data Grid service pods must restart with the same number of pods that existed before shutdown. This allows Data Grid to restore the distribution of data across the cluster. After Data Grid Operator fully restarts the cluster you can safely add and remove pods.

Procedure

Change the spec.replicas field to 0 to stop the Data Grid cluster.
```
spec:
  replicas: 0
```
```
spec:
  replicas: 0
```
Copy to Clipboard Toggle word wrap

Ensure you have the correct number of pods before you restart the cluster.

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

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

Copy to Clipboard

Toggle word wrap

Change the spec.replicas field to the same number of pods to restart the Data Grid cluster.
```
spec:
  replicas: 6
```
```
spec:
  replicas: 6
```
Copy to Clipboard Toggle word wrap

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

4.1. Infinispan custom resource (CR)
링크 복사

4.2. Creating Data Grid clusters
링크 복사

4.3. Verifying Data Grid cluster views
링크 복사

Retrieving cluster view from logs

4.4. Modifying Data Grid clusters
링크 복사

4.5. Stopping and starting Data Grid clusters
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 4. Creating Data Grid clusters

4.1. Infinispan custom resource (CR)링크 복사링크가 클립보드에 복사되었습니다!

4.2. Creating Data Grid clusters링크 복사링크가 클립보드에 복사되었습니다!

4.3. Verifying Data Grid cluster views링크 복사링크가 클립보드에 복사되었습니다!

Retrieving cluster view from logs

4.4. Modifying Data Grid clusters링크 복사링크가 클립보드에 복사되었습니다!

4.5. Stopping and starting Data Grid clusters링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4.1. Infinispan custom resource (CR)
링크 복사

4.2. Creating Data Grid clusters
링크 복사

4.3. Verifying Data Grid cluster views
링크 복사

4.4. Modifying Data Grid clusters
링크 복사

4.5. Stopping and starting Data Grid clusters
링크 복사