在 OpenShift 上运行 Data Grid

流程

1. 登录 OpenShift Web 控制台。
2. 导航到 OperatorHub。
3. 查找并选择 Data Grid Operator。
4. 选择 Install and continue to Create Operator Subscription。

5. 指定订阅的选项。

   安装模式

   您可以将 Data Grid Operator 安装到 特定命名空间 或 所有命名空间中。

   更新频道

   获取 Data Grid Operator 8.1.x 的更新。

   批准策略

   自动安装来自 8.1.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

      Copy to Clipboard Toggle word wrap

      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

   Copy to Clipboard Toggle word wrap

   控制特定 Data Grid 集群

   $ oc apply -f - << EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
    name: datagrid
    namespace: ${INSTALL_NAMESPACE}
   spec:
    targetNamespaces:
    - ${WATCH_NAMESPACE}
   EOF

   Copy to Clipboard Toggle word wrap

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.1.x
    installPlanApproval: Automatic 

   1

   
    name: datagrid
    source: redhat-operators
    sourceNamespace: openshift-marketplace
   EOF

   Copy to Clipboard Toggle word wrap

   1

   如果要从 8.1.x 频道手动批准更新，请指定 Manual。

4. 验证安装。

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

   Copy to Clipboard Toggle word wrap

流程

1. 在 Infinispan CR 中指定集群中带有 spec.replicas 的 Data Grid 节点数量。

   例如，创建一个 cr_minimal.yaml 文件，如下所示：

   $ cat > cr_minimal.yaml<<EOF
   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     name: example-infinispan
   spec:
     replicas: 2
   EOF

   Copy to Clipboard Toggle word wrap

2. 应用 Infinispan CR。

   $ oc apply -f cr_minimal.yaml

   Copy to Clipboard Toggle word wrap

3. 观察 Data Grid Operator 创建 Data Grid 节点。

   $ 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

   Copy to Clipboard Toggle word wrap

流程

1. 创建 Infinispan CR。

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

   1

   Copy to Clipboard Toggle word wrap

   1

   创建节点缓存服务节点。这是 Infinispan CR 的默认设置。

2. 应用 Infinispan CR 以创建集群。

流程

1. 在 Infinispan CR 中指定 DataGrid 作为 spec.service.type 的值。

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

   Copy to Clipboard Toggle word wrap
   注意

   您无法在创建节点后更改 spec.service.type 字段。要更改服务类型，您必须删除现有节点并创建新节点。

2. 使用任何其他 Data Grid 服务资源配置节点。
3. 应用 Infinispan CR 以创建集群。

流程

1. 打开 Infinispan CR 进行编辑。
2. 添加您想要 Data Grid Operator 的任何标签，以附加到带有 metadata.annotations 的资源。

3. 使用 metadata.labels 为您的标签添加值。

   apiVersion: infinispan.org/v1
   kind: Infinispan
   metadata:
     annotations:
       # Add labels that you want to attach to services.
       infinispan.org/targetLabels: svc-label1, svc-label2
       # Add labels that you want to attach to pods.
       infinispan.org/podTargetLabels: pod-label1, pod-label2
     labels:
       # Add values for your 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

   Copy to Clipboard Toggle word wrap
4. 应用 Infinispan CR。

流程

1. 在 Infinispan CR 中包含 spec.expose。

2. 使用 spec.expose.type 将 LoadBalancer 指定为服务类型。

   spec:
     ...
     expose:
       type: LoadBalancer 

   1

   
       nodePort: 30000 

   2

   Copy to Clipboard Toggle word wrap

   1

   通过端口 11222 上的负载均衡器服务公开网络上的 Data Grid。

   2

   （可选）定义负载均衡器服务将流量转发到的节点端口。

3. 应用更改。

4. 验证 -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

   Copy to Clipboard Toggle word wrap

流程

1. 在 Infinispan CR 中包含 spec.expose。

2. 使用 spec.expose.type 将 NodePort 指定为服务类型。

   spec:
     ...
     expose:
       type: NodePort 

   1

   
       nodePort: 30000 

   2

   Copy to Clipboard Toggle word wrap

   1

   通过节点端口服务在网络上公开数据网格。

   2

   定义 Data Grid 被公开的端口。如果您没有定义端口，则平台会选择一个端口。

3. 应用更改。

4. 验证 -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

   Copy to Clipboard Toggle word wrap

流程

1. 在 Infinispan CR 中包含 spec.expose。
2. 使用 spec.expose.type 将 Route 指定为服务类型。

3. （可选）使用 spec.expose.host 添加主机名。

   spec:
     ...
     expose:
       type: Route 

   1

   
       host: www.example.org 

   2

   Copy to Clipboard Toggle word wrap

   1

   通过 OpenShift 路由在网络上公开数据网格。

   2

   （可选）指定公开 Data Grid 的主机名。

4. 应用更改。

5. 验证路由是否可用。

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

   Copy to Clipboard Toggle word wrap

