Red Hat Data Grid for OpenShift

1. 选择 Docker Login 选项卡，再复制该命令。
2. 在从 registry.redhat.io 的每个主机上运行 docker login 命令。

3. 验证您的 Docker 配置。

   $ cat ~/.docker/config.json
   ...
   "registry.redhat.io": {
   			"auth": "MTEwMDkx..."
   		}

   Copy to Clipboard Toggle word wrap

1. 登录您的 OpenShift 集群。

2. 选择您的项目，例如：

   $ oc project rhdg-helloworld

   Copy to Clipboard Toggle word wrap

3. 使用您的 Docker 配置创建通用 pull secret。

   $ oc create secret generic ${SECRET_NAME} \
     --from-file=.dockerconfigjson=path/to/.docker/config.json \
     --type=kubernetes.io/dockerconfigjson

   Copy to Clipboard Toggle word wrap

4. 将 pull secret 链接到您的服务帐户。

   $ oc secrets link default ${SECRET_NAME} --for=pull

   Copy to Clipboard Toggle word wrap

5. 挂载 secret。

   $ oc secrets link builder ${SECRET_NAME}

   Copy to Clipboard Toggle word wrap

流程

1. 从 Data Grid pod 获取 service-ca.crt。

   $ oc rsync ${pod_name}:/var/run/secrets/kubernetes.io/serviceaccount/..data/service-ca.crt .

   Copy to Clipboard Toggle word wrap

2. 在调用 REST 调用时传递 service-ca.crt。

   curl -X PUT \
     -u ${USERNAME}:${PASSWORD} \
     --cacert service-ca.crt \
     -H 'Content-type: text/plain' \
     -d 'world' \
     https://${HOSTNAME_FOR_HTTPS_ROUTE}/rest/default/hello

   Copy to Clipboard Toggle word wrap

1. 将 openshift.DNS_PING 设置为 JGROUPS_PING_PROTOCOL 环境变量的值。

   JGROUPS_PING_PROTOCOL=openshift.DNS_PING

   Copy to Clipboard Toggle word wrap

2. 指定集群的 ping 服务名称，作为 OPENSHIFT_DNS_PING_SERVICE_NAME 环境变量的值。

   OPENSHIFT_DNS_PING_SERVICE_NAME=${PING_SERVICE_NAME}

   Copy to Clipboard Toggle word wrap

3. 指定公开 ping 服务的端口号，作为 OPENSHIFT_DNS_PING_SERVICE_PORT 环境变量的值。默认值为 8888。

   OPENSHIFT_DNS_PING_SERVICE_PORT=${PING_SERVICE_NAME}

   Copy to Clipboard Toggle word wrap

4. 定义公开 ping 端口的 ping 服务，如下例所示：

   apiVersion: v1
   kind: Service
   spec:
     clusterIP: None
     ports:
       - name: ping
         port: 8888
         protocol: TCP
         targetPort: 8888
     selector: deploymentConfig=datagrid-service
   metadata:
     annotations:
       description: The JGroups ping port for clustering.
       service.alpha.kubernetes.io/tolerate-unready-endpoints: 'true'

   Copy to Clipboard Toggle word wrap
   重要

   您应该配置 clusterIP: None，以便服务处于无头状态。同样，ping 端口必须被命名并包含 service.alpha.kubernetes.io/tolerate-unready-endpoints: 'true' 注解。

1. 将 openshift.KUBE_PING 设置为 JGROUPS_PING_PROTOCOL 环境变量的值。

   JGROUPS_PING_PROTOCOL=openshift.KUBE_PING

   Copy to Clipboard Toggle word wrap

2. 将 OpenShift 项目名称指定为 OPENSHIFT_KUBE_PING_NAMESPACE 环境变量的值。如果没有设置此变量，服务器的行为与单节点集群类似。

   OPENSHIFT_KUBE_PING_NAMESPACE=${PING_NAMESPACE}

   Copy to Clipboard Toggle word wrap

3. 使用 OPENSHIFT_KUBE_PING_LABELS 环境变量指定集群标签。如果没有设置此变量，则应用程序以外的 pod 会尝试加入同一命名空间。

   OPENSHIFT_KUBE_PING_LABELS=labelKey=labelValue

   Copy to Clipboard Toggle word wrap

4. 为 pod 运行的服务帐户授予授权，以便它能够访问 Kubernetes REST API。例如，为 datagrid-service-account 授予授权，如下所示：

   oc policy add-role-to-user view \
     system:serviceaccount:$(oc project -q):datagrid-service-account \
     -n $(oc project -q)

   Copy to Clipboard Toggle word wrap

5. 确保 8888 定义为 pod 容器上的 ping 端口，如下所示：

   ports:
       - containerPort: 8888
         name: ping
         protocol: TCP

   Copy to Clipboard Toggle word wrap

