Concepts

Key design decisions, personas, templating, and metadata reference for Capsule

Concept references explain reusable behavior shared across Capsule APIs:

  • Audiences: select request identities for namespace rules and replication admission triggers, including Capsule users, administrators, tenant owners, and the Capsule controller.
  • Parameter Schemas and Dynamic Forms: validate parameterized APIs with JSON Schema and Kubernetes CEL, and populate client forms from arbitrary Kubernetes resources.
  • Managed Resources and Server-Side Apply: understand field ownership, adoption, protection, cleanup policies, and processed-resource status.

Architecture

Architecture references and considerations

Audiences

Select request identities for namespace rules and replication admission triggers.

Parameter Schemas and Dynamic Forms

Validate parameterized APIs with JSON Schema and Kubernetes CEL, and enrich clients with live Kubernetes resource selectors.

Managed Resources and Server-Side Apply

Ownership, server-side apply, resource policies, and status for TenantResource and GlobalTenantResource replications.

Known Metadata

Labels and Annotations in Capsule Items

Templating

Templating in Capsule Items

Last modified November 11, 2026: feat: add fluxcd guide (8bef57b)