Documentation
¶
Overview ¶
Package labels defines all label, annotation, and finalizer constants used by the Orkestra control plane. These identifiers form the contract between the runtime, admission webhooks, generators, CLI tooling, and developer-created workloads.
Nothing in this package performs logic — it only provides:
- stable label keys
- stable annotation keys
- stable finalizer keys
- helpers for constructing label sets
- selectors used by the admission webhooks
This package is intentionally dependency‑free and safe to import from any layer of the system (runtime, CLI, generators, komposers, motifs, etc.).
Index ¶
Constants ¶
const AnnotationManagedBy = "orkestra.orkspace.io/managed-by"
AnnotationManagedBy identifies which Orkestra operator instance manages a CR.
const AnnotationManagedSince = "orkestra.orkspace.io/managed-since"
AnnotationManagedSince records when Orkestra first took ownership of a CR.
const CreatedByOrkDoctor = "orkdoctor"
CreatedByOrkDoctor marks resources created by orkdoctor. These are excluded from cleanup logic even if ownership matches.
const DeletionProtectionLabel = "orkestra.io/deletion-protection"
DeletionProtectionLabel marks resources that must not be deleted. Any object carrying:
orkestra.io/deletion-protection=true
will be matched by the deletion‑protection admission webhook. This protects both Orkestra control‑plane resources and developer‑opt‑in resources.
const FinalizerOrkestra = "orkestra.orkspace.io/finalizer"
FinalizerOrkestra ensures cleanup runs before a CR is removed.
const LabelCreatedBy = "app.kubernetes.io/createdBy"
LabelCreatedBy identifies the creator of a resource.
const Managed = "orkestra.orkspace.io/managed"
Managed marks resources that Orkestra actively manages.
const ManagedValue = "true"
ManagedValue is always "true".
const OrkestraOwner = "orkestra-owner"
OrkestraOwner identifies which CR owns a generated resource. Used by reconcile loops to determine whether a resource should be updated or deleted.
Variables ¶
This section is empty.
Functions ¶
func DeletionProtectionSelector ¶ added in v0.4.1
func DeletionProtectionSelector() *metav1.LabelSelector
DeletionProtectionSelector returns a LabelSelector matching only the deletion‑protection label. Used when constructing webhook configurations.
func OrkestraBaseLabels ¶ added in v0.4.1
OrkestraBaseLabels returns a copy of the standard Orkestra control‑plane labels. Useful for generators and CLI commands that do not load Konfig.
func OrkestraResourceLabels ¶ added in v0.4.1
OrkestraResourceLabels returns the internal label map used for control‑plane resources. Callers must treat the returned map as read‑only.
func OrkestraResourceSelector ¶ added in v0.4.1
func OrkestraResourceSelector() *metav1.LabelSelector
OrkestraResourceSelector returns the selector for Orkestra control‑plane resources.
Types ¶
This section is empty.
Source Files