1. 创建一个Groups 密钥存储(.jceks)，其中包含用于加密流量的凭据。

   您可以使用 Java keytool 生成 JGroups 密钥存储。

2. 将 JGroups 密钥存储作为机密部署到 OpenShift。

   1. 登录您的 OpenShift 集群。

   2. 为 JGroups 密钥存储创建机密。例如，若要从名为 jgroups.jceks 的密钥存储创建名为 jgroups-secret 的 secret，请执行以下操作：

      $ oc create secret generic jgroups-secret \
        --from-file=jgroups.jceks

      Copy to Clipboard Toggle word wrap

   3. 将 secret 链接到 default 服务帐户。

      $ oc secrets link default jgroups-secret

      Copy to Clipboard Toggle word wrap

   4. 将 secret 挂载到容器。

      $ oc set volumes dc/datagrid \
        --add -t secret \
        --secret-name='jgroups-secret' \
        --mount-path='/keystores/jgroups'

      Copy to Clipboard Toggle word wrap
3. 将集群中每个节点的 JGROUPS_ENCRYPT_PROTOCOL 环境变量设置为 SYM_ENCRYPT。

4. 配置集群中的每个节点，使其使用具有以下环境变量的 JGroups 密钥存储：

   JGROUPS_ENCRYPT_KEYSTORE

   Specifes the JGroups 密钥存储用于加密集群流量。

   JGROUPS_ENCRYPT_KEYSTORE_DIR

   指定 JGroups 密钥存储所在的目录。

   JGROUPS_ENCRYPT_SECRET

   匹配密钥存储的 OpenShift 机密。

   JGROUPS_ENCRYPT_NAME

   匹配密钥存储的用户名。

   JGROUPS_ENCRYPT_PASSWORD

   匹配密钥存储密码。

5. 如果需要，在使用 JGROUPS_CLUSTER_PASSWORD 环境变量加入集群时，为节点设置密码。

1. 使用 JGROUPS_CLUSTER_PASSWORD 环境变量配置身份验证。
2. 将集群中每个节点的 JGROUPS_ENCRYPT_PROTOCOL 环境变量设置为 ASYM_ENCRYPT。

1. 确认适用于 OpenShift 镜像的 Data Grid 是否可用。

   $ oc get images | grep jboss-datagrid73-openshift

   Copy to Clipboard Toggle word wrap

2. 如果镜像不可用，请创建一个镜像流并导入它。

   $ oc create -f https://raw.githubusercontent.com/jboss-container-images/jboss-datagrid-7-openshift-image/7.3-v1.9/templates/datagrid73-image-stream.json
   
   $ oc import-image jboss-datagrid73-openshift --from='registry.redhat.io/jboss-datagrid-7/datagrid73-openshift:1.9'

   Copy to Clipboard Toggle word wrap

1. 使用 Data Grid 为 OpenShift 镜像创建一个新的二进制构建。

   $ oc new-build jboss-datagrid73-openshift:1.9 --binary=true --name=custom-datagrid

   Copy to Clipboard Toggle word wrap

2. 导航到 s2i 目录，以便您可以传递 --from-dir="."。您必须包含 配置目录，以便 S2I 进程可以检测您的自定义配置。

   要使用配置示例，请执行以下操作：

   $ cd jboss-datagrid-7-openshift-image/docs/examples/s2i/

   Copy to Clipboard Toggle word wrap

3. 使用自定义配置为 OpenShift 镜像构建 Data Grid。

   $ oc start-build custom-datagrid --from-dir="." --follow
   
   Uploading directory "." as binary input for the build ...
   
   ...
   Push successful

   Copy to Clipboard Toggle word wrap

4. 检查您的镜像是否可用。

   $ oc get images | grep custom-datagrid

   Copy to Clipboard Toggle word wrap

1. 确认构建 Pod 正在运行。

   $ oc get pods
   
   NAME                      READY     STATUS      RESTARTS   AGE
   custom-datagrid-1-build   0/1       Completed   0          38s

   Copy to Clipboard Toggle word wrap

2. 使用您的自定义配置创建 Data Grid 应用程序。

   $ oc new-app custom-datagrid \
     -p APPLICATION_USER=${USERNAME} \
     -p APPLICATION_PASSWORD=${PASSWORD}

   Copy to Clipboard Toggle word wrap

3. 等待您的自定义数据网格应用程序开始运行。

   $ oc get pods -w
   
   NAME                      READY     STATUS         RESTARTS   AGE
   custom-datagrid-1-build   0/1       Completed      0          8m
   custom-datagrid-1-<id>   1/1       Running        0          11s

   Copy to Clipboard Toggle word wrap