流程

1. 登录 OpenShift 集群。

2. 创建一个服务帐户。

   例如，在 LON 创建服务帐户：

   $ oc create sa lon
   serviceaccount/lon created

   Copy to Clipboard Toggle word wrap

3. 使用以下命令在服务帐户中添加 view 角色：

   $ oc policy add-role-to-user view system:serviceaccount:<namespace>:lon

   Copy to Clipboard Toggle word wrap
4. 在其他 OpenShift 集群上重复上述步骤。

流程

1. 登录 OpenShift 集群。

2. 使用以下命令为备份位置添加服务帐户令牌：

   $ oc create secret generic <token-name> --from-literal=token=<token>

   Copy to Clipboard Toggle word wrap

   例如，登录到 NYC 的 OpenShift 集群，并创建一个 lon-token secret，如下所示：

   $ oc create secret generic lon-token --from-literal=token=eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9...

   Copy to Clipboard Toggle word wrap
3. 在其他 OpenShift 集群上重复上述步骤。

流程

1. 为每个 Data Grid 集群创建一个 Infinispan CR。
2. 使用 metadata.name 为每个 Data Grid 集群指定匹配名称。
3. 使用 spec.service.sites.local.name 指定本地站点的名称。
4. 使用 spec.service.sites.local.expose.type 设置本地站点的 expose 服务类型。

5. 为每个 Data Grid 集群提供名称、URL 和 secret，它们充当 spec.service.sites.locations 的备份位置。

   以下是 LON 和 NYC 的 Infinispan CR 定义示例：

   • LON

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 3
       service:
         type: DataGrid
         sites:
           local:
             name: LON
             expose:
               type: LoadBalancer
           locations:
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token

     Copy to Clipboard Toggle word wrap

   • NYC

     apiVersion: infinispan.org/v1
     kind: Infinispan
     metadata:
       name: example-infinispan
     spec:
       replicas: 2
       service:
         type: DataGrid
         sites:
           local:
             name: NYC
             expose:
               type: LoadBalancer
           locations:
             - name: NYC
               url: openshift://api.rhdg-nyc.openshift-aws.myhost.com:6443
               secretName: nyc-token
             - name: LON
               url: openshift://api.rhdg-lon.openshift-aws.myhost.com:6443
               secretName: lon-token

     Copy to Clipboard Toggle word wrap

6. 为跨站点复制调整日志记录级别，如下所示：

   ...
     logging:
       categories:
         org.jgroups.protocols.TCP: error
         org.jgroups.protocols.relay.RELAY2: fatal

   Copy to Clipboard Toggle word wrap

   上述配置减少了 JGroups TCP 和 RELAY2 协议的日志，以减少有关集群备份操作的大量消息，这可能会导致大量使用容器存储的日志文件。

7. 使用任何其他 Data Grid 服务资源配置节点。
8. 应用 Infinispan CR。

9. 检查节点日志以验证 Data Grid 集群是否形成跨站点视图，例如：

   $ oc logs example-infinispan-0 | grep x-site
   
   INFO  [org.infinispan.XSITE] (jgroups-5,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC]
   INFO  [org.infinispan.XSITE] (jgroups-7,example-infinispan-0-<id>) ISPN000439: Received new x-site view: [NYC, LON]

   Copy to Clipboard Toggle word wrap

流程

1. 定义 Secret 对象类型，它提供在 StringData 映射中用于访问 Data Grid 服务集群的有效用户凭证。

   例如，创建一个 basic-auth.yaml 文件，它为 developer 用户提供凭证，如下所示：

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: G8ZdJvSaY3lOOwfM 

   2

   
   kind: Secret
   metadata:
     name: basic-auth 

   3

   
   type: Opaque

   Copy to Clipboard Toggle word wrap

   1

   命名可以创建缓存的用户。

   2

   指定与用户对应的密码。

   3

   指定 secret 的名称。

2. 从文件创建 secret，如下例所示：

   $ oc apply -f basic-auth.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个包含您要创建的 XML 缓存定义的 Cache CR。

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     template: <infinispan><cache-container><distributed-cache name="mycache" mode="SYNC"><persistence><file-store/></persistence></distributed-cache></cache-container></infinispan> 

   5

   Copy to Clipboard Toggle word wrap

   1

   为 Cache CR 命名。

   2

   指定为凭证提供用户名和密码 密钥或 自定义凭证 secret 覆盖的 secret。

   3

   指定您希望 Data Grid Operator 创建缓存的目标 Data Grid 集群名称。

   4

   在 Data Grid 集群中命名缓存。

   5

   指定用于创建缓存的 XML 缓存定义。请注意，name 属性将被忽略。只有 spec.name 适用于生成的缓存。

