Getting Started with Data Grid Operator

Red Hat Data Grid 8.0

Data Grid Documentation

Red Hat Customer Content Services

Abstract

Install the Data Grid Operator into Red Hat OpenShift namespaces to run Data Grid for OpenShift clusters.

1. Data Grid Operator

Data Grid Operator, available from the Operator Hub on Red Hat OpenShift, simplifies the process of creating and managing Data Grid clusters on OpenShift.

Data Grid Operator watches for the Infinispan Custom Resources (CR) that you use to instantiate and configure Data Grid clusters and manage OpenShift resources, such as StatefulSets and Services. In this way, the Infinispan CR is your primary interface to Data Grid on OpenShift.

Red Hat OpenShift Operators

The OpenShift Operators Tech Topic and the Operators topic in the CoreOS documentation are good resources for finding out about Operators.

If you’re new to OpenShift, try some quick exercises in the Interactive Learning Portal.

2. Creating Data Grid Operator Subscriptions

Install Data Grid Operator into OpenShift projects from the Operator Hub.

Prerequisites

  • Have administrator access to an OpenShift cluster.
  • Create a namespace for Data Grid Operator.

Installing Data Grid Operator

Navigate to the OperatorHub in the OpenShift Web Console and locate Data Grid Operator.

Install Operator

Set options for your Data Grid Operator subscription.

Installation ModeDescription

All namespaces

Install Data Grid Operator in all projects across the OpenShift cluster. This installation mode is not currently supported.

A specific namespace

Install Data Grid Operator into a specific OpenShift project.

Update ChannelDescription

8.0.x

Receive updates for Data Grid for OpenShift 8.0.x images.

Approval StrategiesDescription

Manual

You control when Data Grid Operator updates take place.

Automatic

Data Grid Operator updates when it detects new versions are available.

Note

Data Grid for OpenShift images updates apply to Data Grid Operator first and then for each Data Grid node. Data Grid Operator updates clusters one node at a time, gracefully shutting down each node and then bringing it back online with the updated version before going on to the next node.

Creating Data Grid Clusters

Navigate to Installed Operators in the namespace where you installed Data Grid Operator.

You can create Data Grid clusters from:

  • Overview tab, select Create Instance.
  • Infinispan cluster tab, select Create Infinispan.
Create Infinispan

Data Grid Operator creates a minimal Infinispan CR with new cluster instances:

apiVersion: infinispan.org/v1 1
kind: Infinispan 2
metadata:
  name: example-infinispan 3
  namespace: rhdg-helloworld 4
spec:
  replicas: 2 5
1
declares the Infinispan API version.
2
declares the Infinispan CR.
3
names your Data Grid cluster.
4
sets the OpenShift namespace.
5
specifies the number of nodes in the cluster.

Applying the minimal Infinispan CR creates a cluster of two Cache service nodes that provide a volatile, low-latency data store with a default configuration.

Data Grid Operator lets you configure Data Grid cluster properties such as:

  • Number of nodes.
  • Whether clusters act as a Cache service or Data Grid service.
  • Authentication credentials.
  • Encryption for network traffic between nodes and clients.

When you instantiate a Data Grid cluster instance, Data Grid Operator brings the nodes up. When the nodes are running, navigate back to the Infinispan tab to access the Infinispan CR and view available resources like authentication secrets and services.

Cluster Resources

Next Steps

Find information about Data Grid CRDs and configuration options, see Running Data Grid on OpenShift.

Legal Notice

Copyright © 2020 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.