4. 远程访问自定义 Data Grid pod 的 bash shell。

   $ oc exec -it ${pod-name} -- /bin/bash

   Copy to Clipboard Toggle word wrap

5. 查看 cluster-openshift.xml 以验证配置，例如：

   $ cat /opt/datagrid/configuration/clustered-openshift.xml

   Copy to Clipboard Toggle word wrap

   如果 clustered-openshift.xml 包含您的自定义配置，则 Data Grid pod 使用它。您可以使用 Data Grid 命令行界面验证您的配置，例如：

   $ /opt/datagrid/bin/cli.sh -c

   Copy to Clipboard Toggle word wrap

6. 验证配置后，结束远程会话。

   $ exit

   Copy to Clipboard Toggle word wrap

1. 等待您的自定义数据网格应用程序开始运行。

   $ oc get pods -w
   
   NAME                READY     STATUS    RESTARTS   AGE
   user-config-0   0/1       Running   7          17m

   Copy to Clipboard Toggle word wrap

2. 检查容器日志。

   $ oc logs ${pod-name} | grep standalone.xml
   
   INFO Running jboss-datagrid-7/datagrid73-openshift image, version 1.9 with user standalone.xml

   Copy to Clipboard Toggle word wrap

1. 指定镜像模板 JSON 中的 CUSTOM_INSTALL_DIRECTORIES 环境变量。此变量定义 S2I 工件所在的位置，如下例所示：

   {
       "name": "CUSTOM_INSTALL_DIRECTORIES",
       "value": "extensions/*"
   }

   Copy to Clipboard Toggle word wrap

2. 在该目录中创建一个 install.sh 脚本。此脚本为镜像中外部数据源安装模块和驱动程序。

   以下是 install.sh 脚本示例：

   #!/bin/bash
   
   # Import the common functions for
   # installing modules and configuring drivers
   source /usr/local/s2i/install-common.sh
   
   # Directory where this script is located
   injected_dir=$1
   
   # Install the modules for the datasource
   install_modules ${injected_dir}/modules
   
   # Configure the drivers for the datasource
   configure_drivers ${injected_dir}/drivers.properties

   Copy to Clipboard Toggle word wrap

3. 包括一个 模块 子目录，其中包含 module.xml 文件和数据源的驱动程序。生成的镜像使用模块来加载类并定义依赖项。

   例如，您计划将 Derby 用作外部数据源。您需要获取一个驱动，如 derby-10.12.1.1.jar，并将其放置在以下目录中： modules/org/apache/derby/main/

   在同一目录中，您还需要创建一个 module.xml 文件，该文件将驱动程序定义为资源并声明依赖项。

   以下是 module.xml 文件示例：

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.3" name="org.apache.derby">
    <resources>
      <resource-root path="derby-10.12.1.1.jar"/>
      <resource-root path="derbyclient-10.12.1.1.jar"/>
    </resources>
   
    <dependencies>
      <module name="javax.api"/>
      <module name="javax.transaction.api"/>
    </dependencies>
   </module>

   Copy to Clipboard Toggle word wrap

4. 在 driver .property 环境变量文件中定义驱动程序 配置属性。

   以下是 驱动程序.property 文件示例 ：

   #DRIVERS
   DRIVERS=DERBY
   
   DERBY_DRIVER_NAME=derby
   DERBY_DRIVER_MODULE=org.apache.derby
   DERBY_DRIVER_CLASS=org.apache.derby.jdbc.EmbeddedDriver
   DERBY_XA_DATASOURCE_CLASS=org.apache.derby.jdbc.EmbeddedXADataSource

   Copy to Clipboard Toggle word wrap

5. 在构建和部署镜像后，为数据源指定环境变量。

   以下示例显示了带有 DATASOURCES 环境变量的数据源定义：

   # Set a unique prefix for the datasource
   DATASOURCES=ACCOUNTS_DERBY
   # Specify other environment variables using the prefix
   ACCOUNTS_DERBY_DATABASE=accounts
   ACCOUNTS_DERBY_JNDI=java:/accounts-ds
   ACCOUNTS_DERBY_DRIVER=derby
   ACCOUNTS_DERBY_JTA=true
   ACCOUNTS_DERBY_NONXA=false
   ACCOUNTS_DERBY_USERNAME=${USERNAME}
   ACCOUNTS_DERBY_PASSWORD=${PASSWORD}
   ACCOUNTS_DERBY_XA_CONNECTION_PROPERTY_DatabaseName=/opt/eap/standalone/data/databases/derby/accounts
   # _HOST and _PORT are required but not used
   ACCOUNTS_ORACLE_HOST=dummy
   ACCOUNTS_ORACLE_PORT=1527

   Copy to Clipboard Toggle word wrap