Using custom modules with spotfire-webplayer (or spotfire-automationservices)

To use custom modules with the spotfire-webplayer chart, you can supply a persistent volume claim to the Helm chart during installation. This will let the webplayer pod know where to find the modules. These modules are usually bundled as sdn or spk files and must be unpacked to a persistent volume before they can be used by the webplayer.

Creating custom webplayer images that include the custom modules is also possible, but this example does not cover that. Using a persistent volume has the advantage of not requiring you to build and push new custom images for each type of environment. This is because the custom modules are loaded in runtime when the pods are started, making it easier to manage and deploy the spotfire-webplayer chart by using an unmodified image.

Steps 1-5 below are only needed if you want to unpack the modules to a persistent volume using a Kubernetes job. If you already have the modules unpacked to a persistent volume, you can skip to step 6, as long as you have a persistent volume claim that points to the persistent volume. There are many ways to unpack the modules to a persistent volume, so this example only covers one way of doing it.

Put your spk or sdn files in the custom-modules/ directory.
Use the Dockerfile in this directory to build a docker image with your custom modules.
```
docker build -t webplayer-custom-modules .
```

Push the image to a Docker registry so it is available to your Kubernetes cluster.

CONTAINER_REGISTRY=your-docker-registry.example.com
docker tag webplayer-custom-modules:latest ${CONTAINER_REGISTRY}/webplayer-custom-modules
docker push ${CONTAINER_REGISTRY}/webplayer-custom-modules

Update the unpack-modules-to-pvc.yaml file with the correct storage class, docker image name, pvc name.
```
vim unpack-modules-to-pvc.yaml
```
Run the unpack-modules-to-pvc.yaml file to create a job that will unpack the modules to the persistent volume.
```
kubectl apply -f unpack-modules-to-pvc.yaml
kubectl logs job/populate-modules-job
```
To install spotfire-webplayer, use the volumes.customModules.existingClaim value and supply the pvc name.
```
helm install spotfire-webplayer spotfire/spotfire-webplayer --set volumes.customModules.existingClaim=custom-modules-pvc ...
```
Note: spotfire/spotfire-webplayer assumes the helm repo is named spotfire. If you have named it something else, you must use that name instead.