流程

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 安装到 特定命名空间 或所有 命名空间中。

   更新频道

   获取 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 只控制特定的数据网格集群，请为该集群创建一个项目。

      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

   控制特定的数据网格集群

   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 命令。

   例如，创建一个带有两个 pod 的 Data Grid 集群，如下所示：

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

2. watch Data Grid Operator 创建 Data Grid pod。

   oc get pods -w

流程

1. 创建一个定义 Infinispan CR 的 YAML 文件。

   例如，创建一个 my_infinispan.yaml 文件，该文件将 Data Grid pod 的数量更改为 2：

   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. watch 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. 将 Data Grid 配置添加到 ConfigMap 的 data 字段中的 infinispan-config.[xml|yaml|json] 键。

   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. 确保 Shutdown 设置为 spec.upgrades.type 字段的值，这是默认值。

   spec:
     upgrades:
       type: Shutdown

2. 如有必要，应用您的更改。

流程

1. 将 HotRodRolling 指定为 spec.upgrades.type 字段的值。

   spec:
     upgrades:
       type: HotRodRolling

2. 应用您的更改。

流程

1. 创建一个 Infinispan CR，设置 spec.service.type: DataGrid，并配置任何其他 Data Grid 服务资源。

   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 字段。

   注意

   这些字段是互斥的。仅为您的 Infinispan CR 添加其中之一。

3. 应用更改。

流程

1. 使用 spec.container.cpu 字段分配 CPU 单元数。

2. 使用 spec.container.memory 字段分配内存量（以字节为单位）。

   cpu 和 memory 字段的值格式为 < limit>:<requests>。例如，cpu: "2000m:1000m" 将 pod 限制为 CPU 最多 2000m，并在启动时为每个 pod 请求 1000m 的 CPU。指定单个值可同时设置限制和请求。

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 logging。

   spec:
     logging:
       categories:
         org.infinispan: debug
         org.jgroups: debug

2. 应用更改。

3. 根据需要从 Data Grid pod 检索日志。

   oc logs -f $POD_NAME

流程

1. 创建一个 Infinispan CR，它将设置 spec.service.type: Cache，并配置任何其他缓存服务资源。

   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. 使用您要添加的凭证创建一个 identity .yaml 文件。

   credentials:
   - username: myfirstusername
     password: changeme-one
   - username: mysecondusername
     password: changeme-two

2. 从 identity .yaml 创建身份验证 secret。

   oc create secret generic --from-file=identities.yaml connect-secret

3. 在 Infinispan CR 中指定带有 spec.security.endpointSecretName 的身份验证 secret，然后应用更改。

   spec:
     security:
       endpointSecretName: connect-secret

流程

1. 在 Infinispan CR 中，将 false 设置为 spec.security.endpointAuthentication 字段的值。

   spec:
     security:
       endpointAuthentication: false

2. 应用更改。

流程

1. 在 Infinispan CR 中，将 Validate 或 Authenticate 设置为 spec.security.endpointEncryption.clientCert 字段的值。

   注意

   默认值为 None。

2. 使用 spec.security.endpointEncryption.clientCertSecretName 字段指定包含客户端信任存储的 secret。

   默认情况下，Data Grid Operator 需要一个名为 < cluster-name>-client-cert-secret 的信任存储 secret。

   注意

   该 secret 必须对 OpenShift 集群中的每个 Infinispan CR 实例是唯一的。当您删除 Infinispan CR 时，OpenShift 还自动删除相关的 secret。

   spec:
     security:
       endpointEncryption:
           type: Secret
           certSecretName: tls-secret
           clientCert: Validate
           clientCertSecretName: infinispan-client-cert-secret

3. 应用更改。

流程

1. 将包含客户端信任存储的 secret 名称指定为 metadata.name 字段的值。

   注意

   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. 将包含客户端信任存储的 secret 名称指定为 metadata.name 字段的值。

   注意

   name 必须与 spec.security.endpointEncryption.clientCertSecretName 字段的值匹配。

2. 指定签名证书或 CA 证书捆绑包，作为 data.trust.ca 字段的值。

3. 如果您使用 Authenticate 策略来验证客户端身份，请为可以连接到 Data Grid 端点的每个客户端添加证书，并使用 data.trust.cert.<name> 字段。

   注意

   在生成信任存储时，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 命名空间中添加加密 secret，例如：

   oc apply -f tls_secret.yaml

2. 使用 Infinispan CR 中的 spec.security.endpointEncryption.certSecretName 字段指定加密 secret。

   spec:
     security:
       endpointEncryption:
         type: Secret
         certSecretName: tls-secret

3. 应用更改。

流程

1. 将 true 设置为您在 Infinispan CR 中的 spec.security.authorization.enabled 字段的值。

   spec:
     security:
       authorization:
         enabled: true

2. 应用更改。

流程

1. 创建一个 identity.yaml 文件，为用户分配角色。

   credentials:
     - username: admin
       password: changeme
     - username: my-user-1
       password: changeme
       roles:
         - admin
     - username: my-user-2
       password: changeme
       roles:
         - monitor

2. 从 identity .yaml 创建身份验证 secret。

   如有必要，请先删除现有 secret。

   oc delete secret connect-secret --ignore-not-found
   oc create secret generic --from-file=identities.yaml connect-secret

3. 在 Infinispan CR 中指定带有 spec.security.endpointSecretName 的身份验证 secret，然后应用更改。

   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. 使用 spec.expose.type 字段将 LoadBalancer 指定为服务类型。

3. （可选）指定服务通过 spec.expose.port 字段公开的网络端口。

   spec:
     expose:
       type: LoadBalancer
       port: 65535

4. 应用更改。

5. 验证 -external 服务是否可用。

   oc get services | grep external

流程

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

