Operator configuration
Every operator flag, its Helm value, and what happens when an optional integration is absent. Flags configure the operator once; per-app behavior lives in the WorkerApp resource.
Trust and scope
These flags decide which WorkerApps the operator accepts. A WorkerApp outside them
reports SpecValid: False and nothing is created for it.
| Flag | Helm value | Default | Purpose |
|---|---|---|---|
--allowed-image-prefixes | operator.allowedImagePrefixes | ghcr.io/denoland/celld: | Comma-separated prefixes a celld.image must start with. |
--allowed-iam-roles | operator.allowedIAMRoles | empty | Exact role ARNs allowed in credentialsFrom.iamRole. |
--allowed-azure-client-ids | operator.allowedAzureClientIDs | empty | Exact Azure workload identity client IDs allowed in credentialsFrom.azureClientID. |
--allowed-bucket-endpoints | operator.allowedBucketEndpoints | empty | Exact HTTPS endpoints allowed in bucket.endpoint; empty permits AWS S3 only. |
--watch-namespace | operator.watchNamespace | empty (cluster-wide) | Restrict reconciliation, the cache, and the chart's workload Role to one namespace. |
Ingress and routing
| Flag | Helm value | Default | Purpose |
|---|---|---|---|
--ingress-mode | operator.ingressMode | httproute | httproute (Gateway API), virtualservice (classic Istio), ingress (networking.k8s.io/v1), or none. See ingress modes. |
--gateway-name | operator.gatewayName | edge | Shared Gateway that HTTPRoutes attach to. |
--gateway-namespace | operator.gatewayNamespace | infra | Namespace of that Gateway. |
--httproute-retries | operator.httpRouteRetries | false | Add a retry on 503 to HTTPRoutes. Requires experimental-channel Gateway API CRDs and a gateway that implements it. |
--istio-gateways | operator.istioGateways | unset | Pre-existing networking.istio.io Gateways (namespace/name, comma-separated) for virtualservice mode. |
--ingress-class | operator.ingressClass | cluster default | IngressClass for ingress mode. |
--cluster-issuer | operator.clusterIssuer | unset | cert-manager ClusterIssuer for ingress mode; each app's Ingress then requests its own TLS certificate. |
Fleet access and polling
| Flag | Helm value | Default | Purpose |
|---|---|---|---|
--operator-namespace | release namespace | celld-operator-system | Namespace whose manager pods fleet NetworkPolicies admit to :8081. |
--operator-principal | operator.operatorPrincipal | derived | Operator identity in Istio AuthorizationPolicies; empty derives cluster.local/ns/<release ns>/sa/<service account>. Set it when your trust domain is not cluster.local. |
--state-poll-interval | operator.statePollInterval | 15s | /state polling cadence for metrics export. Keep it well below 60s, the freshness limit on scaling queries. |
--deploy-poll-interval | operator.deployPollInterval | 60s | Bucket deploy/current.json cadence for appVersion: auto and drift checks. |
--prometheus-url | operator.prometheusURL | http://prometheus-operated.monitoring.svc:9090 | Where KEDA queries the operator's celld_* metrics. |
The operator exits at startup on an unknown ingress mode or a non-positive poll interval.
Other chart values
| Value | Default | Purpose |
|---|---|---|
controllerManager.replicas | 1 | Manager replicas; leader election is on (--leader-elect), and only the leader polls fleets. |
controllerManager.container.image.repository | ghcr.io/ezgamehost/celld-operator | Operator image. |
controllerManager.container.image.tag | "" | Empty uses the chart's appVersion, the operator build the chart was released with. |
controllerManager.container.resources | 10m / 128Mi requests, 500m / 512Mi limits | A starting point, not a capacity guarantee: size it with a load test for your fleet count. |
metrics.enable / metrics.port / metrics.insecure | true / 8443 / false | The manager's metrics endpoint. Secure mode serves HTTPS with authn/authz; insecure mode serves HTTP. |
prometheus.enable | false | Create a ServiceMonitor (with honorLabels, so the namespace/pod labels survive). |
certmanager.enable | false | cert-manager certificates for the metrics endpoint, with CA-verified scraping. Do not combine with insecure metrics. |
networkPolicy.enable | false | A NetworkPolicy that admits metrics scrapes only from namespaces labelled metrics: enabled. |
crd.enable / crd.keep | true / true | Include the CRD, and keep it on uninstall. |
rbac.enable | true | Include RBAC objects. |
The manager runs non-root with a restricted security context and exposes its own health
probes on :8081 (not celld's). Keep the control-plane: controller-manager and
app.kubernetes.io/name: celld-operator labels on manager pods: fleet
NetworkPolicies select them.
Graceful degradation
The operator requires none of its optional integrations to start reconciling. Absence is reported per WorkerApp, not failed on:
| Missing | Effect | Condition |
|---|---|---|
| Gateway API CRDs (httproute mode) | Hostnames are not routed; the fleet still serves in-cluster | IngressReady: False |
| Istio CRDs | NetworkPolicy alone guards :8081; no mesh mTLS | MeshPolicyReady: False |
| KEDA (autoscaled apps only) | spec.autoscaling has no effect | AutoscalingReady: False |
| Prometheus | KEDA scalers error; no replica changes are made on missing data | none: alert on KEDA |
Store qualification tooling
The repository ships hack/cas-hammer, the concurrency probe for
qualifying object stores:
$ go run ./hack/cas-hammer --bucket <bucket> --endpoint <url> --writers 8 --rounds 32
Development
$ make test # envtest suite + unit tests
$ make lint # golangci-lint
$ make run # run against the current kubeconfig
Contributions are welcome; see CONTRIBUTING.md.