Chapter 20. Deploying custom code to Data Grid
Chapter 20. Deploying custom code to Data Grid Add custom code, such as scripts and event listeners, to your Data Grid clusters. Before you can deploy custom code to Data Grid clusters, you need to make it available. To do this you can copy artifacts from a persistent volume (PV), download artifacts from an HTTP or FTP server, or use both methods. 20.1. Copying code artifacts to Data Grid clusters Adding your artifacts to a persistent volume (PV) and then copy them to Data Grid pods. This procedure explains how to use a temporary pod that mounts a persistent volume claim (PVC) that: Lets you add code artifacts to the PV (perform a write operation). Allows Data Grid pods to load code artifacts from the PV (perform a read operation). To perform these read and write operations, you need certain PV access modes. However, support for different PVC access modes is platform dependent. It is beyond the scope of this document to provide instructions for creating PVCs with different platforms. For simplicity, the following procedure shows a PVC with the ReadWriteMany access mode. In some cases only the ReadOnlyMany or ReadWriteOnce access modes are available. You can use a combination of those access modes by reclaiming and reusing PVCs with the same spec.volumeName . Note Using ReadWriteOnce access mode results in all Data Grid pods in a cluster being scheduled on the same OpenShift node. Procedure Change to the namespace for your Data Grid cluster. Create a PVC for your custom code artifacts, for example: apiVersion: v1 kind: PersistentVolumeClaim metadata: name: datagrid-libs spec: accessModes: - ReadWriteMany resources: requests: storage: 100Mi Apply your PVC. Create a pod that mounts the PVC, for example: 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.5 volumeMounts: - mountPath: /tmp/libs name: lib-pv-storage Add the pod to the Data Grid namespace and wait for it to be ready. Copy your code artifacts to the pod so that they are loaded into the PVC. For example to copy code artifacts from a local libs directory, do the following: Delete the pod. Specify the persistent volume with spec.dependencies.volumeClaimName in your Infinispan CR and then apply the changes. apiVersion: infinispan.org/v1 kind: Infinispan metadata: name: infinispan spec: replicas: 2 dependencies: volumeClaimName: datagrid-libs service: type: DataGrid Note If you update your custom code on the persistent volume, you must restart the Data Grid cluster so it can load the changes. Additional resources Configuring persistent storage Persistent Volumes Access Modes How to manually reclaim and reuse OpenShift Persistent volumes that are "Released" (Red Hat Knowledgebase) 20.2. Downloading code artifacts Add your artifacts to an HTTP or FTP server so that Data Grid Operator downloads them to the {lib_path} directory on each Data Grid node. When downloading files, Data Grid Operator can automatically detect the file type. Data Grid Operator also extracts archived files, such as zip or tgz , to the filesystem after the download completes. You can also download Maven artifacts using the groupId:artifactId:version format, for example org.postgresql:postgresql:42.3.1 . Note Each time Data Grid Operator creates a Data Grid node it downloads the artifacts to the node. Prerequisites Host your code artifacts on an HTTP or FTP server or publish them to a maven repository. Procedure Add the spec.dependencies.artifacts field to your Infinispan CR. Do one of the following: Specify the location of the file to download via HTTP or FTP as the value of the spec.dependencies.artifacts.url field. Provide the Maven artifact to download with the groupId:artifactId:version format as the value of the spec.dependencies.artifacts.maven field. Optionally specify a checksum to verify the integrity of the download with the spec.dependencies.artifacts.hash field. The hash field requires a value is in the format of <algorithm>:<checksum> where <algorithm> is sha1|sha224|sha256|sha384|sha512|md5 . apiVersion: infinispan.org/v1 kind: Infinispan metadata: name: infinispan spec: replicas: 2 dependencies: artifacts: - url: http://example.com:8080/path hash: sha256:596408848b56b5a23096baa110cd8b633c9a9aef2edd6b38943ade5b4edcd686 service: type: DataGrid Apply the changes.
project rhdg-namespace apiVersion: v1 kind: PersistentVolumeClaim metadata: name: datagrid-libs spec: accessModes: - ReadWriteMany resources: requests: storage: 100Mi apply -f datagrid-libs.yaml 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.5 volumeMounts: - mountPath: /tmp/libs name: lib-pv-storage apply -f datagrid-libs-pod.yaml wait --for=condition=ready --timeout=2m pod/datagrid-libs-pod cp --no-preserve=true libs datagrid-libs-pod:/tmp/ delete pod datagrid-libs-pod apiVersion: infinispan.org/v1 kind: Infinispan metadata: name: infinispan spec: replicas: 2 dependencies: volumeClaimName: datagrid-libs service: type: DataGrid apiVersion: infinispan.org/v1 kind: Infinispan metadata: name: infinispan spec: replicas: 2 dependencies: artifacts: - url: http://example.com:8080/path hash: sha256:596408848b56b5a23096baa110cd8b633c9a9aef2edd6b38943ade5b4edcd686 service: type: DataGrid