3. 配置通过 spec.expose.nodePort 字段公开 Data Grid 的端口。

   spec:
     expose:
       type: NodePort
       nodePort: 30000

4. 应用更改。

5. 验证 -external 服务是否可用。

   oc get services | grep external

流程

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

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
      • Route

   2. 另外，还可使用以下字段指定端口或自定义主机名：

      • 如果使用 NodePort 服务，spec.service.sites.local.expose.nodePort。
      • spec.service.sites.local.expose.port （如果使用 LoadBalancer 服务）。
      • 如果使用 OpenShift 路由，spec.service.sites.local.expose.routeHostName。

4. 为每个 Data Grid 集群提供名称和静态 URL，它们充当 spec.service.sites.locations 的备份位置，例如：

   • 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

     重要

     务必调整 Infinispan CR 中的日志类别，以降低 JGroups TCP 和 RELAY2 协议的日志级别。这可防止大量日志文件使用容器存储。

     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. 创建跨站点加密 secret。

   1. 创建密钥存储机密。
   2. 如果您不想使用默认的 Java 信任存储存储，则创建信任存储 secret。
2. 为每个 Data Grid 集群修改 Infinispan CR，以指定 encryption.transportKeyStore.secretName 和 encryption.routerKeyStore.secretName 字段的 secret 名称。

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 指定备份位置的命名空间。

   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 控制台中，选择 &lt ;/> Developer 视角，然后选择 Monitoring。
2. 为您的 Data Grid 集群运行的命名空间打开 Dashboard 标签页。

3. 打开 Metrics 选项卡，并确认您可以查询 Data Grid 指标，例如：

   vendor_cache_manager_default_cluster_size

流程

1. 创建一个 ServiceAccount，使 Grafana 从 Prometheus 读取 Data Grid 指标。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: infinispan-monitoring

   1. 应用 ServiceAccount。

      oc apply -f service-account.yaml

   2. 为 ServiceAccount 授予 cluster-monitoring-view 权限。

      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 命名空间中创建一个名为 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.grafana.dashboard.namespace 属性指定 Data Grid 集群的命名空间。

   注意

   删除此属性的值将删除仪表板。更改该值会将仪表板移到该命名空间。

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，该 UI 位于：

   oc get routes grafana-route -o jsonpath=https://"{.spec.host}"

流程

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

流程

1. 在 metadata.name 字段中创建一个带有唯一值的 Cache CR。
2. 使用 spec.clusterName 字段指定目标 Data Grid 集群。

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. 创建一个 批处理 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. 应用您的 批处理 CR。

   oc apply -f mybatch.yaml

3. 检查 Batch CR 中的 status.Phase 字段，以验证操作成功完成。

流程

1. 创建包含您要运行的所有命令的 批处理 文件。

   例如，以下 批处理 文件创建一个名为"mycache"的缓存，并为其添加两个条目：

   create cache mycache --file=/etc/batch/mycache.xml
   put --cache=mycache hello world
   put --cache=mycache hola mundo

   重要

   ConfigMap 挂载于 /etc/batch 的 Data Grid pod。您必须使用该路径在批处理操作中添加 all --file= 指令。

2. 确保您的批处理操作需要的所有配置工件与 批处理 文件位于同一个目录中。

   ls /tmp/mybatch
   
   batch
   mycache.xml

3. 从目录中创建 ConfigMap。

   oc create configmap mybatch-config-map --from-file=/tmp/mybatch

流程

1. 创建一个 Batch CR，将 Data Grid 集群名称指定为 spec.cluster 字段的值。

2. 使用 spec.configMap 字段设置包含 批处理 文件和配置工件的 ConfigMap 名称。

   cat > mybatch.yaml<<EOF
   apiVersion: infinispan.org/v2alpha1
   kind: Batch
   metadata:
     name: mybatch
   spec:
     cluster: infinispan
     configMap: mybatch-config-map
   EOF

3. 应用您的 批处理 CR。

   oc apply -f mybatch.yaml

4. 检查 Batch CR 中的 status.Phase 字段，以验证操作成功完成。

流程

1. 使用 metadata.name 字段命名 Backup CR。
2. 使用 spec.cluster 字段指定 Data Grid 集群进行备份。

3. 配置持久性卷声明(PVC)，将备份归档添加到带有 spec.volume.storage 和 spec.volume.storage.storageClassName 字段的持久性卷(PV)。

   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. 应用 备份 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 字段的备份 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 集群的命名空间。

   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 命名空间，并等待它就绪。

   oc apply -f datagrid-libs-pod.yaml
   oc wait --for=condition=ready --timeout=2m pod/datagrid-libs-pod

6. 将代码工件复制到 pod，以便它们加载到 PVC 中。

   例如，要从本地 libs 目录中复制代码工件，请执行以下操作：

   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. （可选）指定一个 checksum，使用 spec.dependencies.artifacts.hash 字段验证下载的完整性。

      hash 字段要求值采用 <algorithm>:& lt;checksum&gt; 的格式，其中 & lt;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. 列出 Kafka 服务器，其中 Data Grid 使用 spec.cloudEvents.bootstrapServers 字段将事件发送到。

   3. 使用 spec.cloudEvents.cacheEntriesTopic 字段指定 Data Grid 事件的 Kafka 主题。

      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>

   注意

   如果您可以访问身份验证 secret，且只有一个 Data Grid 用户，kubectl-infinispan 插件会自动检测到您的凭证并对 Data Grid 进行身份验证。如果您的部署有多个 Data Grid 凭证，请使用 --username 参数指定用户，并在提示时输入对应的密码。

2. 根据需要执行 CLI 操作。

   提示

   按 Tab 键或使用 --help 参数查看可用选项和帮助文本。

3. 使用 quit 命令结束远程 shell 会话。