CelldPreview API reference

A CelldPreview owns an isolated fleet and unique URL with a bounded lifetime. See application previews for DNS, TLS, deployment and cleanup requirements.

Field names, defaults, and validation rules come from the CRD. Required fields are marked below; optional fields can be omitted unless a validation rule requires them for your profile.

API group	celld.eric.dev
Version	v1alpha1
Kind	CelldPreview
Scope	Namespaced
Subresources	status

CelldPreview provisions an isolated application fleet with a bounded lifetime. Application code is uploaded separately to its isolated prefix in the pool bucket.

Printer columns

Column	JSON path	Type
Fleet	.status.fleetName	string
Phase	.status.phase	string
URL	.status.url	string
Expires	.status.expiresAt	date

spec

Field	Type	Required	Description
fleetRef	object	yes	Parent fleet with spec.previews configured in this namespace; immutable.
revision	string		Optional informational revision supplied by CI, not deployment verification. Length 0–256.
seed	object		Optional one-time multi-object initialization; omission starts empty.
source	string	yes	Human-readable branch or pull request identifier. Never used as a resource name. Length 1–256.
ttlSeconds	int32		Lifetime from creation; immutable. Expiry initiates safe fleet deletion. Default 86400. Range 60–604800.

Validation rules and expressions

• preview seed selection is fixed at creation

  has(self.seed) == has(oldSelf.seed) && (!has(self.seed) || self.seed == oldSelf.seed)

spec.fleetRef

Parent fleet with spec.previews configured in this namespace; immutable.

Field	Type	Required	Description
name	string	yes	Pool in the same namespace as the preview. Length 1–253. Pattern ^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$.

Validation rules and expressions

• preview fleet reference is immutable

  self == oldSelf

spec.seed

Optional one-time multi-object initialization; omission starts empty.

Field	Type	Required	Description
alarms	string		Clear disables copied alarms. Preserve explicitly opts into scheduled work. One of Clear, Preserve. Default "Clear".
objects	[]object	yes	Items 1–100.
source	string	yes	Administrator-approved alias from the pool’s seeding.sources. Length 1–63. Pattern ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$.

spec.seed.objects[]

Field	Type	Required	Description
class	string	yes	Exported Durable Object class, with the same mapping in the target application. Length 1–128. Pattern ^[A-Za-z0-9_$.-]+$.
id	string	yes	Canonical object ID, not an idFromName input or a storage path. Length 1–256. Pattern ^[A-Za-z0-9_$.-]+$.

status

Field	Type	Required	Description
conditions	[]object
endpoint	string		Internal HTTP endpoint; Ready confirms infrastructure, not application deployment.
expiresAt	string		Format date-time.
fleetName	string
observedGeneration	int64
parentFleetName	string
parentFleetUID	string
phase	string		One of Pending, Initializing, Ready, Blocked, Deleting, Expired.
seedPhase	string		One of Pending, Running, Succeeded, Failed, Canceled.
seedReservation	string		Destination reservation retaining initialization state after preview deletion.
storageURL	string		Target for celld deploy; contains no credentials.
url	string		Unique URL; configure wildcard DNS and TLS on the selected edge controller.

status.conditions[]

Condition contains details for one aspect of the current state of this API Resource.

Field	Type	Required	Description
lastTransitionTime	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format date-time.
message	string	yes	message is a human readable message indicating details about the transition. This may be an empty string. Length 0–32768.
observedGeneration	int64		observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. Range 0–.
reason	string	yes	reason contains a programmatic identifier indicating the reason for the condition’s last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty. Length 1–1024. Pattern ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$.
status	string	yes	status of the condition, one of True, False, Unknown. One of True, False, Unknown.
type	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase. Length 0–316. Pattern ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$.