2. 应用 Cache CR，例如：

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

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 Cache CR，用于指定您要使用的模板的名称。

   例如，以下 CR 创建名为"mycache"的缓存，它使用 org.infinispan.DIST_SYNC 缓存配置模板：

   apiVersion: infinispan.org/v2alpha1
   kind: Cache
   metadata:
     name: mycachedefinition 

   1

   
   spec:
     adminAuth: 

   2

   
       secretName: basic-auth
     clusterName: example-infinispan 

   3

   
     name: mycache 

   4

   
     templateName: org.infinispan.DIST_SYNC 

   5

   Copy to Clipboard Toggle word wrap

   1

   为 Cache CR 命名。

   2

   指定为凭证提供用户名和密码 密钥或 自定义凭证 secret 覆盖的 secret。

   3

   指定您希望 Data Grid Operator 创建缓存的目标 Data Grid 集群名称。

   4

   将 Data Grid 缓存命名为 instance。

   5

   指定用于创建缓存的 infinispan.org 缓存配置模板。

2. 应用 Cache CR，例如：

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

   Copy to Clipboard Toggle word wrap

流程

1. 为每个站点创建具有相同名称的缓存配置。

   每个站点的缓存配置可以使用不同的缓存模式和备份策略。Data Grid 基于缓存名称复制数据。

2. 配置备份位置，以使用 take-offline 元素自动离线。

   1. 在备份位置使用 min-wait 属性离线前设置时间（以毫秒为单位）。
3. 定义任何其他有效的缓存配置。

4. 将备份位置添加到全局集群中所有站点的指定缓存中。

   例如，如果您将 LON 添加为 NYC 的备份，您应该将 NYC 添加为 LON 的备份。

流程

1. 从位于 $SERVICE_HOSTNAME 的任何浏览器访问控制台：$PORT.

   将 $SERVICE_HOSTNAME:$PORT 替换为在网络上提供 Data Grid 的主机名和端口。

2. 出现提示时，输入您的 Data Grid 凭证。

流程

1. 创建包含 Data Grid 凭证的身份验证 secret，以便 Prometheus 能够与您的 Data Grid 集群进行身份验证。

   apiVersion: v1
   stringData:
     username: developer 

   1

   
     password: dIRs5cAAsHIeeRIL 

   2

   
   kind: Secret
   metadata:
     name: basic-auth
   type: Opaque

   Copy to Clipboard Toggle word wrap

   1

   指定应用程序用户。developer 是默认值。

   2

   指定对应的密码。

2. 将身份验证 secret 添加到 Prometheus 命名空间中。

   $ oc apply -f basic-auth.yaml

   Copy to Clipboard Toggle word wrap

3. 创建服务监控器，将 Prometheus 配置为监控您的 Data Grid 集群。

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       k8s-app: prometheus
     name: datagrid-monitoring 

   1

   
     namespace: infinispan-monitoring 

   2

   
   spec:
     endpoints:
       - targetPort: 11222 

   3

   
         path: /metrics 

   4

   
         honorLabels: true
         basicAuth:
           username:
             key: username
             name: basic-auth 

   5

   
           password:
             key: password
             name: basic-auth
         interval: 30s
         scrapeTimeout: 10s
         scheme: https 

   6

   
         tlsConfig:
           insecureSkipVerify: true
           serverName: example-infinispan 

   7

   
     namespaceSelector:
       matchNames:
         - infinispan 

   8

   
     selector:
       matchLabels:
         app: infinispan-service
         clusterName: example-infinispan 

   9

   Copy to Clipboard Toggle word wrap

   1

   将服务命名为 monitor 实例。

   2

   指定 Prometheus 堆栈的命名空间。

   3

   为 Data Grid 指标端点设置 11222 端口。

   4

   设置 Data Grid 公开指标的路径。

   5

   使用 Data Grid 凭证指定身份验证 secret。

   6

   指定 Data Grid 集群使用端点加密。

   7

   为 Data Grid 加密指定 TLS 证书的通用名称(CN)。如果使用 OpenShift 服务证书，CN 与 Data Grid 集群的 metadata.name 资源匹配。

   8

   指定 Data Grid 集群的命名空间。

   9

   指定 Data Grid 集群名称。

4. 将服务监控实例添加到 Prometheus 命名空间中。

   $ oc apply -f service-monitor.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 将 spec.affinity 块添加到 Infinispan CR。
2. 根据需要配置反关联性策略。
3. 应用 Infinispan CR。

流程

1. 在 Infinispan CR 中使用 spec.logging 指定日志记录配置，然后应用更改。

   spec:
     ...
     logging: 

   1

   
       categories: 

   2

   
         org.infinispan: debug 

   3

   
         org.jgroups: debug

   Copy to Clipboard Toggle word wrap

   1

   配置数据网格日志记录。

   2

   添加日志记录类别。

   3

   命名日志记录类别和级别。

   注意

   root 日志记录类别是 org.infinispan，默认为 INFO。

2. 根据需要，从 Data Grid 节点检索日志。

   $ oc logs -f $POD_NAME

   Copy to Clipboard Toggle word wrap