Helm Chart Values

Complete reference for Helm chart configuration values.

The Coraza Kubernetes Operator Helm chart is located at charts/coraza-kubernetes-operator/.

Values Reference

KeyTypeDefaultDescription
replicasint1Number of operator replicas. A PodDisruptionBudget with minAvailable: 1 is created automatically when greater than 1.
image.repositorystringghcr.io/networking-incubator/coraza-kubernetes-operatorContainer image repository.
image.tagstringlatestContainer image tag.
image.pullPolicystringIfNotPresentImage pull policy.
imagePullSecretslist[]Image pull secrets for private registries.
resources.requests.cpustring10mCPU request.
resources.requests.memorystring128MiMemory request.
resources.limits.cpustring500mCPU limit.
resources.limits.memorystring256MiMemory limit.
metrics.enabledbooltrueEnable the controller-runtime metrics endpoint (HTTPS on port 8443).
metrics.certSecretstring""Name of a Secret with TLS cert/key for metrics. When empty, a self-signed certificate is generated.
metrics.certNamestringtls.crtKey name of the certificate file inside certSecret.
metrics.keyNamestringtls.keyKey name of the private key file inside certSecret.
metrics.caNamestring""Key name of a CA certificate inside certSecret for ServiceMonitor TLS verification.
metrics.serviceMonitor.enabledboolfalseCreate a Prometheus ServiceMonitor resource.
logging.developmentboolfalseUse console encoder with debug level (development mode). When false, the production settings below apply.
logging.encoderstringjsonLog encoding format (json or console). Only used when development is false.
logging.levelstringinfoMinimum log level (debug, info, error). Only used when development is false.
logging.stacktraceLevelstringerrorMinimum level for stack traces (info, error, panic). Only used when development is false.
logging.timeEncodingstringrfc3339nanoTimestamp format (epoch, millis, nano, iso8601, rfc3339, rfc3339nano). Only used when development is false.
istio.revisionstring""Istio control plane revision label. When empty, no revision label is set on managed resources.
defaultWasmImagestring""Default WASM plugin OCI URL when an Engine omits spec.driver.wasm.image. When empty, uses the operator’s built-in default.
createNamespacebooltrueManage the release namespace with Pod Security Standard labels. Requires --create-namespace on first install.
openshift.enabledboolfalseOmit runAsUser, fsGroup, and fsGroupChangePolicy from the pod security context for OpenShift SCC compatibility.
podSecurityStandard.versionstringlatestKubernetes version for Pod Security Standard labels (latest or vX.YZ).
nodeSelectorobject{}Node selector constraints.
tolerationslist[]Tolerations.
affinityobject{}Affinity rules.
topologySpreadConstraintslist[]Topology spread constraints for pod scheduling.

Platform Requirements

PlatformMinimum Version
Kubernetesv1.32+
OpenShift Container Platformv4.20+

OpenShift Values Example

For OpenShift installations, use the following values overlay:

openshift:
  enabled: true

istio:
  revision: openshift-gateway

metrics:
  serviceMonitor:
    enabled: true

This overlay is also available at charts/coraza-kubernetes-operator/examples/openshift-values.yaml in the repository.