The complete celld-operator.io/v1alpha1WorkerApp API: every spec
field with its default and validation, and the full status surface. One WorkerApp is one
celld fleet serving one application, so the resource, the fleet, and the app are 1:1:1.
Validation happens twice: the CRD's schema and CEL rules reject bad objects at
admission, and the operator re-validates every object (including ones admitted by older
CRDs) against its allowlists before creating anything. A failure sets
SpecValid: False and phase Degraded. The resource name must be a
DNS label of at most 48 characters.
The expected deployment: the Version ID celld deploy printed. celld adopts the bucket pointer on its own; status verifies that every pod serves this. The sentinel auto follows the bucket's deploy/current.json and requires an s3:// bucket and deployTrackingSecretRef. See Deploying updates.
deploymentPolicy
Restart | InPlace
Restart
Whether an appVersion change also runs a gated restart (Restart) or relies on celld's in-place adoption alone (InPlace).
deployTrackingSecretRef
string
unset
A Secret with a read-only S3 credential (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, optional AWS_SESSION_TOKEN) for reading deploy/current.json. Required for auto; in pinned mode it enables the VersionMismatch drift check.
hostnames
[]string (set)
unset
Hostnames routed to this app. One route object carrying every hostname is reconciled in the app's namespace; its kind depends on the operator's ingress mode. Omit for internal-only apps.
replicas
int32 ≥ 1
3
Fleet size when autoscaling is disabled; the initial size otherwise.
durability
bucket | fleet
bucket
How celld proves a write before acknowledging it (CELLD_DURABILITY). bucket: the write is in the bucket. fleet: follower nodes fsync it and the upload follows; requires storage, replicas ≥ 3, and autoscaling.minReplicas ≥ 3 when autoscaling. Changing it rolls the fleet.
websockets
bool
false
Selects the WebSocket profile: long edge timeouts where the ingress mode can express them, and a 30-minute scale-down window. No session affinity.
trustForwardedHeaders
bool
false
Lets X-Forwarded-Host/-Proto set request.url (CELLD_TRUST_FORWARDED_HEADERS=1). Only when every hop in front of the fleet replaces both headers.
clusterDomain
DNS name
cluster.local
The cluster's DNS suffix, used in peer advertise addresses and VirtualService hosts.
The celld image, e.g. ghcr.io/denoland/celld:v0.6.2. The tag must carry a numeric major.minor.patch version (also when digest-pinned), and the image must match the operator's allowedImagePrefixes.
celld.updateStrategy
Rolling | Recreate
Rolling
Rolling is partition-stepped and restoring-gated, and is refused across a non-rolling boundary. Recreate scales to zero first, an availability event by design. Downgrades from v0.3+ to older runtimes are refused either way.
Bucket identity (name, endpoint, storageAccount) is immutable; migrate to a new WorkerApp to change it.
Field
Type
Default
Description
bucket.name
string, required
none
Bucket and prefix: s3://, gs://, or az:// (the container), e.g. s3://platform-cells/apps/chat. At most 1024 characters. The store must satisfy the storage contract.
bucket.endpoint
string
unset
S3-compatible endpoint when not AWS S3 (e.g. an R2 account endpoint). s3:// only; must be HTTPS and on the operator's allowedBucketEndpoints.
bucket.region
string
unset
Storage region when it cannot be inferred (auto for R2).
bucket.storageAccount
string, 3–24 lowercase alphanumerics
unset
The Azure storage account (AZURE_STORAGE_ACCOUNT_NAME). Required for az://.
bucket.credentialsFrom.iamRole
string
unset
An IAM role ARN, rendered as the EKS IRSA annotation on the fleet ServiceAccount; must be on allowedIAMRoles. The literal auto (operator-provisioned role) is not implemented and reports BucketCredentialsReady: False. Leave credentialsFrom empty for EKS Pod Identity.
bucket.credentialsFrom.azureClientID
string
unset
A Microsoft Entra workload identity client ID for az:// (AKS workload identity); must be on allowedAzureClientIDs.
bucket.credentialsFrom.secretRef
string
unset
A Secret injected as environment: AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY for s3://, AZURE_STORAGE_ACCOUNT_KEY for az://. Rotation rolls the fleet.
At most one of iamRole, azureClientID, and secretRef may be set.
Provisions a retained PersistentVolumeClaim per ordinal for /var/lib/celld. Without storage, local state is an emptyDir. Claims survive scale-down and WorkerApp deletion. The whole storage block is immutable.
storage.storageClassName
string
cluster default
The claim's StorageClass. Node-local storage does not survive permanent node loss.
scheduling.nodeSelector
map
unset
Pod node selector, e.g. to pin fleets to a dedicated node pool.
scheduling.tolerations
[]Toleration
unset
Pod tolerations.
scheduling.spreadAcrossZones
bool
false
With storage, also require one pod per zone (pods with storage always require distinct hosts). Provision enough zones for maxReplicas.
Type of the serving Service fronting the Worker listener. ClusterIP suits ingress backends and in-cluster consumers (<app>-celld.<ns>.svc:8080).
service.annotations
map
unset
Merged onto the serving Service (internal-LB flags, health-check tuning); removed again when deleted from the spec.
vars.secretRef
string
unset
celld before v0.5 only. A Secret whose vars.env key (NAME=value lines) is mounted and passed via CELLD_VARS_FILE. Rejected for v0.5+ images: use the deployment's Wrangler vars.
Creating or converging: pods not all ready, the fleet state incomplete, restoring above zero, or some pod not yet serving the expected deployment.
Ready
Every pod is ready and updated, the fleet reports restoring=0, and every pod serves the expected deployment with nothing draining or swapping.
RollingOut
The gated rollout is stepping through ordinals, or waiting for KEDA to pause.
Recreating
A Recreate change is in progress: scale to zero, wait for every old pod to disappear, start the new fleet.
Degraded
A refusal: the spec failed validation (SpecValid: False), or a celld change is not rolling-safe, is an unsupported downgrade, or names an unparseable image. The message names it. Rollouts have no timeout, so a stuck gate stays in RollingOut.
InvalidConfiguration: schema, CEL, or allowlist validation failed; nothing is created or changed until it is fixed.
Available / Progressing / Degraded
Phase reflection; Progressing and Degraded carry waitingOn as their message.
FleetStateReady
Unavailable: the operator could not get a complete /state sweep (a pod missing, unready, or unreachable).
BucketCredentialsReady
ProvisioningNotImplemented: iamRole: auto is not implemented; annotate the fleet ServiceAccount yourself.
DeployTrackingReady
Present only with tracking. BucketUnreachable (holding the last known version), UnsupportedStore (auto on gs:///az://), or VersionMismatch (pinned mode: the bucket pointer and spec.appVersion disagree).
IngressReady
Present only with hostnames. Unknown for Ingress and VirtualService; False for missing CRDs, route errors, or dropped retries. See Networking.
A production-shaped fleet with fleet durability, persistent storage, bucket tracking,
and autoscaling. The IAM role and endpoint must be on the operator's allowlists.
apiVersion:celld-operator.io/v1alpha1kind:WorkerAppmetadata:name:chatnamespace:tenant-acmespec:hostnames:["chat.acme.example.com"]appVersion:autodeployTrackingSecretRef:chat-deploy-readerdeploymentPolicy:InPlacecelld:image:ghcr.io/denoland/celld:v0.6.2updateStrategy:Rollingreplicas:3bucket:name:s3://platform-cells/apps/chatendpoint:https://ACCOUNT.r2.cloudflarestorage.comregion:autocredentialsFrom:iamRole:arn:aws:iam::123456789012:role/celld-chatresources:memoryGi:8maxResidentCells:1000cpuMillis:2000durability:fleetstorage:sizeGi:100storageClassName:your-durable-class# pods now require distinct hostsservice:type:ClusterIPwebsockets:trueautoscaling:enabled:trueminReplicas:3maxReplicas:10targets:residentCellUtilization:70p95LatencyMs:250telemetry:enabled:trueretention:30d