Skip to content
Manoj-ParamsettiPublic

About

A Kubernetes-native HTTP broadcaster that uses BroadCaster custom resources to authenticate requests and route them to selected, healthy pods.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Prism-Go

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.

Features

  • Broadcast any HTTP request to the cluster
  • Healthcheck endpoints
  • Whitelist paths with regular expressions
  • Whitelist HTTP methods
  • Structured logging
  • CRD support for configuration

Installation

Install Prism with the Helm chart. It installs the CRD, RBAC, Deployment, and Service.

Install with Helm

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-namespace

The 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=latest

Common 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.

Usage

prism-go

QA in Minikube

Run the reproducible build-and-cluster smoke test with:

./scripts/qa-minikube.sh

The 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.

Configuration

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

About

A Kubernetes-native HTTP broadcaster that uses BroadCaster custom resources to authenticate requests and route them to selected, healthy pods.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages