Prism-Go is a Kubernetes-native application that broadcasts HTTP requests to selected pods in the cluster. It is built with Go and deployed as a Kubernetes Deployment.
- Broadcast any HTTP request to the cluster
- Healthcheck endpoints
- Whitelist paths with regular expressions
- Whitelist HTTP methods
- Structured logging
- CRD support for configuration
Install Prism with the Helm chart. It installs the CRD, RBAC, Deployment, and Service.
The chart installs the BroadCaster CRD, Prism Deployment and Service, ServiceAccount, and cluster-wide RBAC. Choose Prism's installation namespace with Helm's standard --namespace option. Prism can manage BroadCaster resources and target Pods in other namespaces as well.
helm upgrade --install prism ./helm/prism \
--namespace prism \
--create-namespaceThe chart defaults to the multi-architecture Docker Hub image docker.io/manojparamsetti/prism-go:1.0.0. Override image.repository and image.tag to use a different image. For a local Minikube image, load it with minikube image load and set the chart to that image and tag:
minikube image load prism:latest
helm upgrade --install prism ./helm/prism \
--namespace prism \
--create-namespace \
--set image.repository=prism \
--set image.tag=latestCommon settings can be put in a values file and passed with -f values.yaml:
image:
repository: docker.io/manojparamsetti/prism-go
tag: "1.0.0"
prismDebug: false
tokenSecretSuffix: "-prism-token"
service:
type: ClusterIP
port: 8080
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 256Mi
extraEnv: []prismDebug controls PRISM_DEBUG; keep it false for in-cluster ServiceAccount authentication. tokenSecretSuffix sets PRISM_TOKEN_SECRET_SUFFIX and defaults to -prism-token. extraEnv, imagePullSecrets, service.type, service.nodePort, replicaCount, resources, nodeSelector, tolerations, and affinity are also configurable. See helm/prism/values.yaml for all chart values.
Helm installs CRDs from the chart's crds/ directory on initial install. Helm does not upgrade or delete CRDs; apply CRD schema changes separately with kubectl apply -f config/crds/broadcast-crd.yaml.
prism-goRun the reproducible build-and-cluster smoke test with:
./scripts/qa-minikube.shThe script builds and loads a unique local image, installs Prism into a temporary namespace, exercises authenticated requests and Pod selection, then removes its temporary resources. It updates the cluster-scoped CRD, so read the Minikube QA guide before running it against a cluster with existing BroadCaster resources.
Create a BroadCaster custom resource to define which Pods Prism can call and which requests it accepts. See the BroadCaster CRD authoring guide for the field reference, token setup, and a complete walkthrough.
apiVersion: prism.app/v1
kind: BroadCaster
metadata:
name: example
namespace: default
spec:
allowedPaths:
- /reflection
podSelectors:
- app=example
- secondLabel=secondValue
methods:
- GET
- POST
service:
port: 80
appProtocol: http
timeout: 30